قم بتعيين القيم الأساسية "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_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, "dup");echo "$a = $a; $b = $b; $c = $c; $dup_a = $dup_a";?>