CStringT::Replace
Há duas versões de Replace. A primeira versão substitui uma ou mais cópias de uma subcadeia de caracteres usando outra subcadeia de caracteres. Ambas as subcadeias de caracteres NULL-são finalizadas. A segunda versão substitui uma ou mais cópias de um caractere usando outro caractere. Ambas as versões operam nos dados de caractere armazenados em CStringT.
int Replace(
PCXSTR pszOld,
PCXSTR pszNew
);
int Replace(
XCHAR chOld,
XCHAR chNew
);
Parâmetros
pszOld
Um ponteiro para uma cadeia de caracteres NULL- finalizada a ser substituída por pszNew.pszNew
Um ponteiro para uma cadeia de caracteres NULL- finalizada que substitui pszOld.chOld
o caractere a ser substituído por chNew.chNew
o caractere que substitui chOld.
Valor de retorno
Retorna o número de instâncias substituídas de caracteres ou da subcadeia de caracteres, ou zero se a cadeia de caracteres não é alterada.
Comentários
Replace pode alterar o tamanho da cadeia de caracteres como pszNew e pszOld não precisam estar o mesmo tamanho, e várias cópias da subcadeia de caracteres antigo podem ser alteradas para o novo. A função executa uma correspondência diferencia maiúsculas de minúsculas.
Exemplos de instâncias de CStringT são CString, CStringA, e CStringW.
Para CStringA, Replace funciona com ANSI ou caracteres de multibyte (MBCS). Para CStringW, Replace funciona com caracteres largos.
Para CString, o tipo de dados de caractere é selecionado em tempo de compilação, com base em se as constantes na tabela são definidas.
Constante definida |
Tipo de dados de caractere |
|---|---|
_UNICODE |
Caracteres largos |
_MBCS |
Vários caracteres de byte |
Nenhum |
Caracteres de byte único |
Ambos |
Undefined |
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