CKTIS / C++
std::views::all — изглед на цял диапазон
std::views::all приспособява диапазон към интерфейса за изгледи, като запазва всичките му елементи. Резултатът може да е копие или преместване на съществуващ изглед, референтен изглед или притежаващ изглед; от този избор зависи как трябва да се управлява жизненият цикъл на данните.
Версия: C++23; repository compiler flag, production runtime not attested
Синтаксис
#include <ranges>
std::views::all(r)
r | std::views::allstd::views::all от заглавния файл <ranges> е обект адаптер за диапазони. Изразите std::views::all(r) и r | std::views::all създават изглед на всички елементи, без да филтрират или преобразуват стойностите им. Аргументът трябва да удовлетворява std::ranges::viewable_range.
Изборът следва фиксиран ред: ако типът на аргумента след премахване на референциите и квалификаторите моделира std::ranges::view, резултатът е обект от този тип, копиран или преместен според категорията на стойността. В противен случай се създава std::ranges::ref_view, ако може да бъде конструиран; ако не, се създава std::ranges::owning_view. Не всеки изглед може да се подаде като lvalue: изглед, който може само да се премества, може да изисква std::move.
За lvalue std::vector<int> резултатът препраща към съществуващия вектор; за временен std::vector<int> той поема собствеността върху вектора. ref_view не удължава жизнения цикъл на източника. Източникът трябва да продължи да съществува, докато изгледът се използва, и правилата на контейнера за невалидиране на итератори продължават да важат. Когато векторът се подаде като lvalue, all не копира елементите. Ако обаче като lvalue се подаде изглед, който може да се копира, могат да се копират както самият изглед, така и елементите, които той съхранява: копие на std::ranges::single_view<int> съхранява собствен int.
Примерът показва и двата случая: записването чрез borrowed променя values, докато owned съхранява собствен вектор. Очакваният изход е два реда, съдържащи 9. Хранилището използва флага C++23; съвместимостта при изпълнение в производствена среда не е удостоверена.
Примери
#include <iostream>
#include <ranges>
#include <type_traits>
#include <vector>
int main() {
std::vector<int> values{1, 2, 3};
auto borrowed = values | std::views::all;
auto owned = std::views::all(std::vector<int>{4, 5});
static_assert(std::is_same_v<decltype(borrowed),
std::ranges::ref_view<std::vector<int>>>);
static_assert(std::is_same_v<decltype(owned),
std::ranges::owning_view<std::vector<int>>>);
borrowed.front() = 9;
std::cout << values.front() << '\n';
int sum = 0;
for (int value : owned) {
sum += value;
}
std::cout << sum << '\n';
}
Резултат
9 9
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.