الفرق بين المراجعتين ل"PHP/str pad"
< PHP
اذهب إلى التنقل
اذهب إلى البحث
| سطر 2: | سطر 2: | ||
(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> | ||
المراجعة الحالية بتاريخ 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"
?>