# std::basic_string::find_first_not_of

From cppreference.com
< cpp‎ | string‎ | basic string

size_type find_first_not_of( const basic_string& str, size_type pos = 0 ) const; | (1) |
size_type find_first_not_of( const CharT* s, size_type pos, size_type count ) const; | (2) |
size_type find_first_not_of( const CharT* s, size_type pos = 0 ) const; | (3) |
size_type find_first_not_of( CharT ch, size_type pos = 0 ) const; | (4) |
size_type find_first_not_of( std::basic_string_view<CharT, Traits> sv, size_type pos = 0) const | (5) | (since C++17)

Finds the first character equal to none of the characters in the given character sequence. The search considers only the interval [`pos`, size()). If the character is not present in the interval, npos will be returned.

1) Finds the first character equal to none of characters in `str`.
2) Finds the first character equal to none of characters in the first `count` characters of the character string pointed to by `s`. `s` can include null characters.
3) Finds the first character equal to none of characters in character string pointed to by `s`. The length of the string is determined by the first null character.
4) Finds the first character not equal to `ch`.
5) Finds the first character equal to none of characters in `sv`.

In all cases, equality is checked by calling `Traits::eq`.

### Parameters

str | - | string identifying characters to search for
pos | - | position for the seach to start from
count | - | length of character string identifying characters to search for
s | - | pointer to a character string identifying characters to search for
ch | - | character identifying characters to search for
sv | - | std::basic_string_view identifying the characters to search for

### Return value

Position of the found character or npos if no such character is found.

### Exceptions

1-4) (none) | (until C++11)
1,4) `noexcept` specification: noexcept 2,3) (none) | (since C++11) (until C++14)
1) `noexcept` specification: noexcept 2,3,4) (none) | (since C++14)
5) `noexcept` specification: noexcept | (since C++17)

### Example

Run this code

    #include <string>
    #include <iostream>

    int main() {
        std::string to_search = "Some data with %MACROS to substitute";

        std::cout << "Before: " << to_search << '\n';

        auto pos = std::string::npos;
        while ((pos = to_search.find('%')) != std::string::npos) {
            // Permit uppercase letters, lowercase letters and numbers in macro names
            const auto after = to_search.find_first_not_of("ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789", pos + 1);

            // Now to_search[pos] == '%' and to_search[after] == ' ' (after the 'S')

            if(after != std::string::npos)
                to_search.replace(pos, after - pos, "some very nice macros");
        }

        std::cout << "After: " << to_search << '\n';
    }

Output:

    Before: Some data with %MACROS to substitute
    After: Some data with some very nice macros to substitute

### See also

find | find characters in the string (public member function)
rfind | find the last occurrence of a substring (public member function)
find_first_of | find first occurrence of characters (public member function)
find_last_of | find last occurrence of characters (public member function)
find_last_not_of | find last absence of characters (public member function)

Retrieved from "http://en.cppreference.com/mwiki/index.php?title=cpp/string/basic_string/find_first_not_of&oldid=91339"
Category:

- unconditionally noexcept

Hidden categories:

- Pages with unreviewed unconditional noexcept template
- Pages with unreviewed noexcept template