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

CKTIS / C++

std::is_trivially_copyable — откриване на тривиално копируеми типове

Тази характеристика от <type_traits> проверява по време на компилация дали даден тип е тривиално копируем. Научете еквивалентните форми ::value и _v, както и ограниченията при копиране на представянето на обект.

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

Синтаксис

#include <type_traits>
std::is_trivially_copyable<T>::value
std::is_trivially_copyable_v<T>

std::is_trivially_copyable<T> от <type_traits> е характеристика на тип: нейното ::value е булева константа, която показва дали T е тривиално копируем. std::is_trivially_copyable_v<T> предоставя същата стойност директно. Използвайте я в static_assert или if constexpr, за да проверявате изискванията в генеричен код.

Тези типове включват скаларни типове, тривиално копируеми класове, масиви от такива типове и техните варианти с квалификатори cv. Класът трябва да има поне една допустима операция за копиране или преместване; всяка такава допустима операция трябва да е тривиална, а деструкторът трябва да е тривиален и да не е изтрит. Това не проверява свойствата на standard-layout, нито само дали може да бъде извикан конструктор за копиране.

Предварителното условие изисква std::remove_all_extents_t<T> да е завършен тип или евентуално void с квалификатори cv. Затова не проверявайте клас преди пълната му дефиниция. В примера Point удовлетворява характеристиката, а NonTrivial не я удовлетворява заради деструктора, предоставен от потребителя.

При два отделни, съществуващи обекта от един и същ тривиално копируем тип, нито един от които не е потенциално припокриващ се подобект, копирането на цялото представяне с std::memcpy дава на целевия обект стойността на изходния обект, при условие че диапазоните от байтове на източника и целта не се припокриват. Дори когато обектите са отделни, припокриването на тези диапазони води до неопределено поведение при извикването на std::memcpy. Примерът копира Point по този начин. true обаче не означава преносим формат за сериализация: представянето може да съдържа байтове за запълване, а указателите не стават копия на обектите, към които сочат. Изискванията за времето на живот на обектите и валидния достъп до паметта продължават да важат.

Примери

#include <cstring>
#include <iostream>
#include <type_traits>

struct Point {
    int x;
    int y;
};

struct NonTrivial {
    ~NonTrivial() {}
};

static_assert(std::is_trivially_copyable<Point>::value);
static_assert(!std::is_trivially_copyable_v<NonTrivial>);

int main() {
    Point source{3, 7};
    Point destination{0, 0};
    std::memcpy(&destination, &source, sizeof source);

    std::cout << std::boolalpha
              << std::is_trivially_copyable_v<Point> << '\n'
              << destination.x << ' ' << destination.y << '\n';
}

Резултат

true
3 7

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

Източници