strspn, wcsspn, _mbsspn, _mbsspn_l
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
Equivalente do NET Framework
Consulte também
Referência
Manipulação de seqüência de caracteres (CRT)
Interpretação de seqüências de caractere multibyte
_mbsspnp, _mbsspnp_l, _strspnp, _wcsspnp
strcspn, wcscspn, _mbscspn, _mbscspn_l
strncat, _strncat_l, wcsncat, wcsncat_l, _mbsncat _mbsncat_l
strncmp, wcsncmp, _mbsncmp, _mbsncmp_l
funções strncpy, _strncpy_l, wcsncpy, _wcsncpy_l, _mbsncpy, _mbsncpy_l
_strnicmp, _wcsnicmp, _mbsnicmp, _strnicmp_l, _wcsnicmp_l, _mbsnicmp_l