strpbrk、wcspbrk、_mbspbrk、_mbspbrk_l

项目
06/09/2015

在指定的字符集扫描字符的字符串。

重要

_mbspbrk 和 _mbspbrk_l 不能在 Windows 运行时执行的应用程序中使用。有关详细信息，请参见 CRT functions not supported with /ZW（CRT 函数不支持使用/ZW）。

char *strpbrk(
   const char *str,
   const char *strCharSet 
); // C only
char *strpbrk(
   char *str,
   const char *strCharSet 
); // C++ only
const char *strpbrk(
   const char *str,
   const char *strCharSet 
); // C++ only
wchar_t *wcspbrk(
   const wchar_t *str,
   const wchar_t *strCharSet 
); // C only
wchar_t *wcspbrk(
   wchar_t *str,
   const wchar_t *strCharSet 
); // C++ only
const wchar_t *wcspbrk(
   const wchar_t *str,
   const wchar_t *strCharSet 
); // C++ only
unsigned char *_mbspbrk(
   const unsigned char *str,
   const unsigned char *strCharSet 
); // C only
unsigned char *_mbspbrk(
   unsigned char *str,
   const unsigned char *strCharSet 
); // C++ only
const unsigned char *_mbspbrk(
   const unsigned char *str,
   const unsigned char *strCharSet 
); // C++ only
unsigned char *_mbspbrk_l(
   const unsigned char *str,
   const unsigned char *strCharSet,
   _locale_t locale
); // C only
unsigned char *_mbspbrk_l(
   unsigned char *str,
   const unsigned char *strCharSet,
   _locale_t locale
); // C++ only
const unsigned char *_mbspbrk_l(
   const unsigned char *str,
   const unsigned char* strCharSet,
   _locale_t locale
); // C++ only

参数

str
以null 终止的搜索字符串。
strCharSet
null 终止的字符集。
locale
要使用的区域设置。

返回值

例如，如果两个字符串实参没有相同的字符，返回指向str中的strCharSet任意字符第一个匹配的指针或 NULL 指针。

备注

strpbrk 函数返回指向str 中出现的第一个匹配项的指针，该指针属于 strCharSet字符集。搜索不包括终止空字符。

wcspbrk 和 _mbspbrk 是宽字符，属于 strpbrk 的多节字字符版本。参数和 wcspbrk 的返回值是宽字符字符串；_mbspbrk 的参数和返回值为多字节字符字符串。

_mbspbrk验证其参数。如果 str 或 strCharSet 为 NULL，则会调用无效参数处理程序，如参数验证中所述。如果允许继续执行， _mbspbrk 返回 NULL并设置errno 为 EINVAL。 strpbrk 和 wcspbrk 不验证其参数。否则这三个函数否则具有相同行为。

_mbspbrk 类似于 _mbscspn，但 _mbspbrk 返回指针而不是类型 size_t的值。

在 C 中，这些函数采用第一个参数的一个 const 指针。在 C++ 中，有两个重载可用。采用指向 const 的指针的重载返回指向 const 的指针；采用指向非const 的版本的指针返回指向非const 的指针。如果这些函数的 const 和非const 版本可用，则会定义宏 _CONST_CORRECT_OVERLOADS。如果这两个 C++ 重载都需要非 const 行为，请定义符号 _CONST_RETURN。

输出值受区域设置的 LC_CTYPE 类别设置影响；有关更多信息，请参见 setlocale。这些不带 _l 后缀的函数的版本使用为该区域设置相关的行为的当前区域设置；带有 _l 后缀的版本相同，只不过它们使用通过的区域设置参数。有关详细信息，请参阅区域设置。

一般文本例程映射

TCHAR.H 例程	未定义 _UNICODE & _MBCS	已定义 _MBCS	已定义 _UNICODE
_tcspbrk	strpbrk	_mbspbrk	wcspbrk
无	无	_mbspbrk_l	无

要求

例程	必需的标头
strpbrk	<string.h>
wcspbrk	<string.h> 或 <wchar.h>
_mbspbrk, _mbspbrk_l	<mbstring.h>

有关兼容性的更多信息，请参见兼容性。

示例

// crt_strpbrk.c

#include <string.h>
#include <stdio.h>

int main( void )
{
   char string[100] = "The 3 men and 2 boys ate 5 pigs\n";
   char *result = NULL;

   // Return pointer to first digit in "string".
   printf( "1: %s\n", string );
   result = strpbrk( string, "0123456789" );
   printf( "2: %s\n", result++ );
   result = strpbrk( result, "0123456789" );
   printf( "3: %s\n", result++ );
   result = strpbrk( result, "0123456789" );
   printf( "4: %s\n", result );
}