print_r

(PHP 4, PHP 5)

print_r --  列印關於變量的易於理解的訊息。

描述

bool print_r ( mixed expression [, bool return] )

注: 參數 return 是在 PHP 4.3.0 的時候加上的

print_r() 顯示關於一個變量的易於理解的訊息。若果給出的是 stringintegerfloat,將列印變量值本身。若果給出的是 array,將會按照一定格式顯示鍵和元素。object 與陣列類似。

記住,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 參數。若此參數設為 TRUEprint_r() 將不列印結果(此為預設動作),而是返回其輸出。

例子 1. return 參數示例

<?php
    $b 
= array ('m' => 'monkey''foo' => 'bar''x' => array ('x''y''z'));
    
$results print_r ($btrue); //$results 包括了 print_r 的輸出結果
?>

注: 若果想在 PHP 4.3.0 之前的版本中捕捉 print_r() 的輸出,可使用輸出控制函數

注: 在 PHP 4.0.4 之前的版本中,若果給出的 arrayobject 包括了直接或間接指向自身的引用,print_r() 將永遠繼續下去。print_r($GLOBALS) 就是一個例子,因為 $GLOBALS 自身即是全局變量,其包括了指向自身的引用。

參見 ob_start()var_dump()var_export()