std:: any_cast
From cppreference.net
|
Definiert in Header
<any>
|
||
|
template
<
class
T
>
T any_cast ( const any & operand ) ; |
(1) | (seit C++17) |
|
template
<
class
T
>
T any_cast ( any & operand ) ; |
(2) | (seit C++17) |
|
template
<
class
T
>
T any_cast ( any && operand ) ; |
(3) | (seit C++17) |
|
template
<
class
T
>
const T * any_cast ( const any * operand ) noexcept ; |
(4) | (seit C++17) |
|
template
<
class
T
>
T * any_cast ( any * operand ) noexcept ; |
(5) | (seit C++17) |
Führt typsicheren Zugriff auf das enthaltene Objekt aus.
Sei
U
gleich
std::
remove_cv_t
<
std::
remove_reference_t
<
T
>>
.
Inhaltsverzeichnis |
Parameter
| Operand | - |
Zielobjekt
any
|
Rückgabewert
1,2)
Gibt
static_cast
<
T
>
(
*
std
::
any_cast
<
U
>
(
&
operand
)
)
zurück.
3)
Gibt
static_cast
<
T
>
(
std
::
move
(
*
std
::
any_cast
<
U
>
(
&
operand
)
)
)
zurück.
4,5)
Wenn
operand
kein Nullzeiger ist und die
typeid
des angeforderten
T
mit der des Inhalts von
operand
übereinstimmt, ein Zeiger auf den von operand enthaltenen Wert, andernfalls ein Nullzeiger.
Ausnahmen
1-3)
Wirft
std::bad_any_cast
falls die
typeid
des angeforderten
T
nicht mit der des Inhalts von
operand
übereinstimmt.
Beispiel
Diesen Code ausführen
#include <any> #include <iostream> #include <string> #include <type_traits> #include <utility> int main() { // Einfaches Beispiel auto a1 = std::any(12); std::cout << "1) a1 ist int: " << std::any_cast<int>(a1) << '\n'; try { auto s = std::any_cast<std::string>(a1); // wirft Exception } catch (const std::bad_any_cast& e) { std::cout << "2) " << e.what() << '\n'; } // Pointer-Beispiel if (int* i = std::any_cast<int>(&a1)) std::cout << "3) a1 ist int: " << *i << '\n'; else if (std::string* s = std::any_cast<std::string>(&a1)) std::cout << "3) a1 ist std::string: " << *s << '\n'; else std::cout << "3) a1 ist ein anderer Typ oder nicht gesetzt\n"; // Erweitertes Beispiel a1 = std::string("hello"); auto& ra = std::any_cast<std::string&>(a1); // Referenz ra[1] = 'o'; std::cout << "4) a1 ist string: " << std::any_cast<const std::string&>(a1) << '\n'; // konstante Referenz auto s1 = std::any_cast<std::string&&>(std::move(a1)); // Rvalue-Referenz // Hinweis: "s1" ist ein move-konstruierter std::string: static_assert(std::is_same_v<decltype(s1), std::string>); // Hinweis: Der std::string in "a1" bleibt in einem gültigen aber unspezifizierten Zustand std::cout << "5) a1.size(): " << std::any_cast<std::string>(&a1)->size() // Pointer << '\n' << "6) s1: " << s1 << '\n'; }
Mögliche Ausgabe:
1) a1 ist int: 12 2) bad any_cast 3) a1 ist int: 12 4) a1 ist string: hollo 5) a1.size(): 0 6) s1: hollo
Fehlerberichte
Die folgenden verhaltensändernden Fehlerberichte wurden rückwirkend auf zuvor veröffentlichte C++-Standards angewendet.
| DR | Angewendet auf | Verhalten wie veröffentlicht | Korrektes Verhalten |
|---|---|---|---|
| LWG 3305 | C++17 |
das Verhalten der Überladungen
(
4,5
)
war unklar, falls
T
void
ist
|
das Programm ist in diesem Fall fehlerhaft |