الفرق بين المراجعتين لصفحة: «PHP/print r»

المراجعة الحالية بتاريخ 03:07، 18 أبريل 2018

(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()‎‎: إعادة أو إخراج تمثيل سلسلة نصّيّة قابل للتحليل.

مصادر

صفحة الدالة print_r في توثيق PHP الرسمي.

@@ سطر 1: / سطر 1: @@
 <noinclude>{{DISPLAYTITLE:الدالة <code>print_r()</code>‎ في PHP}}</noinclude>
+(PHP 4, PHP 5, PHP 7)
+تطبع الدالة <code>print_r()</code>‎‎‎‎‎‎‎‎‎‎‎‎‎‎ معلومات مقروءة من قبل الإنسان حول متغيّر ما.
+== الوصف ==
+<syntaxhighlight lang="php">
+mixed print_r ( mixed $expression [, bool $return = FALSE ] )
+</syntaxhighlight>تعرض الدالة <code>print_r()</code>‎ معلومات حول المتغيّر بطريقة مقروءة من قبل الإنسان.
+تُظهِر الدوال <code>print_r()</code>‎، و <code>[[PHP/var dump|var_dump()]]</code>‎، و <code>[[PHP/var export|var_export()]]</code>‎ أيضًا الخصائص المحميّة (protected) والخاصّة (private) للكائنات، ولكنّها لا تُظهِر الأعضاء الثابتة للصنف.
+== المعاملات ==
+=== <code>expression</code> ===
+التّعبير المُرَاد طباعته.
+=== <code>return</code> ===
+نستخدم المُعامِل <code>return</code> إذا كنّا نرغب بالتقاط خرج الدالة <code>print_r()</code>‎. عندما تكون قيمة المُعامِل <code>return</code> هي <code>TRUE</code>، فستُعيد هذه الدالة المعلومات بدلًا من طباعتها.
+== القيم المعادة ==
+إن أعطينا الدالة [[PHP/string|سلسلة نصّيّة]]، أو [[PHP/integer|عدد صحيح]]، أو [[PHP/float|عدد عشري]] فستطبع القيمة ذاتها، أمّا إن أعطيناها مصفوفة فستعرض القيم بتنسيق يُظهِر لنا المفاتيح والعناصر. وهو أمر مماثل لما يحدث مع الكائنات.
+تُعيد هذه الدالة [[PHP/string|سلسلة نصّيّة]] إن كانت قيمة المُعامِل <code>return</code> هي <code>TRUE</code>، وتُعيد فيما عدا ذلك القيمة <code>TRUE</code>.
+== ملاحظات ==
+عند استخدام المُعامِل <code>return</code> تستخدم هذه الدالة تخزين مؤقّت للخرج الداخلي بحيث لا يُمكِن استعمالها بداخل دالة الاستدعاء <code>[[PHP/ob start|ob_start()]]</code>‎.
+== أمثلة ==
+المثال 1: مثال على الدالة <code>print_r()‎</code><syntaxhighlight lang="php">
+<?php
+$a = array ('a' => 'apple', 'b' => 'banana', 'c' => array ('x', 'y', 'z'));
+print_r ($a);
+?>
+</syntaxhighlight>ينتج عن المثال السّابق ما يلي:<syntaxhighlight lang="text">
+Array
+(
+    [a] => apple
+    [b] => banana
+    [c] => Array
+        (
+            [0] => x
+            [1] => y
+            [2] => z
+        )
+)
+</syntaxhighlight>المثال 2: مثال على المُعامِل <code>return</code><syntaxhighlight lang="php">
+<?php
+$b = array ('m' => 'monkey', 'foo' => 'bar', 'x' => array ('x', 'y', 'z'));
+$results = print_r($b, true); // يحوي المتغيّر $results الآن خرج من هذه الدالة
+?>
+</syntaxhighlight>
+== انظر أيضًا ==
+* الدالة <code>[[PHP/ob start|ob_start()‎]]</code>‎: تشغيل التخزين المؤقّت للخرج.
+* الدالة <code>[[PHP/var dump|var_dump()‎]]</code>‎: استخلاص معلومات حول المتغيّر.
+* الدالة <code>[[PHP/var export|var_export()‎]]</code>‎: إعادة أو إخراج تمثيل سلسلة نصّيّة قابل للتحليل.
+== مصادر ==
+* [http://php.net/manual/en/function.print-r.php صفحة الدالة print_r في توثيق PHP الرسمي].
+[[تصنيف:PHP]]
+[[تصنيف:PHP Function]]
+[[تصنيف:PHP Variable Handling]]