strpbrk, wcspbrk, _mbspbrk, _mbspbrk_l

Статья
04/10/2013

Строки сканирования для символов в различных кодировках.

Важно
_mbspbrk и _mbspbrk_l нельзя использовать в приложениях, выполняемых в среды выполнения Windows.Дополнительные сведения см. в разделе Функции 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
Объединения завершенная, входная строка.
strCharSet
Объединения завершенной кодировка.
locale
Языковой стандарт, который необходимо использовать.

Возвращаемое значение

Возвращает указатель на первый вхождению любого символа из strCharSet в str или NULL, если указатель 2 строкового аргумента не имеют символы в общем.

Заметки

Функция 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_CORRECT_OVERLOADS определен, если доступны и const и не const версии этих функций.Если требуется не const функциональность для обеих перегрузок C++, укажите символ _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 );
}