_strspnp, _wcsspnp, _mbsspnp, _mbsspnp_l

 

Pour obtenir la dernière documentation sur Visual Studio 2017, consultez Documentation Visual Studio 2017.

Retourne un pointeur vers le premier caractère dans une chaîne donnée est un pas dans une autre chaîne.

System_CAPS_ICON_important.jpg Important

_mbsspnp et _mbsspnp_l ne peuvent pas être utilisées dans les applications qui s'exécutent dans 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.

_strspnp, _wcsspnp, et _mbsspnp retourner un pointeur vers le premier caractère de str qui n’appartient pas au jeu de caractères de charset . Chacune de ces fonctions retourne NULL si str se compose uniquement de caractères à partir de charset . Pour chacune de ces routines, aucune valeur de retour n’est réservée pour indiquer une erreur.

Le _mbsspnp fonction retourne un pointeur vers le caractère multioctet qui est le premier caractère dans str qui n’appartient pas au jeu de caractères de charset. _mbsspnpreconnaît les séquences de caractères multioctets en fonction de la page de codes multioctets en cours d’utilisation. La recherche n’inclut pas la fin des caractères null.

Si le paramètre str ou charset est un pointeur null, cette fonction appelle le Gestionnaire de paramètre non valide, comme décrit dans Validation de paramètre. Si l'exécution est autorisée à continuer, cette fonction retourne NULL et définit à errno à 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

_strspnpet _wcsspnp sont des caractères à un octet et les versions à caractères larges de _mbsspnp. _strspnpet _wcsspnp se comportent de la même manière que _mbsspnp ; sinon, ils sont fournis uniquement pour ce mappage et ne doit pas être utilisés pour une raison quelconque. Pour plus d’informations, consultez à l’aide des mappages de texte générique et mappages de texte générique.

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

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

Pour plus d’informations sur la compatibilité, consultez Compatibility.

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

abbage  

Non applicable. Pour appeler la fonction C standard, utilisez PInvoke. Pour plus d'informations, consultez Exemples d'appel de plateforme.

Manipulation de chaînes
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

Afficher: