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

 

C++

言語

標準ライブラリヘッダ

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

名前付き要件

言語サポートライブラリ

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

診断ライブラリ

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

文字列ライブラリ

コンテナライブラリ

イテレータライブラリ

範囲ライブラリ(C++20)

アルゴリズムライブラリ

数値演算ライブラリ

ローカライゼーションライブラリ

入出力ライブラリ

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

正規表現ライブラリ(C++11)

アトミック操作ライブラリ(C++11)

スレッドサポートライブラリ(C++11)

技術仕様書

 

コンテナライブラリ

array (C++11)

vector

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

span (C++20)

 

std::span

メンバ関数

span::span

span::operator=

要素アクセス

span::front

span::back

span::operator[]

span::data

イテレータ

span::begin

span::end

span::rbegin

span::rend

観察

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)
constexpr std::span<element_type, std::dynamic_extent>     subspan(std::size_t Offset,              std::size_t Count = std::dynamic_extent)const;	(2)

このスパンのオフセット Offset から始まる Count 個の要素に対するビューとなるスパンを取得します。 Count が std::dynamic_extent の場合、サブスパンの要素数は size() - offset です (*this の終端が終端になります)。

Offset または Count が範囲外の場合、動作は未定義です。 これは以下の場合に発生します。

• Offset が size() より大きい。
• Count が std::dynamic_extent でなく、 Offset + Count が size() より大きい。

(1) によって返されるスパンのエクステント E は以下のように決定されます。

• Count が std::dynamic_extent でなければ、 Count
• そうでなく、 Extent が std::dynamic_extent でなければ、 Extent - Offset
• そうでなければ、 std::dynamic_extent

戻り値

r.data()== this->data()+ Offset であるような、要求されたサブスパン r。 Count が std::dynamic_extent の場合、 r.size()== this->size()- Offset です。 そうでなければ、 r.size()== Count です。

関連項目

first	シーケンスの最初の N 個の要素から構成されるサブスパンを取得します (パブリックメンバ関数)
last	シーケンスの最後の N 個の要素から構成されるサブスパンを取得します (パブリックメンバ関数)