こんにちは。Haxeの深淵へようこそ。
クロスプラットフォーム言語であるHaxeの真骨頂は、ターゲット言語の「泥臭い部分」を「エレガントな抽象」で覆い隠すことにあります。特にPHPターゲットは、Haxeの強力な静的型付けと、PHPの柔軟な配列操作を融合させる絶好の遊び場です。
今日は、PHPの強力な組み込み関数群（`array_map`や`array_filter`など）を、Haxeの洗練されたイテレータAPIとして再定義する「極意」を伝授しましょう。
—
なぜ、わざわざ「再定義」するのか？
PHPの配列関数は強力ですが、致命的な欠点があります。それは「型安全性の欠如」と「引数の並びの不一致」です。
- PHP: `array_map(callable, array)`
- Haxe: `iterable.map(func)`
この「関数が先か、データが先か」の違いは、メソッドチェーンを構築する際に大きなストレスになります。これをHaxeの`Abstract`（抽象型）と`extern`の力で、シームレスに繋げてしまいましょう。
—
1. PHP関数の「型」を定義する
まず、PHPの関数をHaxeから安全に呼び出すための定義を行います。`php.Syntax`や`php.Lib`を直接叩くのではなく、マクロで型を強制するのが通のやり方です。
package php.util;
import php.NativeArray;
/
- PHPの配列関数を静的型付けでラップするクラス
/
class PhpArrayTools {
// array_mapを型安全にラップ
public static function map
return untyped __php__(“array_map($callback, $arr)”);
}
// array_filterを型安全にラップ
public static function filter
return untyped __php__(“array_filter($arr, $callback)”);
}
}
—
2. 抽象型（Abstract）で「Haxeらしさ」を注入する
ここからが本題です。Haxeの`Abstract`を使い、PHPの配列を「Haxeのイテレータのように振る舞わせる」魔法をかけます。
package php.util;
import php.NativeArray;
@:forward
abstract PhpArray
// PHPのarray_mapを「メソッド」として生やす
public inline function map(f:T->U):PhpArray {
return PhpArrayTools.map(this, f);
}
// PHPのarray_filterを「メソッド」として生やす
public inline function filter(f:T->Bool):PhpArray
return PhpArrayTools.filter(this, f);
}
}
このコードの「賢さ」：
- `@:forward`: これをつけることで、`NativeArray`が本来持っているアクセス機能（`arr[0]`など）をそのまま保持できます。
- `inline`: コンパイル時にこの関数呼び出しは消滅し、直接PHPの関数呼び出しに置換されます。パフォーマンスのオーバーヘッドはゼロです。
—
3. 実践：直感的なコードを書く
これで、PHPの配列がHaxeの関数型APIのように使えるようになりました。
import php.util.PhpArray;
class Main {
static function main() {
// PHPのネイティブ配列を定義
var numbers:PhpArray
// メソッドチェーンで操作
var result = numbers
.filter(x -> x % 2 != 0) // 奇数のみ抽出
.map(x -> x 10); // 10倍にする
// 結果は [10, 30, 50] となる
trace(result);
}
}
これこそがHaxeの醍醐味です。PHPという実行環境を、Haxeのモダンなシンタックスで支配下に置く。これなら、他の言語から来た方も違和感なく書けるはずですよね。
—
陥りやすい罠と対策
1. 戻り値の型不一致
PHPの`array_filter`は、キーを保持します。もしリスト（添字配列）として扱いたい場合は、最後に `array_values()` を通す必要があります。
- 対策: `filter`関数の最後に `return array_values(…)` を挟むラッパーを書くのが現場の定石です。
2. コンパイル時と実行時の境界
`untyped __php__` は強力ですが、PHP側の変数名やスコープを汚染する可能性があります。必ず`inline`を活用し、ローカルスコープ内で完結するように設計してください。
—
最後に：Haxeを使いこなすということ
Haxeを単なる「PHPトランスパイラ」として使うのはもったいない。今回紹介したような「抽象化のレイヤー」を一枚噛ませるだけで、コードの保守性は劇的に向上します。
「PHPの配列操作が面倒だ」と嘆くのではなく、「どうすれば自分の使いやすいインターフェースに変換できるか」を考える。その思考法こそが、Haxeを掌握する第一歩です。
ここをクリアしたあなたなら、もうHaxeの基本はバッチリマスターできています。次は、マクロを使ってこの「ラッパーの自動生成」に挑戦してみるのも面白いかもしれませんよ。
それでは、素晴らしいHaxeライフを！