_strspnp, _wcsspnp, _mbsspnp, _mbsspnp_l

Artigo
03/12/2013

Retorna um ponteiro para o primeiro caractere em uma cadeia de caracteres fornecida que não esteja em outra cadeia de caracteres especificados.

Importante
_mbsspnp e _mbsspnp_l não podem ser usados em aplicativos executados em Tempo de Execução do Windows.Para obter mais informações, consulte Funções de CRT não suportadas com /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 );

Parâmetros

str
Cadeia de caracteres NULL- finalizada a pesquisa.
charset
Conjunto de caracteres NULL- encerrado.
locale
A localidade usar.

Valor de retorno

_strspnp, _wcsspnp, e retorno de _mbsspnp um ponteiro para o primeiro caractere em str que não pertence ao conjunto de caracteres em charset*.* Cada uma dessas funções NULL retorna se str consiste inteiramente em caracteres de charset*.* Para cada uma dessas rotinas, nenhum valor de retorno é reservado para indicar um erro.

Comentários

A função de _mbsspnp retorna um ponteiro para o caractere de multibyte que é o primeiro caractere em str que não pertence ao conjunto de caracteres em charset._mbsspnp reconhece sequências de multibyte- caractere de acordo com a página de códigos de multibyte atualmente em uso.A pesquisa termine não inclui caracteres nulos.

Se str ou charset são um ponteiro zero, essa função chama o manipulador de parâmetro inválido, como descrito em Validação de parâmetro.Se a execução é permitida continuar, a função retorna NULL e defina errno a EINVAL.

Mapeamentos da rotina de Genérico- texto

Rotina de Tchar.h	_UNICODE e não definidos _MBCS	_MBCS definido	_UNICODE definido
_tcsspnp	_strspnp	_mbsspnp	_wcsspnp

_strspnp e _wcsspnp são versões de caracteres e largo- de caracteres de byte único de _mbsspnp._strspnp e _wcsspnp se comportam de forma idêntica a _mbsspnp de outra forma; são fornecidos apenas para esse mapeamento e não devem ser usados por qualquer outro motivo.Para obter mais informações, consulte Usando mapeamentos de Genérico- texto e Mapeamentos de Genérico- texto.

_mbsspnp_lé idêntico exceto que usa o parâmetro de localidade passado em vez disso.Para obter mais informações, consulte Localidade.

Requisitos

Rotina	Cabeçalho necessário
_mbsspnp	<mbstring.h>
_strspnp	<tchar.h>
_wcsspnp	<tchar.h>

Para mais informações, consulte Compatibilidade de compatibilidade na introdução.

Exemplo

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