Namespaces
Variants

strchr

From cppreference.net
< c ‎ | string ‎ | byte
C
Strings library
Null-terminated byte strings
Functions
Character manipulation
Conversions to and from numeric formats
String manipulation
String examination
Memory manipulation
Miscellaneous
(C11) (C11)
Определено в заголовочном файле <string.h>
char * strchr ( const char * str, int ch ) ;
(1)
/*QChar*/ * strchr ( /*QChar*/ * str, int ch ) ;
(2) (since C23)
1) Находит первое вхождение символа ch (после преобразования в char как если бы с помощью ( char ) ch ) в строке байтов с завершающим нулем, на которую указывает str (каждый символ интерпретируется как unsigned char ). Завершающий нулевой символ считается частью строки и может быть найден при поиске ' \0 ' .
2) Обобщённая типонезависимая функция, эквивалентная (1) . Пусть T будет неквалифицированным символьным типом объекта.
  • Если str имеет тип const T * , то возвращаемый тип будет const char * .
  • Иначе, если str имеет тип T * , то возвращаемый тип будет char * .
  • В противном случае поведение не определено.
Если макросное определение каждой из этих обобщённых функций подавлено для доступа к реальной функции (например, если используется ( strchr ) или указатель на функцию), становится видимым объявление реальной функции (1) .

Поведение не определено, если str не является указателем на байтовую строку, завершающуюся нулевым символом.

Содержание

Параметры

str - указатель на анализируемую нуль-терминированную байтовую строку
ch - символ для поиска

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

Указатель на найденный символ в str , или нулевой указатель, если такой символ не найден.

Пример

Запустить этот код 
#include <stdio.h>
#include <string.h>
int main(void)
{
    const char *str = "Try not. Do, or do not. There is no try.";
    char target = 'T';
    const char* result = str;
    while((result = strchr(result, target)) != NULL)
    {
        printf("Found '%c' starting at '%s'\n", target, result);
        ++result; // Increment result, otherwise we'll find target at the same location
    }
}

Вывод: 

Found 'T' starting at 'Try not. Do, or do not. There is no try.'
Found 'T' starting at 'There is no try.'

Ссылки

  • Стандарт C23 (ISO/IEC 9899:2024):
  • 7.24.5.2 Функция strchr (стр: TBD)
  • Стандарт C17 (ISO/IEC 9899:2018):
  • 7.24.5.2 Функция strchr (стр.: TBD)
  • Стандарт C11 (ISO/IEC 9899:2011):
  • 7.24.5.2 Функция strchr (стр: 367-368)
  • Стандарт C99 (ISO/IEC 9899:1999):
  • 7.21.5.2 Функция strchr (стр: 330)
  • Стандарт C89/C90 (ISO/IEC 9899:1990):
  • 4.11.5.2 Функция strchr

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

выполняет поиск первого вхождения символа в массиве
(функция)
находит последнее вхождение символа
(функция)
находит первое вхождение любого символа из одной строки в другой строке
(функция)
C++ documentation для strchr