strspn, wcsspn, _mbsspn, _mbsspn_l

Articolo
03/26/2013

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

Importante
_mbsspn e _mbsspn_l non possono essere utilizzati nelle applicazioni eseguite nelle finestre 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 in strCharSet*,* restituisce 0 di funzione.

Note

La funzione di 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 disponibili versioni a caratteri estesi e di caratteri multibyte di strspn**.** Gli argomenti di wcsspn sono stringhe di caratteri estesi, tali di _mbsspn sono stringhe di caratteri multibyte._mbsspn convalida i suoi parametri.Se str o strCharSet èNULL, il gestore non valido di parametro viene richiamato, 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 a Testo generico

TCHAR.H routine	_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à nell'introduzione.

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