_mbsspnp, _mbsspnp_l, _strspnp, _wcsspnp

Artigo
08/25/2010

Retorna um ponteiro para o primeiro caractere em uma determinada seqüência de caracteres que é em outra seqüência de caracteres fornecida.

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
);
char *_strspnp(
   const char *str,
   const char *charset
);
wchar_t *_wcsspnp(
   const unsigned wchar_t *str,
   const unsigned wchar_t *charset
);

Parâmetros

str
Seqüência terminada por caractere nulo para pesquisar.
charset
Conjunto de caracteres terminada com caractere nulo.
locale
Localidade usar.

Valor de retorno

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

Comentários

The _mbsspnp função retorna um ponteiro para o caractere multibyte, que é o primeiro caractere em str que não pertence ao conjunto de caracteres charset. _mbsspnp reconhece as seqüências de caractere multibyte acordo com o página de código multibyte atualmente em uso.A Pesquisar não inclui caracteres nulo de terminação.

Se qualquer um dos str ou charset é um ponteiro nulo, essa função chama o manipulador de parâmetro inválido, conforme descrito em Validação de parâmetro. Se a execução terá permissão para continuar, a função retornará NULL e conjuntos errno para EINVAL.

Mapeamentos de rotina de texto genérica

Rotina tchar.h	_UNICODE e _MBCS não definido	_MBCS definido	_UNICODE definido
_tcsspnp	_strspnp	_mbsspnp	_wcsspnp

_strspnp e _wcsspnp são caracteres de um byte e versões de caractere largo da _mbsspnp. _strspnp e _wcsspnp se comportar de forma idêntica para _mbsspnp Caso contrário, eles são fornecidos somente para este mapeamento e não devem ser usados por qualquer Outros motivo. Para obter mais informações, consulte Usando mapeamentos de texto genérico and Mapeamentos de texto genérica.

_mbsspnp_l é idêntica, exceto pelo fato de que ele utiliza o parâmetro de localidade passado em vez disso.For more information, see Localidade.

Requisitos

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

Para obter mais informações de compatibilidade, consulte 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);
}