الفرق بين المراجعتين لصفحة: «PHP/ltrim»
< PHP
هارون-بوكرش (نقاش | مساهمات) لا ملخص تعديل |
لا ملخص تعديل |
||
| سطر 2: | سطر 2: | ||
(PHP 4, PHP 5, PHP 7) | (PHP 4, PHP 5, PHP 7) | ||
تزيل الدالة ltrim() المسافات البيضاء (whitespace) (أي جميع محارف الفراغات) أو أي محرف آخر من بداية السلسلة النصيَّة الممررَّة إليها. | تزيل الدالة <code>ltrim()</code> المسافات البيضاء (whitespace) (أي جميع محارف الفراغات) أو أي محرف آخر من بداية السلسلة النصيَّة الممررَّة إليها. | ||
== الوصف == | |||
<syntaxhighlight lang="php"> | <syntaxhighlight lang="php"> | ||
string ltrim ( string $str [, string $character_mask ] ) | string ltrim ( string $str [, string $character_mask ] ) | ||
</syntaxhighlight>تزيل الدالة ltrim() المسافات البيضاء أو أي محرف آخر من بداية السلسلة النصيَّة str. | </syntaxhighlight>تزيل الدالة <code>ltrim()</code> المسافات البيضاء أو أي محرف آخر من بداية السلسلة النصيَّة <code>str</code>. | ||
== المعاملات == | |||
=== | === <code>str</code> === | ||
السلسلة النصيَّة التي ستجرى عليها العمليَّة. | السلسلة النصيَّة التي ستجرى عليها العمليَّة. | ||
=== | === <code>character_mask</code> === | ||
معامل اختياري، وهو يمثِّل جميع المحارف المراد إزالتها. يمكن استعمال النقطتين ".." لتحديد مجال من الأحرف. | معامل اختياري، وهو يمثِّل جميع المحارف المراد إزالتها. يمكن استعمال النقطتين ".." لتحديد مجال من الأحرف. | ||
== القيم المعادة == | |||
تعيد هذه الدالة السلسلة النصيَّة str بعد أن تزيل جميع المسافات البيضاء أو المحارف المحدَّدة ضمن المعامل الاختياري character_mask. إن لم يُمرَّر المعامل السابق، فستزيل الدالة المحارف التالية: | تعيد هذه الدالة السلسلة النصيَّة str بعد أن تزيل جميع المسافات البيضاء أو المحارف المحدَّدة ضمن المعامل الاختياري <code>character_mask</code>. إن لم يُمرَّر المعامل السابق، فستزيل الدالة المحارف التالية: | ||
* " ": محرف الفراغ وهو المحرف 32 (0x20) في الجدول ASCII. | * " ": محرف الفراغ وهو المحرف 32 (0x20) في الجدول ASCII. | ||
* "\t": محرف مسافة الجدولة (tab) وهو المحرف 9 (0x09) في جدول ASCII. | * "\t": محرف مسافة الجدولة (tab) وهو المحرف 9 (0x09) في جدول ASCII. | ||
| سطر 26: | سطر 26: | ||
* "\x0B": محرف مسافة الجدولة العموديَّة (vertical tab) وهو المحرف 11 (0x0B) في جدول ASCII. | * "\x0B": محرف مسافة الجدولة العموديَّة (vertical tab) وهو المحرف 11 (0x0B) في جدول ASCII. | ||
== أمثلة == | |||
المثال 1: مثال عن استعمال الدالة <code>ltrim()</code><syntaxhighlight lang="php"> | |||
<syntaxhighlight lang="php"> | |||
<?php | <?php | ||
$text = "\t\tThese are a few words :) ... "; | $text = "\t\tThese are a few words :) ... "; | ||
$binary = "\x09Example string\x0A"; | $binary = "\x09Example string\x0A"; | ||
$hello = "Hello World"; | $hello = "Hello World"; | ||
var_dump($text, $binary, $hello); | var_dump($text, $binary, $hello); | ||
print "\n"; | print "\n"; | ||
$trimmed = ltrim($text); | $trimmed = ltrim($text); | ||
var_dump($trimmed); | var_dump($trimmed); | ||
$trimmed = ltrim($text, " \t."); | $trimmed = ltrim($text, " \t."); | ||
var_dump($trimmed); | var_dump($trimmed); | ||
$trimmed = ltrim($hello, "Hdle"); | $trimmed = ltrim($hello, "Hdle"); | ||
var_dump($trimmed); | var_dump($trimmed); | ||
//ونهايته $binary من بداية قيمة المتغير ASCII إزالة محارف التحكم الموجودة في جدول | //ونهايته $binary من بداية قيمة المتغير ASCII إزالة محارف التحكم الموجودة في جدول | ||
// أي من المحرف 0 وحتى المحرف 31 | // أي من المحرف 0 وحتى المحرف 31 | ||
$clean = ltrim($binary, "\x00..\x1F"); | $clean = ltrim($binary, "\x00..\x1F"); | ||
var_dump($clean); | var_dump($clean); | ||
?> | ?> | ||
</syntaxhighlight>يُعيد المثال السابق ما يلي:<syntaxhighlight lang="php"> | </syntaxhighlight>يُعيد المثال السابق ما يلي:<syntaxhighlight lang="php"> | ||
string(32) " These are a few words :) ... " | string(32) " These are a few words :) ... " | ||
| سطر 86: | سطر 67: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
== انظر أيضًا == | |||
* trim(): تزيل المسافات البيضاء (whitespace) (أي جميع محارف الفراغات) أو أي محرف آخر من بداية ونهاية السلسلة النصيَّة المررَّة إليها. | * <code>[[PHP/trim|trim()]]</code>: تزيل المسافات البيضاء (whitespace) (أي جميع محارف الفراغات) أو أي محرف آخر من بداية ونهاية السلسلة النصيَّة المررَّة إليها. | ||
* rtrim(): تزيل المسافات البيضاء (whitespace) (أي جميع محارف الفراغات) أو أي محرف آخر من نهاية السلسلة النصيَّة المررَّة إليها. | * <code>[[PHP/rtrim|rtrim()]]</code>: تزيل المسافات البيضاء (whitespace) (أي جميع محارف الفراغات) أو أي محرف آخر من نهاية السلسلة النصيَّة المررَّة إليها. | ||
== مصادر == | |||
* صفحة الدالة ltrim في توثيق PHP الرسمي. | * [http://php.net/manual/en/function.ltrim.php صفحة الدالة ltrim في توثيق PHP الرسمي]. | ||
مراجعة 11:53، 6 أبريل 2018
(PHP 4, PHP 5, PHP 7)
تزيل الدالة ltrim() المسافات البيضاء (whitespace) (أي جميع محارف الفراغات) أو أي محرف آخر من بداية السلسلة النصيَّة الممررَّة إليها.
الوصف
string ltrim ( string $str [, string $character_mask ] )
تزيل الدالة ltrim() المسافات البيضاء أو أي محرف آخر من بداية السلسلة النصيَّة str.
المعاملات
str
السلسلة النصيَّة التي ستجرى عليها العمليَّة.
character_mask
معامل اختياري، وهو يمثِّل جميع المحارف المراد إزالتها. يمكن استعمال النقطتين ".." لتحديد مجال من الأحرف.
القيم المعادة
تعيد هذه الدالة السلسلة النصيَّة str بعد أن تزيل جميع المسافات البيضاء أو المحارف المحدَّدة ضمن المعامل الاختياري character_mask. إن لم يُمرَّر المعامل السابق، فستزيل الدالة المحارف التالية:
- " ": محرف الفراغ وهو المحرف 32 (0x20) في الجدول ASCII.
- "\t": محرف مسافة الجدولة (tab) وهو المحرف 9 (0x09) في جدول ASCII.
- "\n": محرف سطر جديد وهو المحرف 10 (0x0A) في جدول ASCII.
- "\r": محرف العودة إلى بداية السطر (carriage return) وهو المحرف 13 (0x0D) في جدول ASCII.
- "\0": المحرف NUL وهو المحرف 0 (0x00) في الجدول ASCII.
- "\x0B": محرف مسافة الجدولة العموديَّة (vertical tab) وهو المحرف 11 (0x0B) في جدول ASCII.
أمثلة
المثال 1: مثال عن استعمال الدالة ltrim()
<?php
$text = "\t\tThese are a few words :) ... ";
$binary = "\x09Example string\x0A";
$hello = "Hello World";
var_dump($text, $binary, $hello);
print "\n";
$trimmed = ltrim($text);
var_dump($trimmed);
$trimmed = ltrim($text, " \t.");
var_dump($trimmed);
$trimmed = ltrim($hello, "Hdle");
var_dump($trimmed);
//ونهايته $binary من بداية قيمة المتغير ASCII إزالة محارف التحكم الموجودة في جدول
// أي من المحرف 0 وحتى المحرف 31
$clean = ltrim($binary, "\x00..\x1F");
var_dump($clean);
?>
يُعيد المثال السابق ما يلي:
string(32) " These are a few words :) ... "
string(16) " Example string
"
string(11) "Hello World"
string(30) "These are a few words :) ... "
string(30) "These are a few words :) ... "
string(7) "o World"
string(15) "Example string
"
انظر أيضًا
trim(): تزيل المسافات البيضاء (whitespace) (أي جميع محارف الفراغات) أو أي محرف آخر من بداية ونهاية السلسلة النصيَّة المررَّة إليها.rtrim(): تزيل المسافات البيضاء (whitespace) (أي جميع محارف الفراغات) أو أي محرف آخر من نهاية السلسلة النصيَّة المررَّة إليها.