20 Strings library [strings]

20.3 String classes [string.classes]

20.3.2 Class template basic_­string [basic.string]

20.3.2.7 String operations [string.ops]

20.3.2.7.2 basic_­string​::​find [string.find]

🔗
template<class T> size_type find(const T& t, size_type pos = 0) const;
1
#
Effects: Creates a variable, sv, as if by basic_­string_­view<charT, traits> sv = t; and then 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: This function shall not participate in overload resolution unless is_­convertible_­v<const T&, basic_­string_­view<charT, traits>> is true and is_­convertible_­v<const T&, const charT*> is false.
4
#
Throws: Nothing unless the initialization of sv throws an exception.
🔗
size_type find(const basic_string& str, size_type pos = 0) const noexcept;
5
#
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;
6
#
Returns: find(basic_­string_­view<charT, traits>(s, n), pos).
🔗
size_type find(const charT* s, size_type pos = 0) const;
7
#
Requires: s points to an array of at least traits​::​length(s) + 1 elements of charT.
8
#
Returns: find(basic_­string_­view<charT, traits>(s), pos).
🔗
size_type find(charT c, size_type pos = 0) const;
9
#
Returns: find(basic_­string(1, c), pos).