strspn, wcsspn, _mbsspn, _mbsspn_l

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

Importante

_mbsspn e _mbsspn_l não podem ser usados em aplicativos executados no Windows Runtime. Para obter mais informações, confira Funções do CRT sem suporte em aplicativos da Plataforma Universal do Windows.

Sintaxe

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 em nulo para pesquisa.

strCharSet
Conjunto de caracteres terminado em nulo.

locale
Localidade a usar.

Valor retornado

Retorna um valor inteiro especificando o comprimento da subcadeia de caracteres em str que consiste inteiramente em caracteres em strCharSet. Se str começar com um caractere que não está em strCharSet, a função retornará 0.

Comentários

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

wcsspn e _mbsspn são versões de caracteres largos e de caracteres multibyte de strspn. Os argumentos de wcsspn são cadeias de caracteres largos. Os argumentos de _mbsspn são cadeias de caracteres multibyte. _mbsspn valida seus parâmetros. Se str ou strCharSet for NULL, o manipulador de parâmetro inválido será invocado, conforme descrito em Validação de parâmetro. Se a execução tiver permissão para continuar, _mbspn definirá errno para EINVAL e retornará 0. strspn e wcsspn não validam seus parâmetros. Caso contrário, essas três funções se comportam de forma idêntica.

O valor de saída é afetado pela configuração da categoria LC_CTYPE da localidade. Para obter mais informações, consulte setlocale. As versões dessas funções sem o sufixo _l usam a localidade atual desse comportamento dependente da localidade. As versões com o sufixo _l são idênticas, exceto por usarem o parâmetro de localidade passado em seu lugar. Para obter mais informações, consulte Localidade.

Por padrão, o estado global dessa função tem como escopo o aplicativo. Para alterar esse comportamento, confira Estado global no CRT.

Mapeamentos de rotina de texto genérico

Rotina TCHAR.H	_UNICODE e _MBCS não definidos	_MBCS definido	_UNICODE definido
_tcsspn	strspn	_mbsspn	wcsspn
n/a	n/a	_mbsspn_l	n/a

Requisitos

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

Para obter informações sobre 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 );
}

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

Confira também

Manipulação de cadeia de caracteres
Localidade
Interpretação de sequências de caracteres multibyte
_strspnp, _wcsspnp, _mbsspnp, _mbsspnp_l
strcspn, wcscspn, _mbscspn, _mbscspn_l
strncat, _strncat_l, wcsncat, _wcsncat_l, _mbsncat, , _mbsncat_l
strncmp, wcsncmp, _mbsncmp, _mbsncmp_l
strncpy, _strncpy_l, wcsncpy, _wcsncpy_l, _mbsncpy, , _mbsncpy_l
_strnicmp, _wcsnicmp, _mbsnicmp, _strnicmp_l, _wcsnicmp_l, , _mbsnicmp_l
strrchr, wcsrchr, _mbsrchr, _mbsrchr_l