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

Возвращает подстроку [ pos , pos + count ) . Если запрашиваемая подстрока выходит за пределы строки, т.е. count больше чем size ( ) - pos (например, если count == npos ), возвращаемая подстрока будет [ pos , size() ) .

Параметры

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

Строка, содержащая подстроку [ pos , pos + count ) или [ pos , size() ) .

Исключения

std::out_of_range если pos > size ( ) .

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

Сложность

Линейно по count .

Примечания

Аллокатор возвращаемой строки создаётся конструктором по умолчанию: новый аллокатор может не быть копией get_allocator() .

Пример

#include <iostream>
#include <string>
int main()
{
    std::string a = "0123456789abcdefghij";
    // count is npos, returns [pos, size())
    std::string sub1 = a.substr(10);
    std::cout << sub1 << '\n';
    // both pos and pos + count are within bounds, returns [pos, pos + count)
    std::string sub2 = a.substr(5, 3);
    std::cout << sub2 << '\n';
    // pos is within bounds, pos + count is not, returns [pos, size())
    std::string sub4 = a.substr(a.size() - 3, 50);
    // this is effectively equivalent to
    // std::string sub4 = a.substr(17, 3);
    // since a.size() == 20, pos == a.size() - 3 == 17, and a.size() - pos == 3
    std::cout << sub4 << '\n';
    try
    {
        // pos is out of bounds, throws
        std::string sub5 = a.substr(a.size() + 3, 50);
        std::cout << sub5 << '\n';
    }
    catch (const std::out_of_range& ex)
    {
        std::cout << ex.what() << '\n';
    }
}

abcdefghij
567
hij
basic_string::substr: __pos (which is 23) > this->size() (which is 20)

Отчеты о дефектах

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

Смотрите также