Compartilhar via


Método CHString::SpanIncluding (chstring.h)

[A classe CHString faz parte do WMI Provider Framework que agora é considerado em estado final e nenhum desenvolvimento, melhoria ou atualização adicional estará disponível para problemas não relacionados à segurança que afetarem essas bibliotecas. As APIs de MI devem ser usadas em todos os novos desenvolvimentos.]

O método SpanIncluding extrai caracteres de uma cadeia de caracteres identificada por lpszCharSet.

Sintaxe

CHString  throw(CHeap_Exception) SpanIncluding(
  LPCWSTR lpszCharSet
);

Parâmetros

lpszCharSet

Uma cadeia de caracteres interpretada como um conjunto de caracteres.

Valor retornado

O método SpanIncluding retorna uma subcadeia de caracteres que contém caracteres na cadeia de caracteres que estão em lpszCharSet.

Se o primeiro caractere na cadeia de caracteres não estiver no conjunto especificado, o método retornará uma subcadeia de caracteres vazia.

Comentários

O método SpanIncluding começa com o primeiro caractere da cadeia de caracteres e é interrompido quando um caractere é encontrado na cadeia de caracteres, mas não em lpszCharSet.

Exemplos

O exemplo de código a seguir mostra o uso de CHString::SpanIncluding.

CHString str( L"cabbage" );
CHString res = str.SpanIncluding( L"abc" );

assert( res == L"cabba" );
res = str.SpanIncluding( L"xyz" );
assert( res.IsEmpty( ) );

Requisitos

   
Cliente mínimo com suporte Windows Vista
Servidor mínimo com suporte Windows Server 2008
Plataforma de Destino Windows
Cabeçalho chstring.h (inclua FwCommon.h)
Biblioteca FrameDyn.lib
DLL FrameDynOS.dll; FrameDyn.dll

Confira também

CHString

CHString::IsEmpty

CHString::SpanExcluding