Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / C++

std::to_underlying — pretvorba enumeracije u njezin temeljni tip

std::to_underlying iz zaglavlja <utility> pretvara vrijednost enumeracije u njezin točan temeljni tip. Dostupna od C++23, funkcija je constexpr i noexcept; ne nameće tip int niti provjerava odgovara li vrijednost imenovanom enumeratoru.

Verzija: C++23; repository compiler flag, production runtime not attested

Sintaksa

#include <utility>

template<class T>
constexpr std::underlying_type_t<T> std::to_underlying(T value) noexcept;

std::to_underlying(value) iz zaglavlja <utility> vraća brojčani prikaz vrijednosti enumeracije. Povratni tip je std::underlying_type_t<T>, gdje je T tip argumenta. Funkcija radi i s enum i s enum class; nije općenita funkcija za pretvaranje proizvoljnih argumenata u cijele brojeve.

Rezultat je definiran kao static_cast<std::underlying_type_t<T>>(value). Za razliku od static_cast<int>(value), funkcija čuva točan temeljni tip, uključujući njegovu predznakovnost, umjesto da nameće int. To je korisno pri prosljeđivanju brojčanog prikaza enumeracije drugom sučelju.

Funkcija je constexpr, pa može sudjelovati u izračunu konstanti, i noexcept, pa ne baca iznimke. Ne provjerava odgovara li zadana vrijednost imenovanom enumeratoru. Također ne obavlja obrnutu pretvorbu iz broja u enumeraciju.

U primjeru Status ima izričiti temeljni tip unsigned int. Tvrdnje provjeravaju povratni tip, vrijednost 7u i svojstvo noexcept, a program ispisuje 7. Podršku za C++23 moraju imati i prevoditelj i standardna biblioteka; sama zastavica prevoditelja u repozitoriju ne potvrđuje rad u produkcijskom okruženju izvođenja.

Primjeri

#include <iostream>
#include <type_traits>
#include <utility>

enum class Status : unsigned int {
    ready = 7,
    done = 9
};

static_assert(std::is_same_v<
    decltype(std::to_underlying(Status::ready)), unsigned int>);
static_assert(std::to_underlying(Status::ready) == 7u);
static_assert(noexcept(std::to_underlying(Status::ready)));

int main() {
    std::cout << std::to_underlying(Status::ready) << '\n';
}

Rezultat

7

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori