strspn, wcsspn, _mbsspn, _mbsspn_l

Articolo
06/09/2015

Restituisce l'indice del primo carattere, in una stringa, che non appartiene ad un set di caratteri.

Importante

_mbsspn e _mbsspn_l non possono essere utilizzate nelle applicazioni che vengono eseguite in Windows Runtime.Per ulteriori informazioni, vedere Funzioni CRT non supportate con /ZW.

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
);

Parametri

str
Stringa da cercare con terminazione null.
strCharSet
Set di caratteri con terminazione null.
locale
Impostazioni locali da utilizzare.

Valore restituito

Restituisce un valore intero che specifica la lunghezza della sottostringa in str interamente costituita da caratteri in strCharSet*.* Se str inizia con un carattere non incluso in strCharSet*,* la funzione restituisce 0.

Note

La funzione strspn restituisce l'indice del primo carattere in str che non appartiene al set di caratteri in strCharSet. La ricerca non include il carattere di terminazione null.

wcsspn e _mbsspn sono versioni a caratteri di tipo "wide" e multibyte di strspn**.** Gli argomenti di wcsspn sono stringhe di caratteri di tipo "wide", quelli di _mbsspn sono stringhe di caratteri multibyte. _mbsspn convalida i suoi parametri. Se str o strCharSet èNULL iene richiamato il gestore di parametro non valido, come descritto in Convalida dei parametri. Se all'esecuzione è consentito continuare, _mbspn imposta errno al valore EINVAL e restituisce 0. strspn e wcsspn 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 su testo generico

Routine TCHAR.H	_UNICODE & _MBCS non definiti	_MBCS definito	_UNICODE definito
_tcsspn	strspn	_mbsspn	wcsspn
n/d	n/d	_mbsspn_l	n/d

Requisiti

Routine	Intestazione obbligatoria
strspn	<string.h>
wcsspn	<string.h> o <wchar.h>
_mbsspn, _mbsspn_l	<mbstring.h>

Per ulteriori informazioni sulla compatibilità, vedere Compatibilità.

Esempio

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