コード読解演習 Step 3【上級】:多態性・vtable・動的挙動の追跡

基底ポインタと仮想関数テーブル(vtable)の向こう側にある「真の実行時呼び出し先」を暴く

`target->execute();` と書かれていても、実際に動くのはどのクラスの関数なのか?静的なテキスト検索だけでは歯が立たない多態性(ポリモーフィズム)と動的ディスパッチを、vtableの構造とデバッガ・ログを活用して正確に特定する上級読解術です。

← 前の章へ進む
次の章へ進む →

3.1 多態性コード読解の壁:「定義へジャンプ」で基底クラスへ飛んでしまう問題

VS Codeなどの「定義へジャンプ(F12)」を押すと、純粋仮想関数(= 0)に飛ばされて絶望した経験はありませんか?動的ディスパッチの読解戦略を伝授します。

🐧 ペンギン先輩
うわあああ!`cmd->execute(ctx);` の中身を読みたくてエディタで「定義へジャンプ」したら、`virtual void execute(Context& ctx) = 0;` って空っぽのヘッダに飛ばされました!実際に何が起きているのか全然分かりません!
🐻‍❄️ シロクマ先生
グハハ!それこそがオブジェクト指向の最大の罠であり強みじゃ! 静的なソースコード上では「基底クラスの契約」しか書かれておらん。実行時にどの具象クラスが化けているのかを突き止めるには、**【① 派生クラス一覧の grep 検索】→【② インスタンス生成(Factory や new)の探索】→【③ 実行時RTTIやデバッガログ】**を使うのじゃ!

### 動的ディスパッチを暴く「3大探索テクニック」

1. **テクニック1:「派生クラス・実装一覧」を引く**:
- `class [A-Za-z0-9_]+ : public ICommand` で正規表現検索をかけ、このインターフェースを実装している具象クラスの全候補をリストアップします。
2. **テクニック2:「生成起点(Factory/new)」を逆引きする**:
- キューに積まれる手前で、誰が `new MoveCommand(...)` を行っているかを検索します。
- イベント発火のトリガー(ボタン押下、パケット受信、AI判断)が見えてきます。
3. **テクニック3:「仮想デストラクタの存在」を必ず確認する**:
- 基底ポインタ経由で `delete cmd;` される場合、基底クラスに `virtual ~ICommand()` がないと派生クラスのデストラクタが呼ばれずメモリリークを起こします。コード読解時の最重要チェックポイントです。
💡 このセクションの重要ポイント
  • 「呼び出し元」ではなく「生成元」を探す: 多態性コードの真の挙動を知るには、`execute()` を呼んでいる場所ではなく、そのオブジェクトを `new` して渡している場所を特定するのが近道です。

3.2 演習コード:コマンドパターンによるイベント処理キュー一式

以下のファイルをタブで切り替えながら、`processAll` が各具象コマンドをどのように多態的に処理しているか追跡してください。

📄 ICommand.h
#pragma once
#include <string>

struct Context {
    int playerX = 10;
    int enemyHp = 50;
};

class ICommand {
public:
    virtual ~ICommand() = default;
    virtual void execute(Context& ctx) = 0;
    virtual std::string getName() const = 0;
};
📄 ConcreteCommands.h
#pragma once
#include <iostream>
#include "ICommand.h"

// 移動コマンド
class MoveCommand : public ICommand {
private:
    int m_deltaX;

public:
    MoveCommand(int deltaX) : m_deltaX(deltaX) {}

    void execute(Context& ctx) override {
        ctx.playerX += m_deltaX;
        std::cout << "[Action] 移動実行: X座標が " << ctx.playerX << " になりました\n";
    }

    std::string getName() const override { return "MoveCommand"; }
};

// 攻撃コマンド
class AttackCommand : public ICommand {
private:
    int m_damage;

public:
    AttackCommand(int damage) : m_damage(damage) {}

    void execute(Context& ctx) override {
        ctx.enemyHp -= m_damage;
        std::cout << "[Action] 攻撃実行: 敵HPに " << m_damage 
                  << " ダメージ!(残HP: " << ctx.enemyHp << ")\n";
    }

    std::string getName() const override { return "AttackCommand"; }
};
📄 CommandQueue.h
#pragma once
#include <vector>
#include <iostream>
#include "ICommand.h"

class CommandQueue {
private:
    std::vector<ICommand*> m_queue;

public:
    ~CommandQueue() {
        // メモリ解放(基底の仮想デストラクタ経由)
        for (ICommand* cmd : m_queue) {
            delete cmd;
        }
    }

    void push(ICommand* cmd) {
        m_queue.push_back(cmd);
    }

    void processAll(Context& ctx) {
        std::cout << ">>> キュー内の全コマンドを一括ディスパッチ実行:\n";
        for (ICommand* cmd : m_queue) {
            std::cout << "実行中: " << cmd->getName() << " -> ";
            // ★多態的呼び出し:vtable経由で具象クラスのexecute()が呼ばれる!
            cmd->execute(ctx);
        }
        m_queue.clear();
    }
};
📄 main.cpp
#include <iostream>
#include "ConcreteCommands.h"
#include "CommandQueue.h"

int main() {
    Context gameContext;
    CommandQueue queue;

    // イベントに応じてコマンドをキューイング(生成起点)
    queue.push(new MoveCommand(5));
    queue.push(new AttackCommand(25));
    queue.push(new MoveCommand(-2));

    // キューを実行
    queue.processAll(gameContext);

    std::cout << "=== 最終ゲームコンテキスト ===\n";
    std::cout << "自機X: " << gameContext.playerX << ", 敵HP: " << gameContext.enemyHp << "\n";
    return 0;
}
💡 このセクションの重要ポイント
  • vtableを通じた実行時の「化け」を見破る: CommandQueue は ICommand という抽象しか知りません。しかし実行時には注入された MoveCommand や AttackCommand の具象コードが正確に呼び出されます。

📝 理解度チェッククイズ

Q1. CommandQueue::processAll() 内の `cmd->execute(ctx);` において、実行時に MoveCommand や AttackCommand の正しい関数が呼び出されるC++の内部メカニズムは何でしょう?
  • 1. コンパイラがすべての if-else 分岐を自動生成しているから
  • 2. オブジェクト内に埋め込まれた vptr(仮想関数テーブルポインタ)が、実行時にその具象クラス固有の vtable を参照して間接関数ジャンプを行うから
  • 3. main.cpp の行番号を直接記憶しているから
  • 4. OSのプロセス管理機能が関数を検索しているから
正解と解説を見る
正解:オブジェクト内に埋め込まれた vptr(仮想関数テーブルポインタ)が、実行時にその具象クラス固有の vtable を参照して間接関数ジャンプを行うから
正解です!C++の仮想関数(virtual)は、各オブジェクトに不可視の vptr(仮想テーブルポインタ)を持たせ、実行時に vtable から関数アドレスを解決する動的ディスパッチによって動作します。
Q2. ICommand のデストラクタに `virtual` が指定されていない場合、`CommandQueue::~CommandQueue()` で `delete cmd;` した際に発生する重大なバグは何でしょう?
  • 1. コンパイルエラーになりビルドできない
  • 2. 基底クラスのデストラクタしか呼ばれず、派生クラス固有のメンバ変数の解放処理がスキップされて未定義動作・メモリリークが発生する
  • 3. PCの電源が落ちる
  • 4. 自動的にガーベジコレクションが実行される
正解と解説を見る
正解:基底クラスのデストラクタしか呼ばれず、派生クラス固有のメンバ変数の解放処理がスキップされて未定義動作・メモリリークが発生する
正解です!基底クラスのポインタ経由で派生オブジェクトを破棄(delete)する場合、仮想デストラクタ(virtual ~ICommand)が必須です。仮想になっていないと派生側のデストラクタがスキップされメモリリークや未定義動作を引き起こします。
Q3. main.cpp において、3つのコマンド(MoveCommand(5), AttackCommand(25), MoveCommand(-2))がすべて実行された後の `gameContext` の最終状態(playerX, enemyHp)はどれでしょう?(初期値: playerX = 10, enemyHp = 50)
  • 1. playerX = 10, enemyHp = 50
  • 2. playerX = 15, enemyHp = 25
  • 3. playerX = 13, enemyHp = 25
  • 4. playerX = 17, enemyHp = 75
正解と解説を見る
正解:playerX = 13, enemyHp = 25
正解です!初期値 playerX=10 に +5 され 15、次に -2 されて 13 になります。敵HPは初期値 50 から -25 されて 25 になります。
Q4. 多態性を用いた巨大なC++プロジェクトで、「このインターフェースを実装している具象クラスがどこにあるか分からない」ときの最も効率的な初動調査テクニックはどれでしょう?
  • 1. 諦めて全てのファイルを1行目から目視で探す
  • 2. プロジェクト全体を対象に `: public インターフェース名` で grep 検索(またはIDEの実装一覧機能)をかけて具象クラスをリストアップし、それらがどこで new / 生成されているかを特定する
  • 3. コンパイルを止めて再インストールする
  • 4. すべての virtual を削除してみる
正解と解説を見る
正解:プロジェクト全体を対象に `: public インターフェース名` で grep 検索(またはIDEの実装一覧機能)をかけて具象クラスをリストアップし、それらがどこで new / 生成されているかを特定する
正解です!派生クラスの宣言パターン(`: public ICommand`)を検索することで候補を一網打尽にし、さらに「その具象クラスをインスタンス化している Factory や登録箇所」を特定するのがプロの読解テクニックです。
← 前の章へ進む
次の章へ進む →

🐻‍❄️ シロクマC++ラボ インタラクティブ学習システム

ブラウザでJavaScriptを有効にすると、ブラウザ内インベーダーゲームエミュレータ、メモリマップ可視化、UMLクラス図、対話型解説、理解度クイズが起動します。

インタラクティブ学習を開始する →