strspn, wcsspn, _mbsspn, _mbsspn_l

Artykuł
03/26/2013

Zwraca indeks pierwszego znaku w ciągu, który nie należy do zestawu znaków.

Ważne
_mbsspni _mbsspn_l nie można używać w aplikacji, których wykonywanie w czasie wykonywania systemu Windows.Aby uzyskać więcej informacji, zobacz CRT funkcje nie obsługiwane przez /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
);

Parametry

str
Ciąg zakończony znakiem null, do wyszukiwania.
strCharSet
Zestaw znaków zakończony znakiem null.
locale
Ustawienia regionalne używane.

Wartość zwracana

Zwraca wartość całkowitą długość podciągu w str który zawiera tylko znaki w strCharSet*.* Jeśli str rozpoczyna się od znaku nie w strCharSet*,* funkcja zwraca 0.

Uwagi

strspn , Funkcja zwraca indeks pierwszego znaku w str który nie należy do zestawu znaków w strCharSet.Wyszukiwanie nie obejmuje kończące znaki null.

wcsspni _mbsspn szerokich znaków i znaków wielobajtowych wersje strspn**.** Argumenty wcsspn są ciągami szerokich znaków; tych z _mbsspn są ciągami znaków wielobajtowych._mbsspnsprawdza poprawność jego parametry.Jeśli str lub strCharSet jestNULL, program obsługi nieprawidłowy parametr jest wywoływana, zgodnie z opisem w Sprawdzanie poprawności parametru .Jeśli wykonanie może kontynuować, _mbspn ustawia errno do EINVAL i zwraca wartość 0.strspni wcsspn nie są zgodne z nimi parametrów.Zmienia tych trzech funkcji zachowanie takich samych nazwach.

Wartość produkcji jest zależny od ustawienia z LC_CTYPE kategorii ustawienie regionalne tzn. zobacz setlocale Aby uzyskać więcej informacji.Wersje te funkcje, bez _l sufiks Użyj bieżących ustawień regionalnych tego zachowania zależne od ustawień lokalnych; wersje z _l sufiks są identyczne z tym, że używają zamiast przekazany parametr ustawień regionalnych.Aby uzyskać więcej informacji, zobacz Ustawienia regionalne.

Tekst rodzajowy rutynowych mapowania

TCHAR.Rozpoczęto wykonywanie procedury h	_UNICODE & _MBCS nie zdefiniowany	_MBCS, definicja	_UNICODE, definicja
_tcsspn	strspn	_mbsspn	wcsspn
n/d	n/d	_mbsspn_l	n/d

Wymagania

Rozpoczęto wykonywanie procedury	Wymaganego nagłówka
strspn	<string.h>
wcsspn	<string.h> lub <wchar.h>
_mbsspn, _mbsspn_l	<mbstring.h>

Aby uzyskać dodatkowe informacje o zgodności, zobacz zgodności we wprowadzeniu.

Przykład

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