الفرق بين المراجعتين لصفحة: «PHP/str pad»
< PHP
أضفت المحتوى |
لا ملخص تعديل |
||
| (1 مراجعات متوسطة بواسطة نفس المستخدم غير معروضة) | |||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE:الدالة <code>str_pad()</code> في PHP}}</noinclude> | |||
(PHP 4 >= 4.0.1, PHP 5, PHP 7) | (PHP 4 >= 4.0.1, PHP 5, PHP 7) | ||
تحشو الدالة str_pad() سلسلة نصية بطولٍ معين باستعمال سلسلة نصية أخرى. | تحشو الدالة <code>str_pad()</code> سلسلة نصية بطولٍ معين باستعمال سلسلة نصية أخرى. | ||
== الوصف == | == الوصف == | ||
<syntaxhighlight lang="php"> | <syntaxhighlight lang="php"> | ||
string str_pad ( string $input , int $pad_length [, string $pad_string = " " [, int $pad_type = STR_PAD_RIGHT ]] ) | string str_pad ( string $input , int $pad_length [, string $pad_string = " " [, int $pad_type = STR_PAD_RIGHT ]] ) | ||
</syntaxhighlight>تحشو الدالة str_pad() قيمة المعامل input وتضيفها على اليسار أو اليمين أو على كلي الجانبين حتى تصل إلى الطول المحدد. إذا لم تُوَفَّر قيمة الوسيط الاختياري | </syntaxhighlight>تحشو الدالة <code>str_pad()</code> قيمة المعامل <code>input</code> وتضيفها على اليسار أو اليمين أو على كلي الجانبين حتى تصل إلى الطول المحدد. إذا لم تُوَفَّر قيمة الوسيط الاختياري <code>pad_string</code>، فستحشى السلسلة النصية <code>input</code> بمسافات، وإلا فإنها ستحشى بأحرف من <code>pad_string</code> حتى نهايتها. | ||
== المعاملات == | == المعاملات == | ||
=== input === | === <code>input</code> === | ||
السلسلة النصية المدخلة. | السلسلة النصية المدخلة. | ||
=== pad_length === | === <code>pad_length</code> === | ||
إذا كانت قيمة المعامل pad_length سالبةً أو أقل من أو تساوي طول سلسلة الإدخال، فلن يحدث أي حشو، وستعاد قيمة المعامل input. | إذا كانت قيمة المعامل <code>pad_length</code> سالبةً أو أقل من أو تساوي طول سلسلة الإدخال، فلن يحدث أي حشو، وستعاد قيمة المعامل <code>input</code>. | ||
=== pad_string === | === <code>pad_string</code> === | ||
السلسلة النصية التي ستُستعمَل لحشو السلسلة input. | السلسلة النصية التي ستُستعمَل لحشو السلسلة <code>input</code>. | ||
لاحظ أنَّه قد تُقتَطع قيمة المعامل pad_string إذا كان العدد المطلوب من أحرف الحشو لا يمكن تقسيمه بالتساوي على طول المعامل pad_string. | لاحظ أنَّه قد تُقتَطع قيمة المعامل <code>pad_string</code> إذا كان العدد المطلوب من أحرف الحشو لا يمكن تقسيمه بالتساوي على طول المعامل <code>pad_string</code>. | ||
=== pad_type === | === <code>pad_type</code> === | ||
يمكن للوسيط الاختياري pad_type أن يكون STR_PAD_RIGHT أو STR_PAD_LEFT أو STR_PAD_BOTH. إذا لم تحدد قيمة الوسيط pad_type فسيفترض أن تكون STR_PAD_RIGHT. | يمكن للوسيط الاختياري <code>pad_type</code> أن يكون <code>STR_PAD_RIGHT</code> أو <code>STR_PAD_LEFT</code> أو <code>STR_PAD_BOTH</code>. إذا لم تحدد قيمة الوسيط <code>pad_type</code> فسيفترض أن تكون <code>STR_PAD_RIGHT</code>. | ||
== القيم المعادة == | == القيم المعادة == | ||
تعيد الدالة str_pad() سلسلةً نصيةً بعد حشوها. | تعيد الدالة <code>str_pad()</code> سلسلةً نصيةً بعد حشوها. | ||
== أمثلة == | == أمثلة == | ||
المثال 1: مثال على الدالة str_pad()<syntaxhighlight lang="php"> | المثال 1: مثال على الدالة <code>str_pad()</code><syntaxhighlight lang="php"> | ||
<?php | <?php | ||
$input = "Alien"; | $input = "Alien"; | ||
echo str_pad($input, 10); // ينتج "Alien " | echo str_pad($input, 10); // ينتج "Alien " | ||
echo str_pad($input, 10, "-=", STR_PAD_LEFT); // ينتج "-=-=-Alien" | echo str_pad($input, 10, "-=", STR_PAD_LEFT); // ينتج "-=-=-Alien" | ||
echo str_pad($input, 10, "_", STR_PAD_BOTH); // ينتج "__Alien___" | echo str_pad($input, 10, "_", STR_PAD_BOTH); // ينتج "__Alien___" | ||
echo str_pad($input, 6, "___"); // ينتج "Alien_" | echo str_pad($input, 6, "___"); // ينتج "Alien_" | ||
echo str_pad($input, 3, "*"); // ينتج "Alien" | echo str_pad($input, 3, "*"); // ينتج "Alien" | ||
?> | ?> | ||
</syntaxhighlight> | </syntaxhighlight> | ||
| سطر 50: | سطر 42: | ||
== مصادر == | == مصادر == | ||
* [http://php.net/manual/en/function.str-pad.php صفحة الدالة str_pad في توثيق PHP الرسمي.] | * [http://php.net/manual/en/function.str-pad.php صفحة الدالة str_pad في توثيق PHP الرسمي.] | ||
[[تصنيف:PHP]] | |||
[[تصنيف:PHP Function]] | |||
[[تصنيف:PHP String]] | |||
المراجعة الحالية بتاريخ 12:41، 9 أبريل 2018
(PHP 4 >= 4.0.1, PHP 5, PHP 7)
تحشو الدالة str_pad() سلسلة نصية بطولٍ معين باستعمال سلسلة نصية أخرى.
الوصف
string str_pad ( string $input , int $pad_length [, string $pad_string = " " [, int $pad_type = STR_PAD_RIGHT ]] )
تحشو الدالة str_pad() قيمة المعامل input وتضيفها على اليسار أو اليمين أو على كلي الجانبين حتى تصل إلى الطول المحدد. إذا لم تُوَفَّر قيمة الوسيط الاختياري pad_string، فستحشى السلسلة النصية input بمسافات، وإلا فإنها ستحشى بأحرف من pad_string حتى نهايتها.
المعاملات
input
السلسلة النصية المدخلة.
pad_length
إذا كانت قيمة المعامل pad_length سالبةً أو أقل من أو تساوي طول سلسلة الإدخال، فلن يحدث أي حشو، وستعاد قيمة المعامل input.
pad_string
السلسلة النصية التي ستُستعمَل لحشو السلسلة input.
لاحظ أنَّه قد تُقتَطع قيمة المعامل pad_string إذا كان العدد المطلوب من أحرف الحشو لا يمكن تقسيمه بالتساوي على طول المعامل pad_string.
pad_type
يمكن للوسيط الاختياري pad_type أن يكون STR_PAD_RIGHT أو STR_PAD_LEFT أو STR_PAD_BOTH. إذا لم تحدد قيمة الوسيط pad_type فسيفترض أن تكون STR_PAD_RIGHT.
القيم المعادة
تعيد الدالة str_pad() سلسلةً نصيةً بعد حشوها.
أمثلة
المثال 1: مثال على الدالة str_pad()
<?php
$input = "Alien";
echo str_pad($input, 10); // ينتج "Alien "
echo str_pad($input, 10, "-=", STR_PAD_LEFT); // ينتج "-=-=-Alien"
echo str_pad($input, 10, "_", STR_PAD_BOTH); // ينتج "__Alien___"
echo str_pad($input, 6, "___"); // ينتج "Alien_"
echo str_pad($input, 3, "*"); // ينتج "Alien"
?>