_strspnp, _wcsspnp, _mbsspnp, _mbsspnp_l

Articolo
06/09/2015

Puntatore a una stringa di caratteri con terminazione di tipo null che contiene lo spazio dei nomi nel quale si trova l'attributo.

Importante

_mbsspnp e _mbsspnp_l non possono essere utilizzate nelle applicazioni che vengono eseguite in Windows Runtime.Per ulteriori informazioni, vedere Funzioni CRT non supportate con /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
);

Parametri

str
Stringa da cercare con terminazione null.
charset
Set di caratteri con terminazione null.
locale
Impostazioni locali da utilizzare.

Valore restituito

_strspnp, _wcsspnpe _mbsspnp restituiscono un puntatore al primo carattere in str che non appartiene al set di caratteri in charset*.* Ognuna di queste funzioni restituisce NULL se str è costituita esclusivamente da caratteri del charset*.* Per ognuna di queste routine, non esiste alcun valore di ritorno che indichi un errore.

Note

La funzione _mbsspnp restituisce un puntatore al primo carattere multibyte in str che non appartiene al set di caratteri in charset. _mbsspnp riconosce le sequenze di caratteri multibyte come indicato dalla tabella codici multibyte in uso. La ricerca non include il carattere di terminazione null.

Se str o charset è un puntatore null, questa funzione richiamerà il gestore di parametro non valido, come descritto in Convalida dei parametri. Se l'esecuzione può continuare, la funzione restituisce NULL e imposta errno su EINVAL.

Mapping di routine su testo generico

Routine Tchar.h	_UNICODE e _MBCS non definiti	_MBCS definito	_UNICODE definito
_tcsspnp	_strspnp	_mbsspnp	_wcsspnp

_strspnp e _wcsspnp sono versioni a caratteri di tipo "wide" e a caratteri a singolo byte di _mbsspnp. In caso contrario le funzioni _strspnp e _wcsspnp si comportano in modo identico a _mbsspnp ; vengono fornite solo per questo mapping e non devono essere utilizzate per qualsiasi altro motivo. Per ulteriori informazioni, vedere Utilizzo delle mappature di Testo generico e Mappature di Testo generico.

_mbsspnp_lè identico con la differenza che utilizza il parametro delle impostazioni locali che viene passato. Per ulteriori informazioni, vedere Impostazioni locali.

Requisiti

Routine	Intestazione obbligatoria
_mbsspnp	<mbstring.h>
_strspnp	<tchar.h>
_wcsspnp	<tchar.h>

Per ulteriori informazioni sulla compatibilità, vedere Compatibilità.

Esempio

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