กำหนดค่าคีย์ "Cat", "Dog" และ "Horse" ให้กับตัวแปร $a, $b และ $c:
<?php $ a = " Original " ; $ my_array = array ( " a " = > " Cat " , " b " = > " Dog " , " c " = > " Horse " ) ; " $ a = $a ; $ b = $ b ; $ c = $c " ;ฟังก์ชัน extract() นำเข้าตัวแปรจากอาร์เรย์ไปยังตารางสัญลักษณ์ปัจจุบัน
ฟังก์ชันนี้ใช้ชื่อคีย์อาร์เรย์เป็นชื่อตัวแปร และใช้ค่าคีย์อาร์เรย์เป็นค่าตัวแปร สำหรับแต่ละองค์ประกอบในอาร์เรย์ ตัวแปรที่เกี่ยวข้องจะถูกสร้างขึ้นในตารางสัญลักษณ์ปัจจุบัน
ฟังก์ชันนี้จะส่งคืนจำนวนตัวแปรที่ตั้งค่าไว้สำเร็จ
แยก ( อาร์เรย์, extract_rules, คำนำหน้า )
| พารามิเตอร์ | อธิบาย |
|---|---|
| อาร์เรย์ | ที่จำเป็น. ระบุอาร์เรย์ที่จะใช้ |
| แยก_กฎ | ไม่จำเป็น. ฟังก์ชัน extract() จะตรวจสอบว่าชื่อคีย์แต่ละชื่อเป็นชื่อตัวแปรทางกฎหมายหรือไม่ และยังตรวจสอบว่าขัดแย้งกับชื่อตัวแปรที่มีอยู่ในตารางสัญลักษณ์หรือไม่ การจัดการชื่อคีย์ที่ผิดกฎหมายและขัดแย้งกันจะถูกกำหนดตามพารามิเตอร์นี้ ค่าที่เป็นไปได้: EXTR_OVERWRITE - ค่าเริ่มต้น หากมีข้อขัดแย้ง ตัวแปรที่มีอยู่จะถูกเขียนทับ EXTR_SKIP - อย่าเขียนทับตัวแปรที่มีอยู่หากมีข้อขัดแย้ง EXTR_PREFIX_SAME - นำหน้าชื่อตัวแปรด้วยคำนำหน้าหากมีข้อขัดแย้ง EXTR_PREFIX_ALL - เพิ่มคำนำหน้าให้กับชื่อตัวแปรทั้งหมด EXTR_PREFIX_INVALID - นำหน้าเฉพาะชื่อตัวแปรที่ผิดกฎหมายหรือตัวเลข EXTR_IF_EXISTS - เขียนทับค่าของตัวแปรที่มีชื่อเดียวกันเฉพาะเมื่อมีอยู่แล้วในตารางสัญลักษณ์ปัจจุบัน ส่วนอื่นๆ ไม่ได้รับการประมวลผล EXTR_PREFIX_IF_EXISTS - สร้างชื่อตัวแปรโดยเติมคำนำหน้าต่อท้ายเมื่อมีตัวแปรที่มีชื่อเดียวกันอยู่แล้วในตารางสัญลักษณ์ปัจจุบัน และจะไม่มีการประมวลผลอย่างอื่นอีก EXTR_REFS - แยกตัวแปรเป็นข้อมูลอ้างอิง ตัวแปรที่นำเข้ายังคงอ้างอิงค่าของพารามิเตอร์อาร์เรย์ |
| คำนำหน้า | ไม่จำเป็น. จำเป็นต้องมีคำนำหน้าหากค่าของพารามิเตอร์ extract_rules คือ EXTR_PREFIX_SAME, EXTR_PREFIX_ALL, EXTR_PREFIX_INVALID หรือ EXTR_PREFIX_IF_EXISTS พารามิเตอร์นี้ระบุคำนำหน้า ขีดล่างจะถูกเพิ่มโดยอัตโนมัติระหว่างคำนำหน้าและชื่อคีย์อาร์เรย์ |
| ค่าส่งคืน: | ส่งกลับจำนวนตัวแปรที่ตั้งค่าสำเร็จ |
|---|---|
| เวอร์ชัน PHP: | 4+ |
| บันทึกการอัปเดต: | ค่าของ extract_rules EXTR_REFS เป็นค่าใหม่ใน PHP 4.3 ค่าของ extract_rules EXTR_IF_EXISTS และ EXTR_PREFIX_IF_EXISTS เป็นค่าใหม่ใน PHP 4.2 ตั้งแต่ PHP 4.0.5 เป็นต้นไป ฟังก์ชันนี้จะส่งคืนจำนวนตัวแปรที่ตั้งค่าไว้สำเร็จ ค่าของ extract_rules EXTR_PREFIX_INVALID เป็นค่าใหม่ใน PHP 4.0.5 ตั้งแต่ PHP 4.0.5 ค่าของ extract_rules EXTR_PREFIX_ALL ยังมีตัวแปรตัวเลขด้วย |
ใช้พารามิเตอร์ทั้งหมด:
<?php$a = "Original";$my_array = array("a" => "Cat", "b" => "Dog", "c" => "Horse");extract($my_array, EXTR_PREFIX_SAME, "ซ้ำ");echo "$a = $a; $b = $b; $c = $c; $dup_a = $dup_a";?>