21 Strings library [strings]

21.3 String classes [string.classes]

21.3.1 Class template basic_string [basic.string]

21.3.1.7 basic_string string operations [string.ops]

21.3.1.7.2 basic_string::find [string.find]

size_type find(basic_string_view<charT, traits> sv, size_type pos = 0) const noexcept;

1

Effects: Determines the lowest position xpos, if possible, such that both of the following conditions hold:

  • (1.1)

    pos <= xpos and xpos + sv.size() <= size();

  • (1.2)

    traits::eq(at(xpos + I), sv.at(I)) for all elements I of the data referenced by sv.

2

Returns: xpos if the function can determine such a value for xpos. Otherwise, returns npos.

3

Remarks: Uses traits::eq().

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

4

Effects: Equivalent to: return find(basic_string_view<charT, traits>(str), pos);

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

5

Returns: find(basic_string_view<charT, traits>(s, n), pos).

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

6

Requires: s points to an array of at least traits::length(s) + 1 elements of charT.

7

Returns: find(basic_string_view<charT, traits>(s), pos).

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

8

Returns: find(basic_string(1, c), pos).