Share via


CStringT::Insert

Inserta un carácter o una subcadena en el índice especificado en la cadena.

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

Parámetros

  • iIndex
    El índice del carácter antes de que la inserción se realizarán.

  • psz
    Un puntero a la subcadena que se va a insertar.

  • ch
    El carácter que se va a insertar.

Valor devuelto

La longitud de la cadena modificada.

Comentarios

El parámetro de iIndex identifica el primer carácter que se mueve para hacer sitio para el carácter o subcadena. si nIndex es cero, la inserción aparecerá antes de la cadena completa. Si nIndex es mayor que la longitud de cadena, la función concatenará la cadena actual y el nuevo material proporcionados por ch o psz.

Ejemplo

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

Requisitos

encabezado: cstringt.h

Vea también

Referencia

CStringT Class