Partager via


_strspnp, _wcsspnp, _mbsspnp, _mbsspnp_l

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

Sortie

abbage

Équivalent .NET Framework

Non applicable. Pour appeler la fonction C standard, utilisez PInvoke. Pour plus d'informations, consultez l' Exemples d'appel de code non managé.

Voir aussi

Référence

Manipulation de chaînes (CRT)

Paramètres régionaux

Interprétation des séquences de caractères multioctets

strspn, wcsspn, _mbsspn, _mbsspn_l

strncat_s, _strncat_s_l, wcsncat_s, _wcsncat_s_l, _mbsncat_s, _mbsncat_s_l

strncmp, wcsncmp, _mbsncmp, _mbsncmp_l

strncpy_s, _strncpy_s_l, wcsncpy_s, _wcsncpy_s_l, _mbsncpy_s, _mbsncpy_s_l

_strnicmp, _wcsnicmp, _mbsnicmp, _strnicmp_l, _wcsnicmp_l, _mbsnicmp_l

strrchr, wcsrchr, _mbsrchr, _mbsrchr_l