سبد (0)

تابع ()extrac

تابع ()extrac 

PHP Array Referenceمرجع Arrayدر php

مثال (تابع ()extrac )

انتساب مقادیر "Cat" و "Dog" و "Horse" به متغیرهای a$ و b$ و c$ :

<?php
$a = "Original";
$my_array = array("a" => "Cat","b" => "Dog", "c" => "Horse");
extract($my_array);
echo "\$a = $a; \$b = $b; \$c = $c";
?>

Run example »

تعریف و کاربرد

تابع ()extract متغیرهای یک آرایه را به جدول نمادهای محلی وارد می کند. 

این تابع از کلیدهای آرایه، بعنوان نام متغیرها، و از مقادیر آرایه بعنوان مقادیر متغیرها استفاده می کند. برای هر عنصر، این تابع یک متغیر را در جدول نمادهای جاری ایجاد می کند. 

 این تابع، تعداد متغیرهایی که با موفقیت استخراج شده اند را برمی گرداند. 


نحوه نوشتن

extract(array,extract_rules,prefix)
ParameterDescription
array

ضروری. آرایه ی مورد استفاده را مشخص می کند. 

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 -متغیرها را بعنوان مراجع استخراج می کند. متغیرهای وارد شده هنوز مقادیر را از پارامتر آرایه دریافت می کنند.
prefix

اختیاری. اگر که

 EXTR_PREFIX_SAME, EXTR_PREFIX_ALL, EXTR_PREFIX_INVALID or EXTR_PREFIX_IF_EXISTS 

در پارامتر extract_rules استفاده شوند، یک پیشوند خاص ضروری خواهد بود.
این پارامتر، پیشوند مورد نظر را مشخص می کند. این پیشوند به طور  اتوماتیک با یک  کاراکتر underscore از آرایه ی مورد نظر، جدا می شود.

جزئیات تکنیکی

مقدار برگشتی:

تعداد متغیرهایی که با موفقیت استخراج شده اند را مشخص می کند.

ورژن php: 4+
تغییرات:

مقدار EXTR_REFS از EXTRACT_RULES در PHP 4.3 اضافه شده است.


مقدار EXTR_IF_EXISTS و EXTR_PREFIX_IF_EXISTS در PHP 4.2 اضافه شده است.
از PHP 4.0.5 به بعد، این تابع تعداد متغیرهای استخراج شده را برمی گرداند.
مقدار EXTR_PREFIX_INVALID از extract_rules در PHP 4.0.5 اضافه شده است.

از php 4.0.5 به بعد، مقدار EXTR_PREFIX_ALL از extract_rules متغیر های عددی را به خوبی اضافه می کند.

مثال های بیشتر

مثال (تابع ()extrac )

استفاده از تمام پارامترها:

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

Run example »

PHP Array Referenceمرجع Array در php

تمامی محصولات و خدمات این وبسایت، حسب مورد دارای مجوزهای لازم از مراجع مربوطه می‌باشند و فعالیت‌های این سایت تابع قوانین و مقررات جمهوری اسلامی ایران است.
logo-samandehi مجوز نشر دیجیتال از وزرات فرهنگ و ارشاد اسلامی پرداخت آنلاین -  بانک ملت معرفی بیاموز در شبکه سه