_strspnp, _wcsspnp, _mbsspnp, _mbsspnp_l

Artikel
03/12/2013

Gibt einen Zeiger auf das erste Zeichen in einer angegebenen Zeichenfolge zurück, die nicht in einer anderen angegebenen Zeichenfolge ist.

Wichtig
_mbsspnp und _mbsspnp_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.

char *_strspnp( const char *str, const char *charset ); wchar_t *_wcsspnp( const unsigned wchar_t *str, const unsigned wchar_t *charset ); unsigned char *_mbsspnp( const unsigned char *str, const unsigned char *charset ); unsigned char *_mbsspnp_l( const unsigned char *str, const unsigned char *charset, _locale_t locale );

Parameter

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

Rückgabewert

_strspnp, _wcsspnp und _mbsspnp Rückgabe ein Zeiger auf das erste Zeichen in str, die nicht dem Satz von Zeichen in charset gehört . Jede dieser Funktionen NULL gibt zurück, wenn str vollständig aus Zeichen von charset besteht . Für jede dieser Routinen, wird kein Rückgabewert reserviert, um einen Fehler anzugeben.

Hinweise

Die _mbsspnp-Funktion gibt einen Zeiger auf das Mehrbytezeichen zurück, das das erste Zeichen in str ist, das nicht dem Satz von Zeichen in charset gehört._mbsspnp erkennt Mehrbytezeichensequenzen entsprechend Mehrbyte-Codepage derzeit.Die Suche umfasst NULL nicht zulässig.

Wenn entweder str oder charset ein NULL-Zeiger ist, Aufrufe dieser Funktion der ungültige Parameterhandler, wie in Parametervalidierung beschrieben.Wenn die Ausführung zulässig ist, um fortzufahren, gibt die Funktion NULL zurück und legt errno zu EINVAL fest.

Zuordnung generische Textroutinen

Tchar.h-Routine	_UNICODE und _MBCS nicht definiert	_MBCS definiert	_UNICODE definiert
_tcsspnp	_strspnp	_mbsspnp	_wcsspnp

_strspnp und _wcsspnp sind Einzelbytezeichen und Breitzeichenversionen von _mbsspnp._strspnp und _wcsspnp verhalten sich genauso wie _mbsspnp ; andernfalls Sie werden nur für diese Zuordnung bereitgestellt und sollten nicht für jeden anderen Grund verwendet werden.Weitere Informationen finden Sie unter Verwenden von Zuordnungen für generischen Text und Zuordnungen für generischen Text.

_mbsspnp_l ist identisch, außer dass verwendet den Gebietsschemaparameter, der in stattdessen übergeben wird.Weitere Informationen finden Sie unter Gebietsschema.

Anforderungen

Routine	Erforderlicher Header
_mbsspnp	<mbstring.h>
_strspnp	<tchar.h>
_wcsspnp	<tchar.h>

Weitere Kompatibilitätsinformation finden Sie unter Kompatibilität in der Einführung.

Beispiel

// crt_mbsspnp.c
#include <mbstring.h>
#include <stdio.h>

int main( void ) {
   const unsigned char string1[] = "cabbage";
   const unsigned char string2[] = "c";
   unsigned char *ptr = 0;
   ptr = _mbsspnp( string1, string2 );
   printf( "%s\n", ptr);
}

Ausgabe

abbage

.NET Framework-Entsprechung

Nicht zutreffend. Um die Standard-C-Funktion aufzurufen, verwenden Sie PInvoke. Weitere Informationen finden Sie unter Beispiele für Plattformaufrufe.