Partilhar via


CStringT::substituir

Substitui um caractere ou uma subseqüência de caracteres por outra.

int Replace(
   PCXSTR pszOld,
   PCXSTR pszNew
);
int Replace(
   XCHAR chOld,
   XCHAR chNew
);

Parâmetros

  • pszOld
    Um ponteiro para uma seqüência de caracteres contendo o caractere a ser substituído por pszNew.

  • pszNew
    Um ponteiro para uma seqüência de caracteres contendo o caractere de substituição pszOld.

  • chOld
    O caractere a ser substituído por chNew.

  • chNew
    O caractere de substituição chOld.

Valor de retorno

O número de instâncias substituídos do caractere ou subseqüência.Zero se a seqüência de caracteres não é alterada.

Comentários

Esta função substitui instâncias da subseqüência de caracteres ou caractere especificado por instâncias da subseqüência de caracteres ou caractere de nova.

A seqüência de caracteres pode ampliadas ou reduzidas sistema autônomo um resultado de substituição; ou seja, pszNew e pszOld não precisa ser igual em comprimento. A função executa um valor correspondente sensível a diferenciar diferenciar maiúsculas de minúsculas.

Exemplo

// typedef CStringT<TCHAR, StrTraitATL<TCHAR, ChTraitsCRT<TCHAR>>> CAtlString;

CAtlString strBang(_T("Everybody likes epee fencing"));
int n = strBang.Replace(_T("epee"), _T("foil"));
ASSERT(n == 1);   

Requisitos

Cabeçalho: cstringt.h

Consulte também

Referência

Classe CStringT

Outros recursos

CStringT membros