返回指向给定字符串(不在另一个给定字符串)中的第一个字符的指针。
重要
_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