_strspnp, _wcsspnp, _mbsspnp, _mbsspnp_l

Article
03/26/2013

Retourne un pointeur vers le premier caractère d'une chaîne donnée qui n'est 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 les fenêtres d'exécution.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 le caractère NULL à trouver.
charset
Jeu de caractères se terminant par null.
locale
Paramètres régionaux à utiliser.

Valeur de retour

_strspnp, _wcsspnp, et retour d' _mbsspnp 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 consiste entièrement composée de caractères d' charset*.* Pour chacun de ces routines, aucune valeur de retour n'est réservée pour indiquer une erreur.

Notes

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

Si str ou charset est un pointeur null, cette fonction appelle le gestionnaire de paramètre non valide, comme décrit dans Validation des paramètres.Si est autorisé à l'exécution pour continuer, la fonction retourne NULL et définit errno à EINVAL.

Mappages de routines de texte générique

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

_strspnp et _wcsspnp sont caractère codé sur un octet et versions à caractères larges d' _mbsspnp._strspnp et _wcsspnp se comportent de la même façon à _mbsspnp sinon ; ils sont fournis uniquement pour ce mappage et ne doivent pas être utilisés pour une autre raison.Pour plus d'informations, consultez Utilisation des mappages de texte générique et l' Mappages de texte générique.

_mbsspnp_lidentique mais il utilise le paramètre de paramètres régionaux passé à la place.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 de compatibilité, consultez l' Compatibilité dans l'introduction.

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