strpbrk, wcspbrk, _mbspbrk, _mbspbrk_l

Сканирует строки на наличие символов в указанных наборах символов.

Важно!

Функции _mbspbrk и _mbspbrk_l не могут использоваться в приложениях, запускаемых в среде выполнения Windows. Дополнительные сведения: Функции CRT, которые не поддерживаются в приложениях универсальной платформы Windows.

Синтаксис

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
Используемый языковой стандарт.

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

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

Замечания

Функция strpbrk возвращает указатель на первое вхождение в str символа из набора символов strCharSet. Поиск не включает завершающийся символ NULL.

Функции 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. Макрос _CRT_CONST_CORRECT_OVERLOADS определяется, если доступны обе const версии этих функций и неconst являются. Если требуется поведение, отличноеconst от обоих перегрузки C++, определите символ _CONST_RETURN.

Выходное значение зависит от параметра LC_CTYPE категории языкового стандарта; дополнительные сведения см. в разделе setlocale. В версиях этих функций без суффикса _l используется текущий языковой стандарт для поведения, которое зависит от языкового стандарта. Версия с суффиксом _l идентична, однако в ней используется языковой стандарт, переданный в качестве параметра. Дополнительные сведения см. в разделе Locale.

По умолчанию глобальное состояние этой функции ограничивается приложением. Чтобы изменить это поведение, см . статью "Глобальное состояние" в CRT.

Сопоставления подпрограмм универсального текста

Подпрограмма 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 );
}

1: The 3 men and 2 boys ate 5 pigs

2: 3 men and 2 boys ate 5 pigs

3: 2 boys ate 5 pigs

4: 5 pigs

См. также

Обработка строк
Локаль
Интерпретация последовательностей многобайтовых символов
strcspn, wcscspn, _mbscspn, _mbscspn_l
strchr, wcschr, _mbschr, _mbschr_l
strrchr, wcsrchr, _mbsrchr, _mbsrchr_l