返回指向给定字符串(不在另一个给定字符串)中的第一个字符的指针。

重要

_mbsspnp_mbsspnp_l 无法用于在 Windows 运行时中执行的应用程序。 有关详细信息,请参阅通用 Windows 平台应用中不支持的 CRT 函数

语法

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

参数

str
要搜索的 null 终止的字符串。

charset
null 终止的字符集。

locale
要使用的区域设置。

返回值

_strspnp_wcsspnp_mbsspnp 返回指向 str(不属于 charset 中的字符集)中的第一个字符的指针。 如果 str 包含 charset 中的所有字符,则每个函数将返回 NULL。 对于这些例程,都不会保留返回值来指示错误。

备注

_mbsspnp 函数返回指向 str(不属于 charset 中的字符集)中第一个字符的多字节字符的指针。 _mbsspnp 根据当前使用的多字节代码页识别多字节字符序列。 搜索不包括终止 null 字符。

如果 strcharset 为空指针,则此函数将调用无效的参数处理程序,如参数验证中所述。 如果允许继续执行,则函数将返回 NULL,并且将 errno 设置为 EINVAL

默认情况下,此函数的全局状态范围限定为应用程序。 若要更改此行为,请参阅 CRT 中的全局状态

一般文本例程映射

Tchar.h 例程 _UNICODE_MBCS 未定义 _MBCS 已定义 _UNICODE 已定义
_tcsspnp _strspnp _mbsspnp _wcsspnp

_strspnp_wcsspnp_mbsspnp 的单字节字符及宽字符版本。 否则 _strspnp_wcsspnp_mbsspnp 的行为相同;它们仅提供用于此映射,不应用于其他任何目的。 有关详细信息,请参阅使用一般文本映射一般文本映射

_mbsspnp_l 是相同的,只不过它改用传递的区域设置参数。 有关详细信息,请参阅 Locale

要求

例程 必需的标头
_mbsspnp <mbstring.h>
_strspnp <tchar.h>
_wcsspnp <tchar.h>

有关兼容性的详细信息,请参阅 兼容性

示例

// 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

另请参阅

字符串操作
区域设置
多字节字符序列的解释