strspn, wcsspn, _mbsspn, _mbsspn_l

Artigo
06/09/2015

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 no Tempo de Execução do Windows.Para obter mais informações, consulte Funções CRT sem suporte pelo /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 terminada com Null para pesquisa.
strCharSet
Conjunto de caracteres terminados em nulo.
locale
Localidade a ser usada.

Valor de retorno

Retorna um valor inteiro que especifica o tamanho da subcadeia de caracteres em str que é inteiramente composta por caracteres em strCharSet*.* Se str começar com um caractere não em strCharSet*,* a função retornará 0.

Comentários

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

wcsspn e _mbsspn são versões de caracteres largos e de multibyte de strspn**.** Os argumentos de wcsspn são cadeias de caracteres largos; desses _mbsspn são cadeias de caracteres de multibyte. _mbsspn valida seus parâmetros. Se str ou strCharSet forNULL, o manipulador de parâmetro inválido será chamado, como descrito em Validação do parâmetro . Se a execução puder continuar, _mbspn definirá errno como EINVAL e retornará 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 LC_CTYPE de localidade. Para obter mais informações, consulte setlocale. As versões dessas funções sem o sufixo _l usam a localidade atual para esse comportamento dependente da localidade; as versões com o sufixo _l são idênticas, exceto que elas usam o parâmetro de localidade informado. Para obter mais informações, consulte Localidade.

Mapeamentos da rotina de texto genérico

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 informações adicionais de compatibilidade, consulte Compatibilidade.

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