PHP extract() 函式

lankecms發表於2014-11-15
PHP函式

定義和用法

PHP extract() 函式從陣列中把變數匯入到當前的符號表中。

對於陣列中的每個元素，鍵名用於變數名，鍵值用於變數值。

第二個引數 type 用於指定當某個變數已經存在，而陣列中又有同名元素時，extract() 函式如何對待這樣的衝突。

本函式返回成功設定的變數數目。

語法

extract(array,extract_rules,prefix)
引數 描述
array 必需。規定要使用的輸入。
extract_rules

可選。extract() 函式將檢查每個鍵名是否為合法的變數名，同時也檢查和符號表中的變數名是否衝突。

對非法、數字和衝突的鍵名的處理將根據此引數決定。可以是以下值之一：

可能的值：

  • EXTR_OVERWRITE - 預設。如果有衝突，則覆蓋已有的變數。
  • EXTR_SKIP - 如果有衝突，不覆蓋已有的變數。（忽略陣列中同名的元素）
  • EXTR_PREFIX_SAME - 如果有衝突，在變數名前加上字首 prefix。自 PHP 4.0.5 起，這也包括了對數字索引的處理。
  • EXTR_PREFIX_ALL - 給所有變數名加上字首 prefix（第三個引數）。
  • EXTR_PREFIX_INVALID - 僅在非法或數字變數名前加上字首 prefix。本標記是 PHP 4.0.5 新加的。
  • EXTR_IF_EXISTS - 僅在當前符號表中已有同名變數時，覆蓋它們的值。其它的都不處理。可以用在已經定義了一組合法的變數，然後要從一個陣列例如 $_REQUEST 中提取值覆蓋這些變數的場合。本標記是 PHP 4.2.0 新加的。
  • EXTR_PREFIX_IF_EXISTS - 僅在當前符號表中已有同名變數時，建立附加了字首的變數名，其它的都不處理。本標記是 PHP 4.2.0 新加的。
  • EXTR_REFS - 將變數作為引用提取。這有力地表明瞭匯入的變數仍然引用了 var_array 引數的值。可以單獨使用這個標誌或者在 extract_type 中用 OR 與其它任何標誌結合使用。本標記是 PHP 4.3.0 新加的。
prefix

可選。請注意 prefix 僅在 extract_type 的值是 EXTR_PREFIX_SAME，EXTR_PREFIX_ALL，EXTR_PREFIX_INVALID 或 EXTR_PREFIX_IF_EXISTS 時需要。如果附加了字首後的結果不是合法的變數名，將不會匯入到符號表中。

字首和陣列鍵名之間會自動加上一個下劃線。

例子 1

<?php
$a = 'Original';
$my_array = array("a" => "Cat","b" => "Dog", "c" => "Horse");
extract($my_array);
echo "\$a = $a; \$b = $b; \$c = $c";
?>

輸出：

$a = Cat; $b = Dog; $c = Horse

例子 2

使用全部引數：

<?php
$a = 'Original';
$my_array = array("a" => "Cat","b" => "Dog", "c" => "Horse");

extract($my_array, EXTR_PREFIX_SAME, 'dup');

echo "\$a = $a; \$b = $b; \$c = $c; \$dup_a = $dup_a;";
?>

輸出：

$a = Original; $b = Dog; $c = Horse; $dup_a = Cat;


相關文章