Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / C++

std::to_underlying – pretvorba enumeracije v njen osnovni tip

std::to_underlying iz glave <utility> pretvori vrednost enumeracije v njen natančni osnovni tip. Funkcija, ki je na voljo od C++23, je constexpr in noexcept; ne vsili tipa int in ne preveri, ali vrednost ustreza poimenovanemu enumeratorju.

Različica: 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 glave <utility> vrne številsko predstavitev vrednosti enumeracije. Njen povratni tip je std::underlying_type_t<T>, kjer je T tip argumenta. Deluje tako z enum kot z enum class; ni splošna funkcija za pretvarjanje poljubnih argumentov v cela števila.

Rezultat je določen kot static_cast<std::underlying_type_t<T>>(value). V nasprotju z static_cast<int>(value) funkcija ohrani natančni osnovni tip, vključno z njegovo predznačenostjo, namesto da bi vsilila int. To je uporabno pri posredovanju številske predstavitve enumeracije drugemu vmesniku.

Funkcija je constexpr, zato lahko sodeluje pri konstantnem vrednotenju, in noexcept, zato ne sproža izjem. Ne preveri, ali podana vrednost ustreza poimenovanemu enumeratorju. Prav tako ne izvede obratne pretvorbe iz števila v enumeracijo.

V primeru ima Status izrecno določen osnovni tip unsigned int. Trditve preverijo povratni tip, vrednost 7u in lastnost noexcept, program pa izpiše 7. Podporo za C++23 morata zagotavljati tako prevajalnik kot standardna knjižnica; zastavica prevajalnika v repozitoriju sama po sebi ne potrjuje delovanja v produkcijskem izvajalnem okolju.

Primeri

#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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri