std::ranges:: views:: repeat, std::ranges:: repeat_view
|
Definiert im Header
<ranges>
|
||
|
template
<
std::
move_constructible
W,
std::
semiregular
Bound
=
std::
unreachable_sentinel_t
>
|
(1) | (seit C++23) |
|
namespace
views
{
inline
constexpr
/* nicht spezifiziert */
repeat
=
/* nicht spezifiziert */
;
|
(2) | (seit C++23) |
|
Aufrufsignatur
|
||
|
template
<
class
W
>
requires
/* siehe unten */
|
(seit C++23) | |
|
template
<
class
W,
class
Bound
>
requires
/* siehe unten */
|
(seit C++23) | |
|
Hilfskonzepte
|
||
|
concept
/*integer-like-with-usable-difference-type*/
=
/*is-signed-integer-like*/
<
T
>
||
|
(3) | ( nur zur Darstellung* ) |
repeat_view
modelliert
random_access_range
. Wenn
Bound
nicht
std::unreachable_sentinel_t
ist,
repeat_view
modelliert ebenfalls
sized_range
und
common_range
.
Inhaltsverzeichnis |
Customization Point Objects
Der Name
views::repeat
bezeichnet ein
Customization Point Object
, welches ein konstantes
Function Object
eines
Literal
semiregular
Klassentyps ist. Weitere Details finden Sie unter
CustomizationPointObject
.
Datenmitglieder
| Member | Definition |
movable-box
<
W
>
value_
|
das sich wiederholende Element der Ansicht
( Nur zur Darstellung verwendetes Mitgliedsobjekt* ) |
Bound
bound_
|
der Sentinel-Wert
( Nur zur Darstellung verwendetes Mitgliedsobjekt* ) |
Memberfunktionen
erstellt einen
repeat_view
(öffentliche Elementfunktion) |
|
ermittelt den Beginn-Iterator eines
repeat_view
(öffentliche Elementfunktion) |
|
ermittelt den Sentinel, der das Ende eines
repeat_view
kennzeichnet
(öffentliche Elementfunktion) |
|
ermittelt die Größe eines
repeat_view
falls dieser eine Größe besitzt
(öffentliche Elementfunktion) |
|
Geerbt von std::ranges::view_interface |
|
gibt zurück, ob die abgeleitete Ansicht leer ist, bereitgestellt nur wenn sie
sized_range
oder
forward_range
erfüllt
(öffentliche Elementfunktion von
std::ranges::view_interface<D>
)
|
|
|
(C++23)
|
gibt einen konstanten Iterator zum Beginn des Bereichs zurück
(öffentliche Elementfunktion von
std::ranges::view_interface<D>
)
|
|
(C++23)
|
gibt einen Sentinel für den konstanten Iterator des Bereichs zurück
(öffentliche Elementfunktion von
std::ranges::view_interface<D>
)
|
|
gibt zurück, ob die abgeleitete Ansicht nicht leer ist, bereitgestellt nur wenn
ranges::empty
darauf anwendbar ist
(öffentliche Elementfunktion von
std::ranges::view_interface<D>
)
|
|
gibt das erste Element in der abgeleiteten Ansicht zurück, bereitgestellt falls sie
forward_range
erfüllt
(öffentliche Elementfunktion von
std::ranges::view_interface<D>
)
|
|
gibt das letzte Element in der abgeleiteten Ansicht zurück, bereitgestellt nur wenn sie
bidirectional_range
und
common_range
erfüllt
(öffentliche Elementfunktion von
std::ranges::view_interface<D>
)
|
|
gibt das
n
-te
Element in der abgeleiteten Ansicht zurück, bereitgestellt nur wenn sie
random_access_range
erfüllt
(öffentliche Elementfunktion von
std::ranges::view_interface<D>
)
|
|
std::ranges::repeat_view:: repeat_view
|
repeat_view
(
)
requires
std::
default_initializable
<
W
>
=
default
;
|
(1) | (seit C++23) |
|
constexpr
explicit
repeat_view
(
const
W
&
value, Bound bound
=
Bound
(
)
)
;
|
(2) | (seit C++23) |
|
constexpr
explicit
repeat_view
(
W
&&
value, Bound bound
=
Bound
(
)
)
;
|
(3) | (seit C++23) |
|
template
<
class
...
WArgs
,
class
...
BoundArgs
>
requires
std::
constructible_from
<
W, WArgs...
>
|
(4) | (seit C++23) |
Bound
nicht
std::unreachable_sentinel_t
ist und
bool
(
bound
>=
0
)
false
ist, ist das Verhalten undefiniert.
Bound
nicht
std::unreachable_sentinel_t
ist und
bool
(
bound
>=
0
)
false
ist, ist das Verhalten undefiniert.
value_
mit
std::
make_from_tuple
<
T
>
(
std
::
move
(
value_args
)
)
und
bound_
mit
std::
make_from_tuple
<
Bound
>
(
std
::
move
(
bound_args
)
)
.
Bound
nicht
std::unreachable_sentinel_t
ist und
bool
(
bound
>=
0
)
false
ist, ist das Verhalten undefiniert.
Parameter
| value | - | der wiederholt zu produzierende Wert |
| bound | - | die Grenze |
| value_args | - |
das Tupel mit den Initialisierern von
value_
|
| bound_args | - |
das Tupel mit den Initialisierern von
bound_
|
std::ranges::repeat_view:: begin
|
constexpr
/*iterator*/
begin
(
)
const
;
|
(seit C++23) | |
Gibt
iterator
(
std::
addressof
(
*
value_
)
)
zurück.
std::ranges::repeat_view:: end
|
constexpr
/*iterator*/
end
(
)
const
requires ( ! std:: same_as < Bound, std:: unreachable_sentinel_t > ) ; |
(1) | (seit C++23) |
|
constexpr
std::
unreachable_sentinel_t
end
(
)
const
;
|
(2) | (seit C++23) |
iterator
(
std::
addressof
(
*
value_
)
,
bound_
)
.
std::ranges::repeat_view:: size
|
constexpr
auto
size
(
)
const
requires ( ! std:: same_as < Bound, std:: unreachable_sentinel_t > ) ; |
(seit C++23) | |
Gibt
to-unsigned-like
(
bound_
)
zurück.
Deduktionsanleitungen
|
template
<
class
W,
class
Bound
=
std::
unreachable_sentinel_t
>
repeat_view ( W, Bound = Bound ( ) ) - > repeat_view < W, Bound > ; |
(seit C++23) | |
Geschachtelte Klassen
|
der Iteratortyp
( Nur zur Darstellung verwendete Memberklasse* ) |
Hinweise
| Feature-Test Makro | Wert | Std | Feature |
|---|---|---|---|
__cpp_lib_ranges_repeat
|
202207L
|
(C++23) |
std::ranges::repeat_view
|
Beispiel
#include <iostream> #include <ranges> #include <string_view> using namespace std::literals; int main() { // bounded overload for (auto s : std::views::repeat("C++"sv, 3)) std::cout << s << ' '; std::cout << '\n'; // unbounded overload for (auto s : std::views::repeat("I know that you know that"sv) | std::views::take(3)) std::cout << s << ' '; std::cout << "...\n"; }
Ausgabe:
C++ C++ C++ I know that you know that I know that you know that I know that you know that ...
Fehlerberichte
Die folgenden verhaltensändernden Fehlerberichte wurden rückwirkend auf zuvor veröffentlichte C++-Standards angewendet.
| DR | Angewendet auf | Verhalten wie veröffentlicht | Korrektes Verhalten |
|---|---|---|---|
| LWG 4053 | C++20 |
Unäre Aufrufe von
views::repeat
haben das Argument nicht zerfallen lassen
|
Argument zerfallen lassen |
| LWG 4054 | C++20 |
Aufruf von
views::repeat
mit einem
repeat_view
hat keinen verschachtelten
repeat_view
erstellt
|
erstellt einen verschachtelten
repeat_view
|
Siehe auch
|
(C++20)
|
eine
view
bestehend aus einer Sequenz, die durch wiederholtes Inkrementieren eines Anfangswerts erzeugt wird
(Klassentemplate) (Customization Point Object) |