strrchr, wcsrchr, _mbsrchr, _mbsrchr_l

Статья
04/10/2013

Выберите строку для последнего вхождения знака.

Важно
_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 идентичны, за исключением того, что они используют переданный параметр языкового стандарта.Для получения дополнительной информации см. Языковой стандарт.

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