_strspnp, _wcsspnp, _mbsspnp, _mbsspnp_l

Artykuł
06/09/2015

Zwraca wskaźnik do pierwszego znaku w danym ciągu, który nie jest w innym danym ciągu.

Ważne
_mbsspnp i _mbsspnp_l nie można używać w aplikacjach korzystających ze środowiska wykonawczego systemu Windows.Aby uzyskać więcej informacji, zobacz Funkcje CRT nieobsługiwane przez /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
);

Parametry

str
Ciąg zakończony wartością null do przeszukania.
charset
Zestaw znaków zakończony znakiem null.
locale
Ustawienia regionalne do użycia.

Wartość zwracana

_strspnp, _wcsspnp i _mbsspnp zwracają wskaźnik do pierwszego znaku w str, który nie należy do zestawu znaków w charset*.* Każda z tych funkcji zwraca NULL jeśli str w całości składa się ze znaków z charset*.* Dla każdej z tych procedur, żadna wartość zwracana nie jest zarezerwowana do wskazania błędu.

Uwagi

_mbsspnp funkcja zwraca wskaźnik do znaku wielobajtowego, który jest pierwszym znakiem w str , który nie należy do zestawu znaków w charset._mbsspnp rozpoznaje sekwencje znaków wielobajtowych według strony kodowej znaków wielobajtowych obecnie w użyciu.Wyszukiwanie nie obejmuje kończących się pustych znaków.

Jeśli str lub charset jest pustym wskaźnikiem, funkcja wywoła procedurę obsługi nieprawidłowego parametru, zgodnie z opisem w Sprawdzanie poprawności parametru.Jeśli wykonanie może być kontynuowane, funkcja zwraca NULL i ustawia errno jako EINVAL.

Rutynowe mapowania zwykłego tekstu

Procedura Tchar.h	_UNICODE i _MBCS nie zdefiniowany	_MBCS zdefiniowano	_UNICODE zdefiniowany
_tcsspnp	_strspnp	_mbsspnp	_wcsspnp

_strspnp i _wcsspnp są wersjami znaków jednobajtowych i dwubajtowych _mbsspnp._strspnp i _wcsspnp zachowują się identycznie do _mbsspnp w innym przypadku; są dostarczane tylko dla tego mapowania i nie powinny być używane z innego powodu.Aby uzyskać więcej informacji, zobacz Korzystanie z mapowań ogólnego tekstu i Mapowania ogólne tekstu.

_mbsspnp_ljest identyczny, z tą różnicą, że zamiast tego używa przekazanego parametru regionalnego.Aby uzyskać więcej informacji, zobacz Regionalne.

Wymagania

Procedura	Wymagany nagłówek
_mbsspnp	<mbCiąg.h>
_strspnp	<tchar.h>
_wcsspnp	<tchar.h>

Aby uzyskać więcej informacji na temat zgodności – zobacz: Zgodność.

Przykład

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