CStringT::Insert
Insere um único caractere ou uma subcadeia de caracteres no índice especificado dentro da cadeia de caracteres.
int Insert(
int iIndex,
PCXSTR psz
);
int Insert(
int iIndex,
XCHAR ch
);
Parâmetros
iIndex
O índice de caractere antes de que a inserção ocorrerá.psz
Um ponteiro para a subcadeia de caracteres a ser inserido.ch
o caractere a ser inserido.
Valor de retorno
O comprimento da cadeia de caracteres modificada.
Comentários
O parâmetro de iIndex identifica o primeiro caractere que será movida para fazer espaço para o caractere ou a subcadeia de caracteres. Se nIndex é zero, inserção ocorrerão antes de cadeia de caracteres inteira. Se nIndex é maior do que o comprimento da cadeia de caracteres, a função concatenará a cadeia de caracteres atual e o novo material fornecidos por ch ou por psz.
Exemplo
// 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
Cabeçalho: cstringt.h