strspn, wcsspn, _mbsspn, _mbsspn_l

Artigo
03/12/2013

Retorna o índice do primeiro caractere em uma cadeia de caracteres que não pertence a um conjunto de caracteres.

Importante
_mbsspn e _mbsspn_l não podem ser usados em aplicativos executados em Tempo de Execução do Windows.Para obter mais informações, consulte Funções de CRT não suportadas com /ZW.

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
Cadeia de caracteres NULL- finalizada a pesquisa.
strCharSet
Conjunto de caracteres NULL- encerrado.
locale
A localidade usar.

Valor de retorno

Retorna um valor inteiro que especifica o comprimento da subcadeia de caracteres em str consistindo inteiramente nos caracteres em strCharSet*.* Se str começa com um caractere não em strCharSet*,* retorna 0 da função.

Comentários

A função de strspn retorna o índice do primeiro caractere em str que não pertence ao conjunto de caracteres em strCharSet.A pesquisa termine não inclui caracteres nulos.

wcsspn e _mbsspn são versões de largo- caractere e o caractere multibyte- de strspn**.** Os argumentos de wcsspn são cadeias de caracteres de largo- caractere; essas de _mbsspn são cadeias de caracteres de multibyte- caractere._mbsspn valida os seus parâmetros.Se str ou strCharSet sãoNULL, o manipulador inválido do parâmetro é invocado, como descrito em Validação de parâmetro .Se a execução é permitida continuar, _mbspn define errno a EINVAL e retorna 0.strspn e wcsspn não validam seus parâmetros.Essas três funções se comportam de forma idêntica.

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

Mapeamentos da rotina de Genérico- texto

Rotina de TCHAR.H	_UNICODE & _MBCS não definidos	_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 informações extras de compatibilidade Compatibilidade na introdução, consulte.

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 );
}