CStringT::SpanIncluding
Extrai os caracteres de uma cadeia de caracteres, começando com o primeiro caractere, que estão no conjunto de caracteres identificados por pszCharSet.
CStringT SpanIncluding(
PCXSTR pszCharSet
) const;
Parâmetros
- pszCharSet
Uma cadeia de caracteres interpretada como um conjunto de caracteres.
Valor de retorno
Uma subcadeia de caracteres que contém os caracteres na cadeia de caracteres que estão em pszCharSet, começando com o primeiro caractere na cadeia de caracteres e terminando quando um caractere é encontrado na cadeia de caracteres que não está em pszCharSet.SpanIncluding retorna uma subcadeia de caracteres vazia se o primeiro caractere na cadeia de caracteres não estiver no conjunto especificado.
Comentários
Se o primeiro caractere da cadeia de caracteres não estiver no conjunto de caracteres, então SpanIncluding retorna uma cadeia de caracteres vazia.Caso contrário, retornará uma sequência de caracteres consecutivos que estão no dataset.
Exemplo
// typedef CStringT<TCHAR, StrTraitATL<TCHAR, ChTraitsCRT<TCHAR>>> CAtlString;
CAtlString str(_T("cabbage"));
CAtlString res = str.SpanIncluding(_T("abc"));
ASSERT(res == _T("cabba"));
res = str.SpanIncluding(_T("xyz"));
ASSERT(res.IsEmpty());
Requisitos
Cabeçalho: cstringt.h