strrchr, wcsrchr, _mbsrchr, _mbsrchr_l

Статья
06/09/2015

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

Важно!

_mbsrchr и _mbsrchr_l невозможно использовать в приложениях, запускаемых в среде выполнения Windows.Дополнительные сведения см. в статье Функции CRT, которые не поддерживаются с ключом /ZW.

char *strrchr(
   const char *str,
   int c 
); // C only
char *strrchr(
   char *str,
   int c 
); // C++ only
const char *strrchr(
   const char *str,
   int c 
); // C++ only
wchar_t *wcsrchr(
   const wchar_t *str,
   wchar_t c 
); // C only
wchar_t *wcsrchr(
   wchar_t *str,
   wchar_t c 
); // C++ only
const wchar_t *wcsrchr(
   const wchar_t *str,
   wchar_t c 
); // C++ only
unsigned char *_mbsrchr(
   const unsigned char *str,
   unsigned int c 
); // C only
unsigned char *_mbsrchr(
   unsigned char *str,
   unsigned int c 
); // C++ only
const unsigned char *_mbsrchr(
   const unsigned char *str,
   unsigned int c 
); // C++ only
unsigned char *_mbsrchr_l(
   const unsigned char *str,
   unsigned int c,
   _locale_t locale
); // C only
unsigned char *_mbsrchr_l(
   unsigned char *str,
   unsigned int c,
   _locale_t locale
); // C++ only
const unsigned char *_mbsrchr_l(
   const unsigned char *str,
   unsigned int c,
   _locale_t locale
); // C++ only

Параметры

str
Строка, заканчивающаяся нулевым символом, в которой будет производиться поиск.
c
Символ, который требуется найти.
locale
Языковой стандарт, который необходимо использовать.

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

Возвращает указатель на последнее вхождение c в str или NULL , если c не найден.

Заметки

Функция strrchr находит последнее вхождение c (преобразованного к char) в str. Поиск включает конечный нуль-символ.

wcsrchr и _mbsrchr — двубайтовая и многобайтовая символьные версии strrchr. Аргументы и возвращаемое значение функции wcsrchr представляют собой строки расширенных символов; аргументы и возвращаемое значение функции _mbsrchr представляют собой строки многобайтовых символов.

В языке C эти функции принимают указатель const для первого аргумента. В языке C++ доступны две перегрузки. Перегрузка, принимающая указатель на const, возвращает указатель на const; версия, которая принимает указатель на не являющийся const, возвращает указатель на не const. Макрос _CONST_CORRECT_OVERLOADS определен, если доступны и const и не const версии этих функций. Если требуется не const функциональность для обеих перегрузок C++, укажите символ _CONST_RETURN.

_mbsrchr проверяет свои параметры. Если параметр str имеет значение NULL, вызывается обработчик недопустимого параметра, как описано в разделе Проверка параметров. Если продолжение выполнения разрешено, errno устанавливается в значение EINVAL , и _mbsrchr возвращает 0. strrchr и wcsrchr не проверяют свои параметры. В остальных случаях эти три функции ведут себя идентично.

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

Универсальное текстовое сопоставление функций