strspn, wcsspn, _mbsspn, _mbsspn_l

Artikel
03/12/2013

Gibt den Index des ersten Zeichens in einer Zeichenfolge zurück, die nicht zu einem Satz von Zeichen gehört.

Wichtig
_mbsspn und _mbsspn_l können in Anwendungen nicht verwendet werden, die in der Windows Runtime ausführen.Weitere Informationen finden Sie unter CRT-Funktionen unterstützt nicht mit /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 );

Parameter

str
Auf NULL endende Zeichenfolge zu suchen.
strCharSet
Auf NULL endende Zeichensatz.
locale
Zu verwendende Gebietsschema.

Rückgabewert

Gibt einen ganzzahligen Wert zurück, der die Länge der Teilzeichenfolge in str angibt, die ausschließlich aus Zeichen in strCharSet besteht . Wenn str mit einem Zeichen nicht in strCharSet beginnt ,-Funktionsrückgaben 0.

Hinweise

Die strspn-Funktion gibt den Index des ersten Zeichens in str zurück, die nicht dem Satz von Zeichen in strCharSet gehört.Die Suche umfasst NULL nicht zulässig.

wcsspn und _mbsspn sind Breitzeich und Mehrbytezeichen-Versionen von strspn**.** Die Argumente von wcsspn sind Breitzeichen-Zeichenfolgen; die von _mbsspn sind Mehrbyte-Zeichenfolgen._mbsspn überprüft seine Parameter.Wenn str oder strCharSetNULL ist, wird der ungültige Parameterhandler aufgerufen, wie in Parametervalidierung beschrieben.Wenn die Ausführung zulässig ist, um fortzufahren, legt _mbspnerrno zu EINVAL fest und gibt 0 zurück.strspn und wcsspn überprüfen nicht ihre Parameter.Diese drei Funktionen verhalten sich andernfalls identisch.

Der Ausgabewert wird durch die Einstellung der LC_CTYPE Kategorieneinstellung des Gebietsschemas betroffen; setlocale finden Sie weitere Informationen.Die Versionen dieser Funktionen ohne das _l Suffix verwenden das aktuelle Gebietsschema für dieses Verhalten abhängig; die Versionen mit dem _l Suffix sind identisch, allerdings verwenden den Gebietsschemaparameter, der in stattdessen übergeben wird.Weitere Informationen finden Sie unter Gebietsschema.

Zuordnung generische Textroutinen

TCHAR.H-Routine	_UNICODE & _MBCS nicht definiert.	_MBCS definiert	_UNICODE definiert
_tcsspn	strspn	_mbsspn	wcsspn
nicht verfügbar	nicht verfügbar	_mbsspn_l	nicht verfügbar

Anforderungen

Routine	Erforderlicher Header
strspn	<string.h>
wcsspn	<string.h> oder <wchar.h>
_mbsspn, _mbsspn_l	<mbstring.h>

So zusätzlicher Kompatibilitätsinformation finden Sie unter Kompatibilität in der Einführung.

Beispiel

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