std::basic_string<CharT,Traits,Allocator>::find

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

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

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

size_type find( const CharT* s, size_type pos, size_type count ) const;

constexpr size_type find( const CharT* s,
                          size_type pos, size_type count ) const;

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

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

size_type find( CharT ch, size_type pos = 0 ) const;

size_type find( CharT ch, size_type pos = 0 ) const noexcept;

constexpr size_type find( CharT ch, size_type pos = 0 ) const noexcept;

template< class StringViewLike >
size_type find( const StringViewLike& t,
                size_type pos = 0 ) const noexcept(/* see below */);

template< class StringViewLike >
constexpr size_type find( const StringViewLike& t,
                          size_type pos = 0 ) const noexcept(/* see below */);

Находит первую подстроку, равную заданной последовательности символов. Поиск начинается с pos, т.е. найденная подстрока не должна начинаться в позиции, предшествующей pos.

Формально, подстрока str считается найденной в позиции xpos, если все нижеперечисленное верно:

• xpos >= pos
• xpos + str.size() <= size()
• для всех позиций n в str, Traits::eq(at(xpos + n), str.at(n)).

В частности, это подразумевает, что

• подстрока может быть найдена только если pos <= size() - str.size()
• пустая подстрока находится в позиции pos тогда и только тогда, когда pos <= size()
• для непустой подстроки, если pos >= size(), функция всегда возвращает npos.

Параметры

Возвращаемое значение

Позиция первого символа найденной подстроки или npos, если такая подстрока не найдена.

Исключения

Если по какой-либо причине выбрасывается исключение, эта функция не имеет эффекта (гарантия сильной безопасности исключений).

Пример

#include <iomanip>
#include <iostream>
#include <string>
 
void print(int id, std::string::size_type n, std::string const& s)
{
    std::cout << id << ") ";
    if (std::string::npos == n)
        std::cout << "not found! n == npos\n";
    else
        std::cout << "found @ n = " << n << ", substr(" << n << ") = "
                  << std::quoted(s.substr(n)) << '\n';
}
 
int main()
{
    std::string::size_type n;
    std::string const s = "This is a string"; /*
                             ^  ^  ^
                             1  2  3          */
 
    // search from beginning of string
    n = s.find("is");
    print(1, n, s);
 
    // search from position 5
    n = s.find("is", 5);
    print(2, n, s);
 
    // find a single character
    n = s.find('a');
    print(3, n, s);
 
    // find a single character
    n = s.find('q');
    print(4, n, s);
}

1) found @ n = 2, substr(2) = "is is a string"
2) found @ n = 5, substr(5) = "is a string"
3) found @ n = 8, substr(8) = "a string"
4) not found! n == npos

Отчеты об ошибках

Следующие отчеты об ошибках, изменяющие поведение, были применены ретроактивно к ранее опубликованным стандартам C++.

См. также