dynamic_cast conversion

クラスのポインタと参照を、継承階層に沿って上方、下方、および横方向に安全に変換します。

、$タグ内のテキストは翻訳していません\; -\; C++固有の用語（Syntax、Explanation、Notes、Keywords、Example、Defect\; reports、References、See\; also）は原文のまま保持しています\; -\; 数値や構造は完全に保持されています\; -\; フォーマットとリンクは変更していません$

構文

説明

記述の便宜上、「 expression または結果が T への参照である」とは、「それが型 T のglvalueである」ことを意味する （この表記は decltype の慣例に従う） (C++11以降) 。

以下の変換のみが dynamic_cast によって実行可能です。ただし、そのような変換が const性の除去 （またはvolatile性の除去）となる場合は除きます。

コンストラクタまたはデストラクタ内（直接的または間接的に） dynamic_cast が使用され、 expression が現在構築中/破棄中のオブジェクトを参照する場合、そのオブジェクトは最も派生したオブジェクトと見なされます。 target-type がコンストラクタ/デストラクタ自身のクラスまたはその基底クラスへのポインタまたは参照でない場合、動作は未定義です。

他のキャスト式と同様に、結果は以下の通りです：

注記

ダウンキャストは static_cast でも実行可能ですが、ランタイムチェックのコストを回避できる一方、プログラムが（他のロジックを通じて） expression が指すオブジェクトが確実に Derived であることを保証できる場合にのみ安全です。

一部の形式の dynamic_cast は run-time type identification (RTTI)、すなわちコンパイルされたプログラム内の各ポリモーフィッククラスに関する情報に依存しています。コンパイラは通常、この情報の組み込みを無効にするオプションを備えています。

キーワード

dynamic_cast

例

#include <iostream>
struct V
{
    virtual void f() {} // ランタイムチェック付きdynamic_castを使用するには多態的でなければならない
};
struct A : virtual V {};
struct B : virtual V
{
    B(V* v, A* a)
    {
        // 構築中のキャスト（下記Dのコンストラクタ内の呼び出しを参照）
        dynamic_cast<B*>(v); // 適切に定義: vはV*型、VはBの基底、結果はB*
        dynamic_cast<B*>(a); // 未定義動作: aはA*型、AはBの基底ではない
    }
};
struct D : A, B
{
    D() : B(static_cast<A*>(this), this) {}
};
struct Base
{
    virtual ~Base() {}
};
struct Derived : Base
{
    virtual void name() {}
};
int main()
{
    D d; // 最も派生したオブジェクト
    A& a = d; // アップキャスト、dynamic_castは使用可能だが不要
    [[maybe_unused]]
    D& new_d = dynamic_cast<D&>(a); // ダウンキャスト
    [[maybe_unused]]
    B& new_b = dynamic_cast<B&>(a); // サイドキャスト
    Base* b1 = new Base;
    if (Derived* d = dynamic_cast<Derived*>(b1); d != nullptr)
    {
        std::cout << "b1からdへのダウンキャスト成功\n";
        d->name(); // 安全に呼び出し可能
    }
    Base* b2 = new Derived;
    if (Derived* d = dynamic_cast<Derived*>(b2); d != nullptr)
    {
        std::cout << "b2からdへのダウンキャスト成功\n";
        d->name(); // 安全に呼び出し可能
    }
    delete b1;
    delete b2;
}

downcast from b2 to d successful

不具合報告

以下の動作変更の欠陥報告書は、以前に公開されたC++規格に対して遡及的に適用されました。

参考文献

関連項目

• const_cast
• static_cast
• reinterpret_cast
• 明示的キャスト
• 暗黙的変換