extract

參數

描述

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 時需要。如果附加了前綴後的結果不是合法的變量名，將不會導入到符號表中。

前綴和數組鍵名之間會自動加上一個下劃線。

當發生衝突是覆蓋已有變量

當發生衝突時跳過一個元素

當發生衝突時創建一個名為$prefix_key的變量。必須提供prefix參數

在所有變量的名稱之前加上由prefix參數的指定值。必須提供prefix參數

使用指定的prefix在可能無效的變量名稱之前加上前綴（例如，數字變量的名稱。）必須提供prefix參數

知識提取存在的變量（也就是，用數組中的值覆蓋已有的變量值）。這個參數對於數組到變量的轉換時非常有用，例如，$_REQUEST到一個有效的變量集合的轉換

只有在不帶前綴的變量存在的情況下，創建帶有前綴的變量。這個值是在4.2.0版本中新增加的

已飲用方式提取變量

<?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

<?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;