Partilhar via


CStringT::Insert

Insere um único caractere ou uma subseqüência de determinado índice dentro da seqüência de caracteres.

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

Parâmetros

  • iIndex
    O índice do caractere antes do qual será realizada a inserção.

  • psz
    Um ponteiro para a subseqüência de caracteres a ser inserido.

  • ch
    O caractere a ser inserido.

Valor de retorno

O comprimento da seqüência de caracteres alterado.

Comentários

The iIndex parâmetro identifica o primeiro caractere será movido para liberar espaço para o caractere ou uma subseqüência de caracteres. If nIndex é zero, a inserção ocorrerá antes da seqüência inteira. If nIndex é maior que o comprimento da seqüência de caracteres, a função irá concatenar a seqüência de caracteres presente e o novo material fornecido pela tanto ch ou 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 CStringT

Outros recursos

CStringT membros