RetroSearch Browse

Home - News ( United States | United Kingdom | Italy | Germany ) - Football scores

Showing content from https://cplusplus.com/reference/string/basic_string/find_first_not_of/ below:

public member function

std::basic_string::find_first_not_of string (1)

size_type find_first_not_of (const basic_string& str, size_type pos = 0) const;

c-string (2)

size_type find_first_not_of (const charT* s, size_type pos = 0) const;

buffer (3)

size_type find_first_not_of (const charT* s, size_type pos, size_type n) const;

character (4)

size_type find_first_not_of (charT c, size_type pos = 0) const;

string (1)

size_type find_first_not_of (const basic_string& str, size_type pos = 0) const noexcept;

c-string (2)

size_type find_first_not_of (const charT* s, size_type pos = 0) const;

buffer (3)

size_type find_first_not_of (const charT* s, size_type pos, size_type n) const;

character (4)

size_type find_first_not_of (charT c, size_type pos = 0) const noexcept;

Find non-matching character in string

Searches the basic_string for the first character that does not match any of the characters specified in its arguments.

When pos is specified, the search only includes characters at or after position pos, ignoring any possible occurrences before that character.

The function uses traits_type::eq to determine character equivalences.

Parameters

str: Another basic_string with the set of characters to be used in the search.
pos: Position of the first character in the string to be considered in the search.
If this is greater than the string length, the function never finds matches.
Note: The first character is denoted by a value of 0 (not 1): A value of 0 means that the entire string is searched.
s: Pointer to an array of characters.
If argument n is specified (3), the first n characters in the array are used in the search.
Otherwise (2), a null-terminated sequence is expected: the length of the sequence with the characters used in the search is determined by the first occurrence of a null character.
n: Number of character values to search for.
c: Individual character to be searched for.

charT is basic_string's character type (i.e., its first template parameter).
Member type size_type is an unsigned integral type.

Return Value The position of the first character that does not match.
If no such characters are found, the function returns basic_string::npos.

Member type size_type is an unsigned integral type.

Example

// string::find_first_not_of
#include <iostream>
#include <string>

int main ()
{
  std::string str ("look for non-alphabetic characters...");

  std::string::size_type found = str.find_first_not_of("abcdefghijklmnopqrstuvwxyz ");

  if (found!=std::string::npos)
  {
    std::cout << "The first non-alphabetic character is " << str[found];
    std::cout << " at position " << found << '\n';
  }

  return 0;
}

The first non-alphabetic character is - at position 12

Complexity Unspecified, but generally up to linear in length()-pos times the number of characters to match (worst case).

Iterator validity No changes.

Data races The object is accessed.

Exception safety If s does not point to an array long enough, it causes undefined behavior.
Otherwise, the function never throws exceptions (no-throw guarantee).

See also

basic_string::find: Find first occurrence in string (public member function)

basic_string::find_first_of: Find character in string (public member function)

basic_string::find_last_not_of: Find non-matching character in string from the end (public member function)

basic_string::replace: Replace portion of string (public member function)

basic_string::substr: Generate substring (public member function)

RetroSearch is an open source project built by @garambo | Open a GitHub Issue

Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo

HTML: 3.2 | Encoding: UTF-8 | Version: 0.7.4