Compartilhar via


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

Consulte também

Referência

Classe de CStringT