PHP - extract() 函式

extract($array, $extract_type, $prefix)

定義和用法

此函式用於將陣列中的變數匯入到當前符號表中。它接受一個關聯陣列 `array`，並將鍵視為變數名，值視為變數值。對於每個鍵值對，它將在當前符號表中建立一個變數，這取決於 `extract_type` 和 `prefix` 引數。

引數

序號	引數及說明
1	array (必需) 指定一個數組。
2	extract_type (可選) extract() 函式檢查無效的變數名和與現有變數名的衝突。此引數指定如何處理無效和衝突的名稱。可能的取值： EXTR_OVERWRITE - 預設值。發生衝突時，將覆蓋現有變數。 EXTR_SKIP - 發生衝突時，不覆蓋現有變數。 EXTR_PREFIX_SAME - 發生衝突時，變數名將被賦予字首。 EXTR_PREFIX_ALL - 所有變數名都將被賦予字首。 EXTR_PREFIX_INVALID - 只有無效或數字變數名將被賦予字首。 EXTR_IF_EXISTS - 只覆蓋當前符號表中已存在的變數，否則不執行任何操作。 EXTR_PREFIX_IF_EXISTS - 只有在當前符號表中存在相同的變數時才為變數新增字首。 EXTR_REFS - 將變數作為引用提取。匯入的變數仍然引用陣列引數的值。
3	prefix (可選) 如果在 `extract_rules` 引數中使用了 EXTR_PREFIX_SAME、EXTR_PREFIX_ALL、EXTR_PREFIX_INVALID 或 EXTR_PREFIX_IF_EXISTS，則需要指定字首。此引數指定字首。字首透過下劃線字元與陣列鍵自動分隔。

序號

引數及說明

array (必需)

指定一個數組。

extract_type (可選)

extract() 函式檢查無效的變數名和與現有變數名的衝突。此引數指定如何處理無效和衝突的名稱。可能的取值：

EXTR_OVERWRITE - 預設值。發生衝突時，將覆蓋現有變數。
EXTR_SKIP - 發生衝突時，不覆蓋現有變數。
EXTR_PREFIX_SAME - 發生衝突時，變數名將被賦予字首。
EXTR_PREFIX_ALL - 所有變數名都將被賦予字首。
EXTR_PREFIX_INVALID - 只有無效或數字變數名將被賦予字首。
EXTR_IF_EXISTS - 只覆蓋當前符號表中已存在的變數，否則不執行任何操作。
EXTR_PREFIX_IF_EXISTS - 只有在當前符號表中存在相同的變數時才為變數新增字首。
EXTR_REFS - 將變數作為引用提取。匯入的變數仍然引用陣列引數的值。

prefix (可選)

如果在 `extract_rules` 引數中使用了 EXTR_PREFIX_SAME、EXTR_PREFIX_ALL、EXTR_PREFIX_INVALID 或 EXTR_PREFIX_IF_EXISTS，則需要指定字首。

此引數指定字首。字首透過下劃線字元與陣列鍵自動分隔。

返回值

返回成功匯入到符號表中的變數數。

示例

嘗試以下示例：

線上演示

<?php
   $size = "large";
   $input = array("color" => "blue", "size"  => "medium", "shape" => "sphere");
   extract($input, EXTR_PREFIX_SAME, "bbcx");
   echo "$color, $size, $shape, $bbcx_size";
?>

這將產生以下結果：

blue, large, sphere, medium

php_function_reference.htm

列印頁面

PHP - extract() 函式

語法

定義和用法

引數

返回值

示例