std::mdspan<T,Extents,LayoutPolicy,AccessorPolicy>::operator[]

 

C++

Compiler-Unterstützung

Freestanding und gehostet

Sprache

Standardbibliothek

Header der Standardbibliothek

Benannte Anforderungen

Feature-Test-Makros (C++20)

Bibliothek für Sprachunterstützung

Konzepte-Bibliothek (C++20)

Diagnostik-Bibliothek

Speicherverwaltungsbibliothek

Metaprogrammierungsbibliothek (C++11)

Allgemeine Dienstprogramme-Bibliothek

Container-Bibliothek

Iterator-Bibliothek

Ranges-Bibliothek (C++20)

Algorithmen-Bibliothek

Bibliothek für Zeichenketten

Textverarbeitungsbibliothek

Numerik-Bibliothek

Datums- und Zeitbibliothek

Ein-/Ausgabe-Bibliothek

Dateisystembibliothek (C++17)

Unterstützung für nebenläufige Programmierung (C++11)

Ausführungssteuerungsbibliothek (C++26)

Technische Spezifikationen

Symbolverzeichnis

Externe Bibliotheken

 

Container-Bibliothek

Sequenz

array (C++11)

vector

vector<bool>

inplace_vector (C++26)

hive (C++26)

deque

forward_list (C++11)

list

Assoziativ

setzt

multiset

map

multimap

Ungeordnete assoziative

unordered_set (C++11)

unordered_multiset (C++11)

unordered_map (C++11)

unordered_multimap (C++11)

Adapter

stack

queue

priority_queue

flat_set (C++23)

flat_multiset (C++23)

flat_map (C++23)

flat_multimap (C++23)

Ansichten

span (C++20)

mdspan (C++23)

Tabellen

Iterator-Invalidierung

Mitgliedsfunktionstabelle

Nicht-Mitgliedsfunktionstabelle

 

std::mdspan

Memberfunktionen mdspan::mdspan mdspan::operator= Elementzugriff mdspan::operator[] Observer mdspan::rank mdspan::rank_dynamic mdspan::static_extent mdspan::extent mdspan::size mdspan::empty mdspan::stride mdspan::extents mdspan::data_handle mdspan::mapping mdspan::accessor mdspan::is_uniquemdspan::is_exhaustivemdspan::is_stridedmdspan::is_always_uniquemdspan::is_always_exhaustivemdspan::is_always_strided

Nicht-Member-Funktionen swap(std::mdspan) Unteransichten (Subviews) submdspan (C++26) submdspan_extents (C++26) Hilfstypen und Vorlagen extentsdextents dims (C++26) default_accessor aligned_accessor (C++26) Layout-Mapping-Richtlinien layout_left layout_right layout_stride layout_left_padded (C++26) layout_right_padded (C++26) Hilfstypen für Unteransichten full_extent (C++26) strided_slice (C++26) submdspan_mapping_result (C++26) Deduction Guides

 

template< class... OtherIndexTypes > constexpr reference operator[]( OtherIndexTypes... indices ) const;	(1)	(seit C++23)
template< class OtherIndexType > constexpr reference operator[]     ( std::span<OtherIndexType, rank()> indices ) const;	(2)	(seit C++23)
template< class OtherIndexType > constexpr reference operator[]     ( const std::array<OtherIndexType, rank()>& indices ) const;	(3)	(seit C++23)

Gibt einen Verweis auf das indices^th Element des mdspan zurück.

1) Äquivalent zu return acc_.access(ptr_, map_(static_cast<index_type>(std::move(indices))...));.

Diese Überladung nimmt nur an der Überladungsauflösung teil, wenn

• (std::is_convertible_v<OtherIndexTypes, index_type> && ...) ist true,
• (std::is_nothrow_constructible_v<index_type, OtherIndexTypes> && ...) ist true, und
• sizeof...(OtherIndexTypes) == rank() ist true.

Sei I extents_type::index-cast(std::move(indices)). Dann ist das Verhalten undefiniert, wenn I kein mehrdimensionaler Index in extents() ist, d.h. map_(I) < map_.required_span_size() ist false.

2,3) Sei P ein Parameter-Pack, so dass std::is_same_v<make_index_sequence<rank()>, index_sequence<P...>> true ist, dann ist der Operator äquivalent zu return operator[](extents_type::index-cast(std::as_const(indices[P]))...);.

Diese Überladung nimmt nur an der Überladungsauflösung teil, wenn

• std::is_convertible_v<const OtherIndexType&, index_type> ist true, und
• std::is_nothrow_constructible_v<index_type, const OtherIndexType&> ist true.

Parameter

indices

-

die Indizes des zuzugreifenden Elements

Rückgabewert

Ein Verweis auf das Element.

Fehlerberichte

Die folgenden Verhaltensändernden Fehlerberichte wurden rückwirkend auf zuvor veröffentlichte C++-Standards angewendet.

DR	angewendet auf	Verhalten wie veröffentlicht	Korrigiertes Verhalten
LWG 3974	C++23	Überladungen (2,3) haben extents_type::index-cast nicht angewendet	angewendet