Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / C++

std::to_underlying — prevod výčtu na jeho základný typ

std::to_underlying z hlavičky <utility> prevádza hodnotu výčtu na jej presný základný typ. Funkcia dostupná od C++23 je constexpr a noexcept; nevynucuje typ int ani nekontroluje, či hodnota zodpovedá pomenovanému enumerátoru.

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

Syntax

#include <utility>

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

std::to_underlying(value) z hlavičky <utility> vracia číselnú reprezentáciu hodnoty výčtu. Jej návratový typ je std::underlying_type_t<T>, kde T je typ argumentu. Funguje s enum aj enum class; nejde o všeobecnú funkciu na prevod ľubovoľných argumentov na celé čísla.

Výsledok je definovaný ako static_cast<std::underlying_type_t<T>>(value). Na rozdiel od static_cast<int>(value) funkcia zachováva presný základný typ vrátane jeho znamienkovosti, namiesto toho, aby vynucovala int. Je to užitočné pri odovzdávaní číselnej reprezentácie výčtu do iného rozhrania.

Funkcia je constexpr, takže sa môže zúčastňovať na vyhodnocovaní konštánt, a noexcept, takže nevyhadzuje výnimky. Nekontroluje, či zadaná hodnota zodpovedá pomenovanému enumerátoru. Nevykonáva ani opačný prevod z čísla na výčet.

V príklade má Status explicitný základný typ unsigned int. Asercie kontrolujú návratový typ, hodnotu 7u a vlastnosť noexcept, zatiaľ čo program vypíše 7. Podporu C++23 musí poskytovať kompilátor aj štandardná knižnica. Samotný príznak kompilátora v repozitári nepotvrdzuje fungovanie v produkčnom runtime prostredí.

Príklady

#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';
}

Výsledok

7

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje