_strspnp, _wcsspnp, _mbsspnp, _mbsspnp_l

Article
06/09/2015

Retourne un pointeur au premier caractère de la chaîne donnée ne figurant pas dans une autre chaîne donnée

Important

_mbsspnp et _mbsspnp_l ne peuvent pas être utilisés dans les applications qui s'exécutent dans le Windows Runtime.Pour plus d'informations, consultez Fonctions CRT non prises en charge avec /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
);

Paramètres

str
Chaîne terminée par Null à trouver.
charset
Jeu de caractères se terminant par null.
locale
Paramètres régionaux à utiliser.

Valeur de retour

_strspnp, _wcsspnp, et _mbsspnp retournent un pointeur vers le premier caractère de str qui n'appartient pas au jeu de caractères dans charset*.* Chacune de ces fonctions retourne NULL si str se compose intégralement des caractères de charset*.* Pour chacune de ces routines, aucune valeur de retour n'est réservée pour indiquer une erreur.

Notes

La fonction _mbsspnp retourne un pointeur au caractère multioctets qui est le premier caractère de str qui n'appartient pas au jeu de caractères dans charset. _mbsspnp identifie des séquences de caractères multioctets selon la page de codes multioctets en cours d'utilisation. La recherche ne contient pas les caractères de fin null.

Si str ou charset est un pointeur null, cette fonction invoque le gestionnaire de paramètres non valides, comme décrit dans Validation de paramètre. Si l'exécution est autorisée à se poursuivre, la fonction retourne NULL et définit errno à la valeur EINVAL.

Mappages de routines de texte générique

Routine Tchar.h	_UNICODE et _MBCS non définis	_MBCS défini	_UNICODE défini
_tcsspnp	_strspnp	_mbsspnp	_wcsspnp

_strspnp et _wcsspnp sont des versions à caractères élargis et à caractères simple-octets de _mbsspnp. _strspnp et _wcsspnp se comportent de la même manière que _mbsspnp sinon ; ils sont fournis uniquement pour ce mappage et ne doivent pas être utilisés pour toute autre raison. Pour plus d'informations, consultez Utilisation des mappages de texte générique et Mappages de texte générique.

_mbsspnp_lest identique sauf qu'il utilise à la place les paramètres régionaux qui sont passés. Pour plus d'informations, consultez Paramètres régionaux.

Configuration requise

Routine	En-tête requis
_mbsspnp	<mbstring.h>
_strspnp	<tchar.h>
_wcsspnp	<tchar.h>

Pour plus d'informations sur la compatibilité, consultez Compatibilité.

Exemple

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