База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / C++

std::views::take — изглед към първите елементи на диапазон

std::views::take от <ranges> създава изглед към най-много count начални елемента на диапазон. Запазва реда им, не създава отделен контейнер и поддържа както директно извикване, така и запис с конвейер.

Версия: C++23; repository compiler flag, production runtime not attested

Синтаксис

#include <ranges>
std::views::take(range, count)
range | std::views::take(count)

std::views::take е обект адаптер за диапазони, предоставен от <ranges>. Изразът std::views::take(range, count) съответства на range | std::views::take(count). Ако count е неотрицателна стойност, която може да се представи в типа за разлика на итераторите на диапазона, резултатът предоставя първите count елемента в първоначалния им ред или целия диапазон, ако съдържа по-малко елементи. Когато count е 0, резултатът е празен.

Това е изглед, а не копиран контейнер: прилагането на адаптера нито копира елементи в нова колекция, нито премахва крайните елементи от източника. Елементите се четат по време на обхождането. Резултатът не е задължително от тип std::ranges::take_view; за някои видове диапазони стандартът задава други равностойни представяния на изглед, затова обикновено е подходящо да се използва auto.

Аргументът count трябва да може да се преобразува към типа за разлика на итераторите на диапазона. Използвайте неотрицателна стойност, която може да се представи в този тип, дори когато адаптерът не конструира std::ranges::take_view. Например в оптимизирания случай за std::span адаптерът преобразува count към този тип, преди да определи минимума на преобразуваната стойност и дължината на диапазона. Твърде голяма стойност от беззнаков тип може при преобразуването да стане -1 и да доведе до невалидна аритметика с итератори, вместо да се избере целият диапазон. Когато адаптерът конструира std::ranges::take_view, конструкторът изисква стойността след преобразуването да е неотрицателна. Отрицателна стойност не означава броене от края. Ако типът на входния диапазон е специализация на std::ranges::empty_view, адаптерът изчислява стойността на аргумента count и я отхвърля, без да конструира std::ranges::take_view, така че отрицателна стойност не нарушава това предварително условие.

Когато съществуващ контейнер се адаптира чрез lvalue, изгледът се отнася към този контейнер. Следователно източникът трябва да продължи да съществува, докато изгледът се използва, а операциите, които обезсилват итератори, могат да обезсилят и достъпа чрез изгледа. В примера промяната на values[0] след създаването на first се отразява в изхода: 11 20 30. Показаният код е изпълнен без промени в изолирана среда. Стандартният му изход съвпадна точно с посочения изход.

Примери

#include <array>
#include <iostream>
#include <ranges>

int main() {
    std::array<int, 5> values{10, 20, 30, 40, 50};
    auto first = values | std::views::take(3);
    values[0] = 11;

    bool separator = false;
    for (int value : first) {
        if (separator) std::cout << ' ';
        std::cout << value;
        separator = true;
    }
    std::cout << '\n';
}

Резултат

11 20 30

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници