strspn, wcsspn, _mbsspn, _mbsspn_l
Gibt den Index des ersten Zeichens in einer Zeichenfolge zurück, die keinem Zeichensatz angehört.
Wichtig
_mbsspn und _mbsspn_l können nicht in Anwendungen verwendet werden, die in Windows-Runtime ausgeführt werden.Weitere Informationen finden Sie unter CRT-Funktionen nicht mit /ZW unterstützt.
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
Zu suchende mit NULL endende Zeichenfolge.strCharSet
Mit NULL endender Zeichensatz.locale
Zu verwendendes Gebietsschema.
Rückgabewert
Gibt einen ganzzahligen Wert zurück, der die Länge der untergeordneten Zeichenfolge in str angibt, die vollständig aus Zeichen in strCharSetbesteht. Wenn str mit einem Zeichen beginnt, das nicht in strCharSet enthalten ist, gibt die Funktion 0 (null) zurück.
Hinweise
Die strspn-Funktion gibt den Index des ersten Zeichens in str zurück, das nicht dem Zeichensatz in strCharSet angehört. Die Suche umfasst keine abschließenden Nullzeichen.
wcsspn und _mbsspn sind Breitzeichen- und Multibytezeichenversionen von strspn**.** Die Argumente von wcsspn sind Breitzeichen-Zeichenfolgen, die von _mbsspn sind Multibyte-Zeichenfolgen. _mbsspn überprüft die eigenen Parameter. Wenn str oder strCharSetNULL ist, wird der ungültige Parameterhandler aufgerufen, wie in Parametervalidierung beschrieben. Wenn die weitere Ausführung zugelassen wird, legt _mbspnerrno auf EINVAL fest und gibt 0 zurück. strspn und wcsspn überprüfen ihre Parameter nicht. Diese drei Funktionen verhalten sich andernfalls identisch.
Der Ausgabewert ist von der LC_CTYPE-Kategorieneinstellung des Gebietsschemas betroffen; weitere Informationen finden Sie unter setlocale. Die Versionen dieser Funktionen ohne das _l-Suffix verwenden das aktuelle Gebietsschema für dieses vom Gebietsschema abhängige Verhalten; die Versionen mit dem _l-Suffix sind beinahe identisch, verwenden jedoch stattdessen den ihnen übergebenen Gebietsschemaparameter. Weitere Informationen finden Sie unter Locale.
Zuordnung generischer 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> |
Weitere Informationen zur Kompatibilität finden Sie unter Kompatibilität.
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 );
}
.NET Framework-Entsprechung
Siehe auch
Referenz
Zeichenfolgenbearbeitung (CRT)
Interpretation von Mehrbytezeichensequenzen
_strspnp, _wcsspnp, _mbsspnp, _mbsspnp_l
strcspn, wcscspn, _mbscspn, _mbscspn_l
strncat, _strncat_l, wcsncat, _wcsncat_l, _mbsncat, _mbsncat_l
strncmp, wcsncmp, _mbsncmp, _mbsncmp_l
strncpy, _strncpy_l, wcsncpy, _wcsncpy_l, _mbsncpy, _mbsncpy_l
_strnicmp, _wcsnicmp, _mbsnicmp, _strnicmp_l, _wcsnicmp_l, _mbsnicmp_l