print_r

(PHP 4, PHP 5)

print_r --  指定した変数に関する情報を解りやすく出力する

説明

bool print_r ( mixed expression [, bool return] )

注意: return引数が PHP 4.3.0 以降追加されました。

print_r()は、解り易い形式で変数の値に関する情 報を表示します。string, integer, floatを指定した場合はその値が出力されます。 arrayを指定した場合、キーと要素を表す形式で値が表示 されます。objectに関しても同様の表示形式となります。 print_r()var_export()var_dump()と違い、 PHP 5においてオブジェクトのprotected及びprivateのプロパティも表示します。

print_r()は、配列ポインタを終端まで移動するこ とに注意してください。ポインタを最初に戻すために reset()を使用してください。

<pre>
<?php
    $a
= array ('a' => 'apple', 'b' => 'banana', 'c' => array ('x','y','z'));
    
print_r ($a);
?>
</pre>

出力は次のようになります:
<pre>
Array
(
    [a] => apple
    [b] => banana
    [c] => Array
        (
            [0] => x
            [1] => y
            [2] => z
        )
)
</pre>

print_r()の結果をキャプチャしたい場合には return引数を試用してください。 print_r()はデフォルトでは結果を直接表示してしまいますが この引数が TRUE の場合には結果を戻します。

例 1. return 引数の例

<?php
    $b
= array ('m' => 'monkey', 'foo' => 'bar', 'x' => array ('x', 'y', 'z'));
    
$results = print_r($b, true); //$results now contains output from print_r
?>

注意: PHP4.3.0より前のバージョンを使っている場合で print_r()の結果をキャプチャしたい場合には、 出力制御関数を使用してください。

注意: PHP 4.0.4より前のバージョンでは、自分自身への直接または間接の参 照を含むarrayまたはobjectが指定された 場合には、無限にprint_r()が実行されてしまいま した。print_r($GLOBALS)が例で、 $GLOBALSはそれ自体自分自身への参照を有するグ ローバル変数です。

ob_start(), var_dump(), var_export()も参照ください。