やあ。Haxeの世界へようこそ。
クロスプラットフォーム言語であるHaxeが、なぜこれほどまでに強力なのか。それは「ターゲット言語の深淵までを、型安全という武器で支配できるから」に他ならない。
今回は、PHPの強力な武器である「ジェネレータ（`yield`）」を、Haxeのイテレータとしてエレガントにねじ伏せる方法を解説するよ。これができるようになれば、既存の膨大なComposerエコシステムを、Haxeの洗練された型システムで完全に制御下に置けるようになるんだ。
—
1. なぜ「PHPのジェネレータ」をHaxeで扱うのか？
PHPの`yield`は、メモリ効率を劇的に高める「遅延評価」の仕組みだよね。数百万件のレコードを処理する際、配列に全展開してメモリを食いつぶすなんて愚の骨頂。
Haxeには`Iterable
—
2. 核心：PHPのGeneratorをHaxeに適合させる
PHPの`Generator`は、内部的に`Iterator`インターフェースを実装している。Haxe側では、これを`extern`クラスとして定義し、Haxeの`Iterator`に型変換するブリッジを書くのが定石だ。
実装パターン
まずは、PHP側のジェネレータをHaxeで扱うための定義を見てみよう。
// php.GeneratorをHaxe側で扱うためのextern定義
@:native(“Generator”)
extern class PhpGenerator
public function current(): TValue;
public function key(): TKey;
public function next(): Void;
public function valid(): Bool;
public function rewind(): Void;
}
次に、これをHaxeの`Iterable`として使いやすくするためのアダプタークラスを作る。
class PhpIteratorAdapter
var gen: PhpGenerator
public function new(gen: PhpGenerator
this.gen = gen;
// ループ開始前に巻き戻しが必要な場合がある
this.gen.rewind();
}
public inline function hasNext(): Bool return gen.valid();
public inline function next(): T {
var val = gen.current();
gen.next();
return val;
}
}
—
3. 実践：Composerパッケージとの連携
例えば、Composerでインストールしたライブラリがジェネレータを返す関数`fetchLargeData()`を持っているとしよう。Haxeからはこう呼び出すんだ。
// PHP側の想定コード: function fetchLargeData(): Generator
// Haxe側での呼び出し
class Main {
static function main() {
// 外部PHPライブラリから取得したGeneratorをキャスト
var rawGen: PhpGenerator
// アダプターを噛ませてHaxeのforループで回す
var iterator = new PhpIteratorAdapter(rawGen);
for (item in iterator) {
trace(‘処理中: $item’);
}
}
}
—
4. ここで陥りやすい「罠」を回避する
初心者がよくやるミスが2つある。ここをクリアすれば君はもう中級者だ。
1. `rewind()`の忘れ: PHPのジェネレータは一度しか走査できないものがある。もし`foreach`を2回回そうとしてエラーが出たら、それは生成元が使い捨て型だからだ。`Iterator`を扱う際は「一度切り」の特性を意識しよう。
2. `untyped __php__`の乱用: 外部ライブラリの型が不明な場合、`untyped`に頼りたくなる気持ちはわかる。しかし、できる限り`extern`を書いて型を定義してくれ。Haxeのコンパイラは型情報さえあれば、コンパイル時に最適化（インライン展開など）をかけてくれる。`untyped`は「Haxeの慈悲」を捨てる行為だ。
—
先輩からのメッセージ
Haxeが他の言語と決定的に違うのは、「ターゲット言語の仕様を、Haxeの抽象度まで引き上げて記述できる点」にある。
今回紹介したイテレータのアダプターは、単なるコードの繋ぎ合わせじゃない。それは、PHPという「動的で荒々しい世界」を、Haxeという「静的で理知的な世界」で包み込むための境界線（Boundary）なんだ。
ここをマスターすれば、PHPのレガシーな資産さえ、Haxeの最新の機能で美しくリファクタリングできるようになるはず。もし詰まったら、いつでも戻ってきてほしい。君が書くそのコードが、より強固なものになるよう、いつでも支えるよ。
さあ、次はどんな機能をHaxeの型システムで支配してみる？