_strspnp, _wcsspnp, _mbsspnp, _mbsspnp_l

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

重要

_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 字符。

如果 str 或 charset 为空指针，则此函数将调用无效的参数处理程序，如参数验证中所述。 如果允许继续执行，则函数将返回 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

另请参阅

字符串操作
区域设置
多字节字符序列的解释
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