English | 简体中文 | 繁體中文 | Русский язык | Français | Español | Português | Deutsch | 日本語 | 한국어 | Italiano | بالعربية

PHP 基础教程

PHP 高级教程

PHP & MySQL

PHP 参考手册

PHP extract() 函数用法及示例

دليل وظائف مصفوفة PHP

extract() 函数从数组中将变量导入到当前的符号表

语法

extract($array, $extract_type, $prefix)

定义和用法

此函数用于将变量从数组导入当前符号表。它采用一个关联数组数组,并将键视为变量名,将值视为变量值。对于每个键/值对,它将在当前符号表中创建一个变量,该变量受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 - تغطية القيم إذا كان هناك متغير يحمل الاسم نفسه في جدول الرموز الحالي. لا يتم معالجة الأسماء الأخرى. على سبيل المثال، يمكن أن تكون مفيدة في الحالات التالية: تعريف بعض المتغيرات الصالحة، ثم استيراد فقط هذه المتغيرات من $_REQUEST.

  • EXTR_PREFIX_IF_EXISTS - إنشاء اسم متغير مضاف إليه مقدمة فقط إذا كان هناك متغير يحمل الاسم نفسه في جدول الرموز الحالي. لا يتم معالجة الأسماء الأخرى.

  • EXTR_REFS - استخراج المتغيرات كمراجع. هذا يدل على أن المتغيرات المستوردة لا تزال تشير إلى قيمة مصفوفة المعامل. يمكن استخدام هذا العلامة وحدها أو دمجها مع أي علامة أخرى في flags.
    إذا لم يتم تحديد flags، يتم افتراض EXTR_OVERWRITE.

3

مقدمة (اختياري)

إذا تم استخدام EXTR_PREFIX_SAME، EXTR_PREFIX_ALL، EXTR_PREFIX_INVALID أو EXTR_PREFIX_IF_EXISTS في معامل extract_rules، فإن المقدمة المحددة مطلوبة.

يحدد هذا المعامل المقدمة. يتم فصل المقدمة باستخدام رمز السطر الفاصل تلقائيًا مع مفتاح المصفوفة.

القيمة المعدة

يعود عدد المتغيرات الناجحة التي تم استيرادها إلى جدول الرموز.

مثال عبر الإنترنت

 "أزرق", "size" => "متوسط", "shape" => "كرة");
   extract($input, EXTR_PREFIX_SAME, "bbcx");
   echo "$color, $size, $shape, $bbcx_size";
؟>
اختبار لرؤية‹/›

نتيجة الإخراج:

أزرق، كبير، كرة، متوسط

   دليل وظائف مصفوفة PHP