Freigeben über


CStringT::Insert

Fügt ein einzelnes Zeichen oder eine Teilzeichenfolge am angegebenen Index in der Zeichenfolge ein.

int Insert(
   int iIndex,
   PCXSTR psz
);
int Insert(
   int iIndex,
   XCHAR ch
);

Parameter

  • iIndex
    Der Index des Zeichens, vor dem die Einfügung stattfindet.

  • psz
    Ein Zeiger auf die einzufügende Teilzeichenfolge.

  • ch
    Das einzufügende Zeichen.

Rückgabewert

Die Länge der geänderten Zeichenfolge.

Hinweise

Der iIndex-Parameter identifiziert das erste Zeichen, das bewegt wird, um das Zeichen oder für die Teilzeichenfolge Platz zu schaffen. Wenn nIndex null ist, tritt die Einfügung vor der gesamten Zeichenfolge auf. Wenn nIndex höher als die Länge der Zeichenfolge, verkettet die Funktion die vorhandene Zeichenfolge und das neue Material, die entweder von ch oder von psz bereitgestellt werden.

Beispiel

// typedef CStringT<TCHAR, StrTraitATL<TCHAR, ChTraitsCRT<TCHAR>>> CAtlString;

CAtlString str(_T("SoccerBest"));
int n = str.Insert(6, _T("is "));
ASSERT(n == str.GetLength());
_tprintf_s(_T("1: %s\n"), (LPCTSTR) str);

n = str.Insert(6, _T(' '));
ASSERT(n == str.GetLength());
_tprintf_s(_T("2: %s\n"), (LPCTSTR) str);

n = str.Insert(55, _T('!'));
ASSERT(n == str.GetLength());
_tprintf_s(_T("3: %s\n"), (LPCTSTR) str);

Anforderungen

Header: cstringt.h

Siehe auch

Referenz

CStringT Class