print_r

(PHP 4, PHP 5)

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

説明

mixed print_r ( mixed expression [, bool return] )

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

print_r() は、解り易い形式で変数の値に関する 情報を表示します。stringinteger, float を指定した場合はその値が出力されます。 array を指定した場合、キーと要素を表す形式で値が 表示されます。object に関しても同様の表示形式となります。 print_r()var_dump() および var_export() は、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 の場合には結果を戻します。

注意: この関数は、 このパラメータに対して内部的に出力バッファリングを使用しています。 そのため、ob_start() コールバック関数の中で使用することはできません。

例 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() も参照ください。