PHP マニュアル
前のページ | 第 19章クラスとオブジェクト (PHP 5) | 次のページ

# タイプヒンティング

PHP 5では、タイプヒンティング(Type Hinting)が導入されました。 これにより、関数は、 (クラスの名前を関数プロトタイプの中に指定することにより) パラメータをオブジェクトもしくは配列 (PHP5.1以降) が必ず指定されるようにすることができるようになりました。

例 19-41. タイプヒンティングの例
`<?php // とあるクラス class MyClass { /** * テスト関数 * * 第 1 引数は OtherClass 型のオブジェクトでなければならない */ public function test(OtherClass $otherclass) { echo $otherclass->var; } /** * もう一つのテスト関数 * * 第 1 引数は配列でなければならない */ public function test_array(array $input_array) { print_r($input_array); } } // もう一つのサンプルクラス class OtherClass { public $var = 'Hello World'; } ?>`
タイプヒントの指定を満たさないと致命的なエラーとなります。
`<?php // それぞれのクラスのインスタンス $myclass = new MyClass; $otherclass = new OtherClass; // Fatal Error: Argument 1 must be an object of class OtherClass $myclass->test('hello'); // Fatal Error: Argument 1 must be an instance of OtherClass $foo = new stdClass; $myclass->test($foo); // Fatal Error: Argument 1 must not be null $myclass->test(null); // Works: Prints Hello World $myclass->test($otherclass); // Fatal Error: Argument 1 must be an array $myclass->test_array('a string'); // 動作する: 配列の内容を表示する $myclass->test_array(array('a', 'b', 'c')); ?>`
タイプヒンティングは、関数でも使用できます。
`<?php // とあるクラス class MyClass { public $var = 'Hello World'; } /** * テスト関数 * * 第 1 引数は MyClass 型のオブジェクトでなければならない */ function MyFunction (MyClass $foo) { echo $foo->var; } // 動作する $myclass = new MyClass; MyFunction($myclass); ?>`

タイプヒントは、object型やarray型 (PHP5.1以降) でのみ使用できます。 int および stringのような 通常の型でのタイプヒンティングはサポートされません。

前のページ | ホーム | 次のページ
リフレクション | 上に戻る | 例外(exceptions)