Namespaces
Variants

wmemchr

From cppreference.net
< c ‎ | string ‎ | wide
C
Strings library
Null-terminated wide strings
Определено в заголовочном файле <wchar.h>
wchar_t * wmemchr ( const wchar_t * ptr, wchar_t ch, size_t count ) ;
(1) (начиная с C95)
/*QWchar_t*/ * wmemchr ( /*Qwchar_t*/ * ptr, wchar_t ch, size_t count ) ;
(2) (начиная с C23)
1) Находит первое вхождение широкого символа ch в начальных count широких символах массива широких символов или массива целых чисел совместимого типа, на который указывает ptr .
2) Обобщённая по типам функция, эквивалентная (1) . Пусть T будет неуточнённым объектным типом широкого символа.
  • Если ptr имеет тип const T * , возвращаемый тип будет const wchar_t * .
  • Иначе, если ptr имеет тип T * , возвращаемый тип будет wchar_t * .
  • В противном случае поведение не определено.
Если макросное определение каждой из этих обобщённых функций подавлено для доступа к реальной функции (например, если используется ( wmemchr ) или указатель на функцию), становится видимым объявление реальной функции (1) .

Если count равен нулю, функция возвращает нулевой указатель.

Содержание

Параметры

ptr - указатель на массив широких символов для проверки
ch - широкий символ для поиска
count - количество проверяемых широких символов

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

Указатель на местоположение широкого символа или нулевой указатель, если такой символ не найден.

Пример

Запустить этот код 
#include <locale.h>
#include <stdio.h>
#include <wchar.h>
int main(void)
{
    wchar_t str[] = L"诺不轻信，故人不负我\0诺不轻许，故我不负人。";
    size_t sz = sizeof str / sizeof *str;
    wchar_t target = L'许';
    wchar_t* result = wmemchr(str, target, sz);
    if (result)
    {
        setlocale(LC_ALL, "en_US.utf8");
        printf("Found '%lc' at position %td\n",target, result - str);
    }
}

Возможный вывод: 

Found '许' at position 14

Ссылки

  • Стандарт C23 (ISO/IEC 9899:2024):
  • 7.29.4.5.8 Функция wmemchr (стр.: TBD)
  • Стандарт C17 (ISO/IEC 9899:2018):
  • 7.29.4.5.8 Функция wmemchr (стр.: TBD)
  • Стандарт C11 (ISO/IEC 9899:2011):
  • 7.29.4.5.8 Функция wmemchr (стр: 438)
  • Стандарт C99 (ISO/IEC 9899:1999):
  • 7.24.4.5.8 Функция wmemchr (стр: 384)

Смотрите также

выполняет поиск первого вхождения символа в массиве
(функция)
(C95)
находит первое вхождение широкого символа в широкой строке
(функция)
Документация C++ для wmemchr