Share via


CStringT::SpanIncluding

extrae los caracteres de la cadena, empezando por el primer carácter, que están en el conjunto de caracteres identificados por pszCharSet.

CStringT SpanIncluding(
   PCXSTR pszCharSet
) const;

Parámetros

  • pszCharSet
    Una cadena interpreta como conjunto de caracteres.

Valor devuelto

Una subcadena que contiene los caracteres de la cadena que están en pszCharSet, empezando por el primer carácter de la cadena y termina cuando un carácter se encuentra en la cadena que no está en pszCharSet.SpanIncluding devuelve una subcadena vacía si el primer carácter de la cadena no está en el conjunto especificado.

Comentarios

si el primer carácter de la cadena no está en el juego de caracteres, después SpanIncluding devuelve una cadena vacía. De lo contrario, devuelve una secuencia de caracteres consecutivos que están en el conjunto.

Ejemplo

// 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

encabezado: cstringt.h

Vea también

Referencia

CStringT Class