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

部分文字列のビューを返します [ pos , pos + rlen ) 。ここで rlen は count と size ( ) - pos の小さい方の値です。

パラメータ

戻り値

部分文字列のビュー [ pos , pos + rlen ) 。

例外

std::out_of_range pos が 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)

関連項目