std::span<T,Extent>::subspan

 

C++

コンパイラサポート

フリースタンディングとホスト

言語

標準ライブラリ

標準ライブラリヘッダー

名前付き要件

機能テストマクロ (C++20)

言語サポートライブラリ

コンセプトライブラリ (C++20)

診断ライブラリ

メモリ管理ライブラリ

メタプログラミングライブラリ (C++11)

汎用ユーティリティライブラリ

コンテナライブラリ

イテレータライブラリ

Rangesライブラリ (C++20)

アルゴリズムライブラリ

文字列ライブラリ

テキスト処理ライブラリ

数値ライブラリ

日付と時刻ライブラリ

入出力ライブラリ

ファイルシステムライブラリ (C++17)

並行サポートライブラリ (C++11)

実行制御ライブラリ (C++26)

Technical specifications (技術仕様)

シンボルインデックス

外部ライブラリ

 

コンテナライブラリ

シーケンス

array (C++11)

vector

vector<bool>

inplace_vector (C++26)

hive (C++26)

deque

forward_list (C++11)

list

連想

set

multiset

map

multimap

非順序連想

unordered_set (C++11)

unordered_multiset (C++11)

unordered_map (C++11)

unordered_multimap (C++11)

アダプタ

stack

queue

priority_queue

flat_set (C++23)

flat_multiset (C++23)

flat_map (C++23)

flat_multimap (C++23)

表示

span (C++20)

mdspan (C++23)

表

イテレータの無効化

メンバ関数テーブル

非メンバ関数テーブル

 

std::span

メンバ関数

span::span

span::operator=

要素アクセス

span::front

span::back

span::at (C++26)

span::operator[]

span::data

イテレータ

span::beginspan::cbegin (C++23)

span::endspan::cend (C++23)

span::rbeginspan::crbegin (C++23)

span::rendspan::crend (C++23)

監視

span::empty

span::size

span::size_bytes

サブビュー

span::first

span::last

span::subspan

非メンバ関数

as_bytesas_writable_bytes

非メンバ定数

dynamic_extent

推論補助

 

template< std::size_t Offset,           std::size_t Count = std::dynamic_extent > constexpr std::span<element_type, E /* see below */>     subspan() const;	(1)	(C++20以降)
constexpr std::span<element_type, std::dynamic_extent>     subspan( size_type Offset,              size_type Count = std::dynamic_extent ) const;	(2)	(C++20以降)

このspanのオフセット Offset から始まる Count 個の要素に対するビューとなるspanを取得します。Count が std::dynamic_extent の場合、subspanの要素数は size() - offset となります（つまり、*this の末尾までとなります）。

1) 次のいずれかの場合、ill-formed（コンパイルエラー）となります。

• Offset が Extent より大きい場合、または
• Count が std::dynamic_extent ではなく、かつ Count が Extent - Offset より大きい場合。

Offset または Count が範囲外の場合、未定義の動作となります。これは次の場合に発生します。

• Offset が size() より大きい場合、または
• Count が std::dynamic_extent ではなく、かつ Count が size() - Offset より大きい場合。

subspan() const; によって返されるspanのextent `E` は次のように決定されます。

• Count が std::dynamic_extent でない場合： Count。
• それ以外の場合で、`Extent` が std::dynamic_extent でない場合： Extent - Offset。
• それ以外の場合： std::dynamic_extent。

Return value

r.data() == this->data() + Offset となるような、要求されたsubspan `r` を返します。Count が std::dynamic_extent の場合、r.size() == this->size() - Offset となります。それ以外の場合は、r.size() == Count となります。

Example

このコードを実行

#include <algorithm>
#include <cstdio>
#include <numeric>
#include <ranges>
#include <span>
 
void display(std::span<const char> abc)
{
    const auto columns{20U};
    const auto rows{abc.size() - columns + 1};
 
    for (auto offset{0U}; offset < rows; ++offset)
    {
        std::ranges::for_each(abc.subspan(offset, columns), std::putchar);
        std::putchar('\n');
    }
}
 
int main()
{
    char abc[26];
    std::iota(std::begin(abc), std::end(abc), 'A');
    display(abc);
}

出力

ABCDEFGHIJKLMNOPQRST
BCDEFGHIJKLMNOPQRSTU
CDEFGHIJKLMNOPQRSTUV
DEFGHIJKLMNOPQRSTUVW
EFGHIJKLMNOPQRSTUVWX
FGHIJKLMNOPQRSTUVWXY
GHIJKLMNOPQRSTUVWXYZ

See also

first	シーケンスの最初の N 個の要素からなるサブスパンを取得します (public member function)
最後	シーケンスの最後の N 個の要素からなるサブスパンを取得します (public member function)