# std::strstr

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

Finds the first occurrence of the byte string needle in the byte string pointed to by haystack. The terminating null characters are not compared.

## Official Specification Summary (cppreference)

```cpp
// Defined in header <cstring>
const char* strstr( const char* haystack, const char* needle );
char* strstr(       char* haystack, const char* needle );
```

Finds the first occurrence of the byte string `needle` in the byte string pointed to by `haystack`. The terminating null characters are not compared.

### Parameters

- `haystack` - pointer to the null-terminated byte string to examine
- `needle` - pointer to the null-terminated byte string to search for

### Return value

Pointer to the first character of the found substring in `haystack`, or a null pointer if no such character is found. If `needle` points to an empty string, `haystack` is returned.

### Example

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

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

    for (const char* result = str; (result = std::strstr(result, target)); ++result)
        std::cout << "Found " << std::quoted(target)
                  << " starting at (" << result - str << "): "
                  << std::quoted(result) << '\n';
}
```

Output:

```text
Found "not" starting at (4): "not. Do, or do not. There is no try."
Found "not" starting at (19): "not. There is no try."
```

### See also

- [`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>`)
- [`wcsstr`](https://en.cppreference.com/w/cpp/string/wide/wcsstr): finds the first occurrence of a wide string within another wide string (function)
- [`strchr`](https://en.cppreference.com/w/cpp/string/byte/strchr): finds the first occurrence of a character (function)
- [`strrchr`](https://en.cppreference.com/w/cpp/string/byte/strrchr): finds the last occurrence of a character (function)
- [C documentation for `strstr`](https://en.cppreference.com/w/c/string/byte/strstr)

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