strcspn, wcscspn, _mbscspn, _mbscspn_l

Artigo
08/25/2010

Retorna o índice da primeira ocorrência de um caractere em uma seqüência de caracteres que pertence a um conjunto de caracteres.

size_t strcspn(
   const char *str,
   const char *strCharSet 
);
size_t wcscspn(
   const wchar_t *str,
   const wchar_t *strCharSet 
);
size_t _mbscspn(
   const unsigned char *str,
   const unsigned char *strCharSet 
);
size_t _mbscspn(
   const unsigned char *str,
   const unsigned char *strCharSet,
   _locale_t locale
);

Parâmetros

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

Valor de retorno

Essas funções retornam o índice do primeiro caractere em str que está no strCharSet. Se nenhum dos caracteres em str está no strCharSet, o valor retornado será o tamanho de str.

Nenhum valor retornado é reservado para indicar um erro.

Comentários

wcscspn e _mbscspnsão versões de caractere largo e caracteres de multibyte de strcspn. Os argumentos de wcscspn são caractere largos strings; as de _mbscspn são seqüências de caractere de multibyte.

_mbscspn valida os parâmetros. Se qualquer um dos str ou strCharSet é um ponteiro nulo, o manipulador de parâmetro inválido é invocado, sistema autônomo descrito em Validação de parâmetro. Se a execução for permitida para continuar, a função retorna 0 e define errno para EINVAL. strcspn e wcscspn 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
_tcscspn	strcspn	_mbscspn	wcscspn
n/a	n/a	_mbscspn_l	n/a

Requisitos

Rotina	Cabeçalho necessário
strcspn	<string.h>
wcscspn	<string.h> ou <wchar.h>
_mbscspn, _mbscspn_l	<mbstring.h>

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

Exemplo

// crt_strcspn.c

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

void test( const char * str, const char * strCharSet )
{
   int pos = strcspn( str, strCharSet );
   printf( "strcspn( \"%s\", \"%s\" ) = %d\n", str, strCharSet, pos );    
}

int main( void )
{
   test( "xyzbxz", "abc" );
   test( "xyzbxz", "xyz" );
   test( "xyzbxz", "no match" );
   test( "xyzbxz", "" );
   test( "", "abc" );
   test( "", "" );
}

strcspn( "xyzbxz", "abc" ) = 3 strcspn( "xyzbxz", "xyz" ) = 0 strcspn( "xyzbxz", "no match" ) = 6 strcspn( "xyzbxz", "" ) = 6 strcspn( "", "abc" ) = 0 strcspn( "", "" ) = 0