strspn, wcsspn, _mbsspn, _mbsspn_l

Artigo
08/25/2010

Retorna o índice do primeiro caractere em uma seqüência que não pertence a um conjunto de caracteres.

size_t strspn(
   const char *str,
   const char *strCharSet 
);
size_t wcsspn(
   const wchar_t *str,
   const wchar_t *strCharSet 
);
size_t _mbsspn(
   const unsigned char *str,
   const unsigned char *strCharSet 
);
size_t _mbsspn_l(
   const unsigned char *str,
   const unsigned char *strCharSet,
   _locale_t locale
);

Parâmetros

str
Seqüência terminada por caractere nulo para pesquisar.
strCharSet
Conjunto de caracteres terminada com caractere nulo.
locale
Localidade usar.

Valor de retorno

Retorna um valor inteiro especificando o comprimento da subseqüência em str que consistam inteiramente em caracteres em strCharSet*.* If str começa com um caractere não no strCharSet*,* a função retornará 0.

Comentários

The strspn função retorna o índice do primeiro caractere str que não pertence ao conjunto de caracteres strCharSet. A Pesquisar não inclui caracteres nulo de terminação.

wcsspn e _mbsspn são caractere largos e caractere de multibyte versões do strspn**.** Os argumentos de wcsspn são caractere largos strings; as de _mbsspn são seqüências de caractere de multibyte. _mbsspn valida os parâmetros. If str or strCharSet isNULL, the invalid parameter handler is invoked, as described in Validação de parâmetro .Se a execução for permitida para continuar, _mbspn Define errno para EINVAL e retorna 0. strspn e wcsspn não validam seus parâmetros. Especifique estas três funções identicamente outro comportam.

O valor de saída é afetado pela configuração do LC_CTYPE categoria de configuração da localidade; consulte setlocale para obter mais informações.As versões dessas funções sem o _l sufixo use a localidade corrente para esse comportamento dependente de localidade; as versões com o _l sufixo são idênticas exceto que usarem o parâmetro de localidade passado em vez disso. Para obter mais informações, consulte Localidade.

Mapeamentos de rotina de texto genérica

Rotina TCHAR.H	_UNICODE & _MBCS não definido	_MBCS definido	_UNICODE definido
_tcsspn	strspn	_mbsspn	wcsspn
n/d	n/d	_mbsspn_l	n/d

Requisitos

Rotina	Cabeçalho necessário
strspn	<string.h>
wcsspn	<string.h> ou <wchar.h>
_mbsspn, _mbsspn_l	<mbstring.h>

Para obter informações adicionais compatibilidade, consulte Compatibilidade na introdução.

Exemplo

// crt_strspn.c
// This program uses strspn to determine
// the length of the segment in the string "cabbage"
// consisting of a's, b's, and c's. In other words,
// it finds the first non-abc letter.
//

#include <string.h>
#include <stdio.h>

int main( void )
{
   char string[] = "cabbage";
   int  result;
   result = strspn( string, "abc" );
   printf( "The portion of '%s' containing only a, b, or c "
           "is %d bytes long\n", string, result );
}

The portion of 'cabbage' containing only a, b, or c is 5 bytes long