Share via


CStringT::Insert

Insère un caractère unique ou une sous-chaîne à l'index donné dans la chaîne.

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

Paramètres

  • iIndex
    Index du caractère avant lequel l'implémentation aura lieu.

  • psz
    Un pointeur vers la sous-chaîne à insérer.

  • ch
    Le caractère à insérer.

Valeur de retour

La longueur de la chaîne modifiée.

Notes

Le paramètre d' iIndex identifie le premier caractère qui sera déplacé pour faire de la place pour le caractère ou la sous-chaîne.Si nIndex est zéro, l'implémentation se produit avant la chaîne entière.Si nIndex est supérieure à la longueur de la chaîne, la fonction concatènera la chaîne actuelle et le nouveau matériel fournis par ch ou psz.

Exemple

// 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);

Configuration requise

Header: cstringt.h

Voir aussi

Référence

Classe de CStringT