std::get(std::span)

 

C++

Language

Standard Library Headers

Freestanding and hosted implementations

Named requirements

Language support library

Concepts library (C++20)

Diagnostics library

Utilities library

Strings library

Containers library

Iterators library

Ranges library (C++20)

Algorithms library

Numerics library

Input/output library

Localizations library

Regular expressions library (C++11)

Atomic operations library (C++11)

Thread support library (C++11)

Filesystem library (C++17)

Technical Specifications

 

Containers library

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

Member functions

span::span

span::operator=

Element access

span::front

span::back

span::operator[]

span::data

Iterators

span::beginspan::cbegin

span::endspan::cend

span::rbeginspan::crbegin

span::rendspan::crend

Observers

span::empty

span::size

span::size_bytes

Subviews

span::first

span::last

span::subspan

Non-member functions

as_bytesas_writable_bytes

begin(std::span)end(std::span)

get

Non-member constant

dynamic_extent

Helper classes

tuple_size

tuple_element

Deduction guides

 

template< std::size_t I, class T, std::size_t N > constexpr T& get( std::span<T,N> s ) noexcept;		(since C++20)

Obtains a reference to the Ith element of the span s.

The span must have static extent (i.e., N != std::dynamic_extent) and I must be an integer value in range [0, N). This is enforced at compile time as opposed to operator[].

Parameters

s

-

span whose contents to extract

Return value

A reference to the Ith element of s.

Complexity

Constant.

See also

operator[]	accesses an element of the sequence (public member function)
std::get(std::tuple)	tuple accesses specified element (function template)
std::get(std::pair) (C++11)	accesses an element of a pair (function template)
std::get(std::variant) (C++17)	reads the value of the variant given the index or the type (if the type is unique), throws on error (function template)