WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

std::convertible_to — übereinstimmende implizite und explizite Konvertierung

std::convertible_to<From, To> aus <concepts> verlangt sowohl eine implizite Konvertierung als auch eine Konvertierung mit static_cast zu To, wobei die Ergebnisse übereinstimmen müssen. Ein expliziter Cast allein genügt nicht.

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

Syntax

template<class From, class To>
concept convertible_to =
    std::is_convertible_v<From, To> &&
    requires { static_cast<To>(std::declval<From>()); };

std::convertible_to<From, To> aus <concepts> schränkt Templates ein. Seine Definition verbindet std::is_convertible_v<From, To> mit der Gültigkeit von static_cast<To>(std::declval<From>()). Dabei werden Typ und Wertkategorie von std::declval<From>() berücksichtigt; Qualifizierer und Referenzen in From sind daher relevant.

Die implizite und die explizite Konvertierung müssen gleiche Ergebnisse liefern, wenn To ein Objekttyp oder eine Referenz auf ein Objekt ist. Dies ist eine semantische Anforderung und nicht nur eine Syntaxprüfung: Ein Ergebnis true beweist nicht, dass der Compiler das Verhalten benutzerdefinierter Konvertierungen geprüft hat.

Wenn std::add_rvalue_reference_t<From> eine Referenz auf ein Objekt ist, dürfen die Konvertierungen das Quellobjekt nicht verändern, es sei denn, es handelt sich um eine Rvalue-Referenz auf einen nicht-const-Typ. In diesem Ausnahmefall darf das Objekt in einem gültigen, aber nicht spezifizierten Zustand verbleiben. Für eine Quelle, die keine Referenz auf ein Objekt ist, gilt diese Bedingung nicht.

Im Beispiel erfüllt short die Einschränkung für as_int. ExplicitOnly unterstützt static_cast<int>, aber sein explicit operator int() ermöglicht keine implizite Konvertierung; daher ist das Konzept false. Das Konzept garantiert keine verlustfreie Konvertierung: Übereinstimmende Ergebnisse der beiden Konvertierungsarten bedeuten nicht, dass der gesamte Quellwert erhalten bleibt.

Beispiele

#include <concepts>
#include <iostream>

struct ExplicitOnly {
    explicit operator int() const { return 7; }
};

template<class T>
    requires std::convertible_to<T, int>
int as_int(T value) {
    return static_cast<T&&>(value);
}

static_assert(std::convertible_to<short, int>);
static_assert(!std::convertible_to<ExplicitOnly, int>);
static_assert(requires(ExplicitOnly x) { static_cast<int>(x); });

int main() {
    std::cout << as_int(short{7}) << '\n';
    std::cout << static_cast<int>(ExplicitOnly{}) << '\n';
}

Ergebnis

7
7

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen