# std::strchr

> C++ Atlas: `cppatlas.com/w/cpp/string/byte/strchr` | Source: https://en.cppreference.com/w/cpp/string/byte/strchr | Domain: Strings

Finds the first occurrence of the character static_cast<char>(ch) in the byte string pointed to by str.

## Official Specification Summary (cppreference)

```cpp
// Defined in header <cstring>
const char* strchr( const char* str, int ch );
char* strchr(       char* str, int ch );
```

Finds the first occurrence of the character `static_cast<char>(ch)` in the byte string pointed to by `str`.

The terminating null character is considered to be a part of the string and can be found if searching for `'\0'`.

### Parameters

- `str` - pointer to the null-terminated byte string to be analyzed
- `ch` - character to search for

### Return value

Pointer to the found character in `str`, or a null pointer if no such character is found.

### Example

```cpp
#include <cstring>
#include <iostream>

int main()
{
    const char* str = "Try not. Do, or do not. There is no try.";
    char target = 'T';
    const char* result = str;

    while ((result = std::strchr(result, target)) != nullptr)
    {
        std::cout << "Found '" << target
                  << "' starting at '" << result << "'\n";

        // Increment result, otherwise we'll find target at the same location
        ++result;
    }
}
```

Output:

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

### See also

- [`memchr`](https://en.cppreference.com/w/cpp/string/byte/memchr): searches an array for the first occurrence of a character (function)
- [`find`](https://en.cppreference.com/w/cpp/string/basic_string/find): finds the first occurrence of the given substring (public member function of `std::basic_string<CharT,Traits,Allocator>`)
- [`wcschr`](https://en.cppreference.com/w/cpp/string/wide/wcschr): finds the first occurrence of a wide character in a wide string (function)
- [`strrchr`](https://en.cppreference.com/w/cpp/string/byte/strrchr): finds the last occurrence of a character (function)
- [`strpbrk`](https://en.cppreference.com/w/cpp/string/byte/strpbrk): finds the first location of any character from a set of separators (function)
- [C documentation for `strchr`](https://en.cppreference.com/w/c/string/byte/strchr)

---
Attribution: content from https://en.cppreference.com/w/cpp/string/byte/strchr (cppreference.com), licensed under CC-BY-SA 3.0 and GFDL. Modified: converted to markdown, study notes added. Offline snapshot of 9 February 2025.