strcspn, wcscspn, _mbscspn, _mbscspn_l

Artigo
03/12/2013

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

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

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_l( const unsigned char *str, const unsigned char *strCharSet, _locale_t locale );

Parâmetros

str
Cadeia de caracteres pesquisada NULL- finalizada.
strCharSet
Conjunto de caracteres NULL- encerrado.
locale
A localidade usar.

Valor de retorno

Essas funções retorna o índice do primeiro caractere em str que está em strCharSet.Se nenhum de caracteres em str está em strCharSet, o valor de retorno é o comprimento de str.

Nenhum valor de retorno é reservado para indicar um erro.

Comentários

wcscspn e _mbscspn são versões de largo- caracteres e de multibyte- caractere de strcspn.Os argumentos de wcscspn são cadeias de caracteres de largo- caracteres; essas de _mbscspn são cadeias de caracteres de multibyte- caractere.

_mbscspn valida os seus parâmetros.Se str ou strCharSet são um ponteiro zero, o manipulador inválido do parâmetro é invocado, como descrito em Validação de parâmetro.Se a execução é permitida continuar, a função retorna 0 e defina errno a EINVAL.strcspn e wcscspn 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
_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 informações extras de compatibilidade Compatibilidade na introdução, consulte.

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( "", "" );
}