strcspn, wcscspn, _mbscspn, _mbscspn_l

Articolo
03/26/2013

Restituisce l'indice della prima occorrenza di un carattere in una stringa che appartiene a un set di caratteri.

Importante
_mbschr e _mbschr_lnon possono essere utilizzati nelle applicazioni eseguite nelle finestre runtime.Per ulteriori informazioni, vedere Funzioni CRT non supportate con /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
);

Parametri

str
La stringa cercata con terminazione null.
strCharSet
Set di caratteri con terminazione null.
locale
Impostazioni locali da utilizzare.

Valore restituito

Queste funzioni restituiscono indice del primo carattere in str in strCharSet.Se nessuno dei caratteri in str è in strCharSet, il valore restituito è la lunghezza di str.

Nessun valore restituito è riservato per indicare un errore.

Note

wcscspn e _mbscspn sono versioni a caratteri di tipo "wide" e di caratteri multibyte di strcspn.Gli argomenti di wcscspn sono stringhe di caratteri estesi, tali di _mbscspn sono stringhe di caratteri multibyte.

_mbscspn convalida i suoi parametri.Se str o strCharSet è un puntatore null, il gestore non valido di parametro viene richiamato, come descritto in Convalida dei parametri.Se l'esecuzione è consentita per continuare, la funzione restituisce 0 e imposta errno a EINVAL.strcspn e wcscspn non convalidano i relativi parametri.Altrimenti queste tre funzioni si comportano in modo identico.

Il valore di output è interessato dall'impostazione dell'impostazione di categoria LC_CTYPE delle impostazioni locali; vedere setlocale per ulteriori informazioni.Le versioni di queste funzioni senza il suffisso _l utilizzano le impostazioni locali correnti per il comportamento dipendente dalle impostazioni locali; le versioni con il suffisso _l sono identiche, ad eccezione del fatto che utilizzano il parametro delle impostazioni locali che viene passato.Per ulteriori informazioni, vedere Impostazioni locali.

Mapping di routine a Testo generico

TCHAR.H routine	_UNICODE & _MBCS non definiti	_MBCS definito	_UNICODE definito
_tcscspn	strcspn	_mbscspn	wcscspn
n/a	n/a	_mbscspn_l	n/a

Requisiti

Routine	Intestazione obbligatoria
strcspn	<string.h>
wcscspn	<string.h> o <wchar.h>
_mbscspn, _mbscspn_l	<mbstring.h>

Per ulteriori informazioni sulla compatibilità, vedere Compatibilità nell'introduzione.

Esempio

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