# std::strpbrk

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

Scans the null-terminated byte string pointed to by dest for any character from the null-terminated byte string pointed to by breakset, and returns a pointer to that character.

## Official Specification Summary (cppreference)

```cpp
// Defined in header <cstring>
const char* strpbrk( const char* dest, const char* breakset );
char* strpbrk(       char* dest, const char* breakset );
```

Scans the null-terminated byte string pointed to by `dest` for any character from the null-terminated byte string pointed to by `breakset`, and returns a pointer to that character.

### Parameters

- `dest` - pointer to the null-terminated byte string to be analyzed
- `breakset` - pointer to the null-terminated byte string that contains the characters to search for

### Return value

Pointer to the first character in `dest`, that is also in `breakset`, or null pointer if no such character exists.

### Notes

The name stands for "string pointer break", because it returns a pointer to the first of the separator ("break") characters.

### Example

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

int main()
{
    const char* str = "hello world, friend of mine!";
    const char* sep = " ,!";

    unsigned int cnt = 0;
    do
    {
        str = std::strpbrk(str, sep); // find separator
        std::cout << std::quoted(str) << '\n';
        if (str)
            str += std::strspn(str, sep); // skip separator
        ++cnt; // increment word count
    } while (str && *str);

    std::cout << "There are " << cnt << " words\n";
}
```

Output:

```text
" world, friend of mine!"
", friend of mine!"
" of mine!"
" mine!"
"!"
There are 5 words
```

### See also

- [`strcspn`](https://en.cppreference.com/w/cpp/string/byte/strcspn): returns the length of the maximum initial segment that consists of only the characters not found in another byte string (function)
- [`strtok`](https://en.cppreference.com/w/cpp/string/byte/strtok): finds the next token in a byte string (function)
- [`strchr`](https://en.cppreference.com/w/cpp/string/byte/strchr): finds the first occurrence of a character (function)
- [`wcspbrk`](https://en.cppreference.com/w/cpp/string/wide/wcspbrk): finds the first location of any wide character in one wide string, in another wide string (function)
- [C documentation for `strpbrk`](https://en.cppreference.com/w/c/string/byte/strpbrk)

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