Partilhar via


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

Consulte também

Referência

Classe de CStringT