Spec-Zone.ru › C++

std::basic_string_view<CharT,Traits>::substr

constexpr basic_string_view substr( size_type pos = 0,
                                    size_type count = npos ) const;
(начиная с C++17)

Возвращает представление подстроки [pos, pos + rlen), где rlen — меньшее из count и size() - pos.

Параметры

pos - позиция первого символа
count - запрошенная длина

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

Представление подстроки [pos, pos + rlen).

Исключения

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

Сложность

Константная.

Пример

#include <cstddef>
#include <iostream>
#include <stdexcept>
#include <string_view>

int main()
{
    typedef std::size_t count_t, pos_t;

    constexpr std::string_view data{"ABCDEF"};

    std::cout << data.substr() << '\n'; // ABCDEF, i.e. data[0, 5] that is [0, 6)
    std::cout << data.substr(pos_t(1)) << '\n'; // BCDEF, i.e. [1, 6)
    std::cout << data.substr(pos_t(2), count_t(3)) << '\n'; // CDE, i.e. [2, 2 + 3)
    std::cout << data.substr(pos_t(4), count_t(42)) << '\n'; // EF, i.e. [4, 6)

    try
    {
        [[maybe_unused]]
        auto sub = data.substr(pos_t(666), count_t(1)); // throws: pos > size()
    }
    catch (std::out_of_range const& ex)
    {
        std::cout << ex.what() << '\n';
    }
}

Возможный вывод:

ABCDEF
BCDEF
CDE
EF
basic_string_view::substr: __pos (which is 666) > __size (which is 6)

См. также

subview
(C++26)
возвращает подставление
(открытая функция-член)
copy
копирует символы
(открытая функция-член)
find
ищет символы в представлении
(открытая функция-член)
substr
возвращает подстроку
(открытая функция-член std::basic_string<CharT,Traits,Allocator>)

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/cpp/string/basic_string_view/substr

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API