الدالة print_r() في PHP
(PHP 4, PHP 5, PHP 7)
تطبع الدالة print_r() معلومات مقروءة من قبل الإنسان حول متغيّر ما.
الوصف
mixed print_r ( mixed $expression [, bool $return = FALSE ] )
تعرض الدالة print_r() معلومات حول المتغيّر بطريقة مقروءة من قبل الإنسان.
تُظهِر الدوال print_r()، و var_dump()، و var_export() أيضًا الخصائص المحميّة (protected) والخاصّة (private) للكائنات، ولكنّها لا تُظهِر الأعضاء الثابتة للصنف.
المعاملات
expression
التّعبير المُرَاد طباعته.
return
نستخدم المُعامِل return إذا كنّا نرغب بالتقاط خرج الدالة print_r(). عندما تكون قيمة المُعامِل return هي TRUE، فستُعيد هذه الدالة المعلومات بدلًا من طباعتها.
القيم المعادة
إن أعطينا الدالة سلسلة نصّيّة، أو عدد صحيح، أو عدد عشري فستطبع القيمة ذاتها، أمّا إن أعطيناها مصفوفة فستعرض القيم بتنسيق يُظهِر لنا المفاتيح والعناصر. وهو أمر مماثل لما يحدث مع الكائنات.
تُعيد هذه الدالة سلسلة نصّيّة إن كانت قيمة المُعامِل return هي TRUE، وتُعيد فيما عدا ذلك القيمة TRUE.
ملاحظات
عند استخدام المُعامِل return تستخدم هذه الدالة تخزين مؤقّت للخرج الداخلي بحيث لا يُمكِن استعمالها بداخل دالة الاستدعاء ob_start().
أمثلة
المثال 1: مثال على الدالة print_r()
<?php
$a = array ('a' => 'apple', 'b' => 'banana', 'c' => array ('x', 'y', 'z'));
print_r ($a);
?>
ينتج عن المثال السّابق ما يلي:
Array
(
[a] => apple
[b] => banana
[c] => Array
(
[0] => x
[1] => y
[2] => z
)
)
المثال 2: مثال على المُعامِل return
<?php
$b = array ('m' => 'monkey', 'foo' => 'bar', 'x' => array ('x', 'y', 'z'));
$results = print_r($b, true); // يحوي المتغيّر $results الآن خرج من هذه الدالة
?>
انظر أيضًا
- الدالة
ob_start(): تشغيل التخزين المؤقّت للخرج. - الدالة
var_dump(): استخلاص معلومات حول المتغيّر. - الدالة
var_export(): إعادة أو إخراج تمثيل سلسلة نصّيّة قابل للتحليل.