Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C++

explicit — řízení implicitních konverzí

Specifikátor explicit omezuje použití konstruktorů a konverzních funkcí při implicitních konverzích, ale umožňuje záměrné vytváření objektů. Poznejte rozdíl mezi přímou inicializací a inicializací kopírováním, zvláštní roli operator bool a podmíněné explicit(condition).

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

Syntaxe

explicit ClassName(parameters);
explicit operator TargetType() const;
explicit(condition) ClassName(parameters);
explicit(condition) operator TargetType() const;

explicit pomáhá omezit nechtěné uživatelsky definované konverze. Může označovat konstruktor nebo konverzní funkci uvnitř definice třídy; není to specifikátor pro běžné funkce. Může se také objevit u dedukčních vodítek pro šablony tříd. Samotné explicit znamená explicit(true).

U konstruktoru explicit Count(int) jsou Count a(3); i Count b{3}; platné přímé inicializace. Count c = 3; je neplatné, protože inicializace kopírováním tento konstruktor ke konverzi nepoužije. Neplatné je také Count d = {3};, pokud inicializace seznamem kopírováním vybere konstruktor explicit. Funkce, která přijímá Count, obdobně nemůže přijmout samotné 3, ale může dostat Count{3}. Specifikátor se neomezuje na konstruktory s jedním parametrem.

Konverzní funkce explicit operator bool() const zakazuje bool e = a;, ale dovoluje static_cast<bool>(a) a přímou inicializaci bool e(a);. Důležitou výjimkou jsou booleovské podmínky: if (a) může tento operátor použít, protože kontextová konverze na bool ověřuje, zda je možná přímá inicializace. Obecně to však implicitní konverze nepovoluje.

V C++23 platí pro explicit(condition) přísnější pravidla než pro běžnou podmínku if: výsledkem kontextové konverze na bool musí být konstantní výraz a posloupnost konverzí smí obsahovat pouze povolené konverze, nikoli zužující. Například 2 je konstantní výraz a lze ho použít jako podmínku v if (2), ale explicit(2) je neplatné, protože konverze hodnoty 2 na bool je zužující. Hodnota true zapíná explicit; hodnota false ponechává deklaraci neexplicitní. Nejde o přepínač za běhu. Tato možnost je užitečná v šablonách, když implicitní konvertibilita závisí na typu. Příklad používá režim C++23. Zdroje představují vyvíjející se pracovní návrh, nikoli uzavřené vydání C++23.

Příklady

#include <iostream>
#include <type_traits>

struct Count {
    int value;
    explicit Count(int n) : value(n) {}
    explicit operator bool() const { return value != 0; }
};

static_assert(std::is_constructible_v<Count, int>);
static_assert(!std::is_convertible_v<int, Count>);
static_assert(!std::is_convertible_v<Count, bool>);

int main() {
    Count a(3);
    Count b{0};
    // Count c = 3;
    // Count d = {3};
    // bool e = a;
    if (a) {
        std::cout << a.value << '\n';
    }
    std::cout << std::boolalpha << static_cast<bool>(b) << '\n';
}

Výsledek

3
false

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje