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
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.