標準ライブラリヘッダ <span>
提供: cppreference.com
このヘッダはコンテナライブラリの一部です。
クラス | ||
(C++20) | オブジェクトの隣接したシーケンスに対する非所有ビュー (クラステンプレート) | |
定数 | ||
(C++20) | span が動的エクステントを持つことを表す size_t 型の定数 (定数) | |
関数 | ||
span をそのベースとなるバイト列のビューに変換します (関数テンプレート) | ||
範囲アクセス | ||
(C++11)(C++14) | コンテナまたは配列の先頭を指すイテレータを返します (関数) | |
(C++11)(C++14) | コンテナまたは配列の終端を指すイテレータを返します (関数) | |
(C++14) | コンテナまたは配列の先頭を指す逆イテレータを返します (関数) | |
(C++14) | コンテナまたは配列の終端を指す逆イテレータを返します (関数) | |
(C++17)(C++20) | コンテナまたは配列のサイズを返します (関数テンプレート) | |
(C++17) | コンテナが空かどうか調べます (関数) | |
(C++17) | ベースとなる配列を指すポインタを取得します (関数) |
[編集]概要
namespace std {// constantsinlineconstexpr size_t dynamic_extent = numeric_limits<size_t>::max(); // class template spantemplate<class ElementType, size_t Extent = dynamic_extent>class span; template<class ElementType, size_t Extent>inlineconstexprbool ranges::enable_borrowed_range<span<ElementType, Extent>>=true; // views of object representationtemplate<class ElementType, size_t Extent> span<const byte, Extent == dynamic_extent ? dynamic_extent : sizeof(ElementType)* Extent> as_bytes(span<ElementType, Extent> s)noexcept; template<class ElementType, size_t Extent> span<byte, Extent == dynamic_extent ? dynamic_extent : sizeof(ElementType)* Extent> as_writable_bytes(span<ElementType, Extent> s)noexcept;}
[編集]クラステンプレート std::span
namespace std {template<class ElementType, size_t Extent = dynamic_extent>class span {public:// constants and typesusing element_type = ElementType;using value_type = remove_cv_t<ElementType>;using size_type = size_t;using difference_type = ptrdiff_t;using pointer = element_type*;using const_pointer =const element_type*;using reference = element_type&;using const_reference =const element_type&;using iterator =/* implementation-defined */;using reverse_iterator =std::reverse_iterator<iterator>;staticconstexpr size_type extent = Extent; // constructors, copy, and assignmentconstexpr span()noexcept;template<class It>constexprexplicit(extent != dynamic_extent) span(It first, size_type count);template<class It, class End>constexprexplicit(extent != dynamic_extent) span(It first, End last);template<size_t N>constexpr span(type_identity_t<element_type>(&arr)[N])noexcept;template<class T, size_t N>constexpr span(array<T, N>& arr)noexcept;template<class T, size_t N>constexpr span(const array<T, N>& arr)noexcept;template<class R>constexprexplicit(extent != dynamic_extent) span(R&& r);constexpr span(const span& other)noexcept=default;template<class OtherElementType, size_t OtherExtent>constexprexplicit(/* see description */) span(const span<OtherElementType, OtherExtent>& s)noexcept; ~span()noexcept=default; constexpr span& operator=(const span& other)noexcept=default; // subviewstemplate<size_t Count>constexpr span<element_type, Count> first()const;template<size_t Count>constexpr span<element_type, Count> last()const;template<size_t Offset, size_t Count = dynamic_extent>constexpr span<element_type, /* see description */> subspan()const; constexpr span<element_type, dynamic_extent> first(size_type count)const;constexpr span<element_type, dynamic_extent> last(size_type count)const;constexpr span<element_type, dynamic_extent> subspan( size_type offset, size_type count = dynamic_extent)const; // observersconstexpr size_type size()constnoexcept;constexpr size_type size_bytes()constnoexcept;[[nodiscard]]constexprbool empty()constnoexcept; // element accessconstexpr reference operator[](size_type idx)const;constexpr reference front()const;constexpr reference back()const;constexpr pointer data()constnoexcept; // iterator supportconstexpr iterator begin()constnoexcept;constexpr iterator end()constnoexcept;constexpr reverse_iterator rbegin()constnoexcept;constexpr reverse_iterator rend()constnoexcept; private: pointer data_;// exposition only size_type size_;// exposition only}; template<class It, class EndOrSize> span(It, EndOrSize)-> span<remove_reference_t<iter_reference_t<It>>>;template<class T, size_t N> span(T (&)[N])-> span<T, N>;template<class T, size_t N> span(array<T, N>&)-> span<T, N>;template<class T, size_t N> span(const array<T, N>&)-> span<const T, N>;template<class R> span(R&&)-> span<remove_reference_t<ranges::range_reference_t<R>>>;}