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

CKTIS / C++

std::span — изглед към непрекъснати елементи

std::span предоставя достъп до непрекъснати елементи, без да ги притежава. Позволява да се подаде диапазон заедно с размера му, а subspan създава изглед към част от диапазона, без да копира елементи.

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

Синтаксис

#include <span>
// Default construction is allowed only for extent 0 or std::dynamic_extent.
std::span<T> empty; // Extent defaults to std::dynamic_extent.
std::span<T> view{data, count};
view.size();
view.subspan(offset, count);
view.subspan<Offset, Count>();

std::span<T, Extent> от <span> е изглед към непрекъснати елементи. Той не притежава тези елементи и не удължава времето им на живот. Extent задава фиксиран размер в типа; стойността по подразбиране std::dynamic_extent, както при std::span<T>, означава, че размерът се определя по време на изпълнение.

std::span::size() връща броя на елементите като size_type, а не броя на байтовете. std::span::subspan(offset, count) създава изглед, който започва от индекс offset, без да копира данните. Ако count е пропуснат или изрично е подадено std::dynamic_extent, изгледът обхваща останалата част от диапазона. В противен случай той обхваща count елемента. Това претоварване връща изглед с динамичен размер. subspan<Offset, Count>() приема аргументи на шаблона. Ако Count != std::dynamic_extent, резултатът има фиксиран размер Count. Ако Count == std::dynamic_extent, независимо дали стойността е зададена изрично, или се използва по подразбиране, размерът на резултата е динамичен при Extent == std::dynamic_extent; в противен случай той е фиксиран и равен на Extent - Offset.

В C++23 се изисква offset <= size() и, когато изричният count е различен от std::dynamic_extent, също count <= size() - offset. Нарушаването на тези условия води до неопределено поведение, а не до гарантирано изключение. Претоварването на шаблона отхвърля и граници, несъвместими с обхвата, зададен в типа. size() и subspan() имат константна времева сложност.

Данните трябва да останат валидни, докато изгледът се използва; унищожаването на собственика или повторното заделяне на неговата памет може да обезсили достъпа. std::span<const T> не позволява промяна на елементите чрез изгледа, докато const std::span<T> не го прави. Примерът променя оригиналния масив чрез подизглед. Източникът е развиващ се проект на стандарт, затова описанието умишлено се ограничава до операции, налични в C++23.

Примери

#include <iostream>
#include <span>

int main() {
    int values[]{10, 20, 30, 40};
    std::span<int> all{values};
    auto middle = all.subspan(1, 2);
    middle[0] = 25;

    std::cout << all.size() << ' ' << middle.size() << '\n';
    std::cout << values[1] << ' ' << middle[1] << '\n';
}

Резултат

4 2
25 30

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

Източници