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.