الدالة rtrim()‎ في PHP

(PHP 4, PHP 5, PHP 7)

تزيل الدالة rtrim()‎ المسافات البيضاء (whitespace) (أي جميع محارف الفراغات) أو أي محرف آخر من نهاية السلسلة النصيَّة المررَّة إليها.

الوصف

string rtrim ( string $str [, string $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.

المعاملات

str

السلسلة النصيَّة التي ستجرى عليها العمليَّة.

character_mask

معامل اختياري، وهو يمثِّل جميع المحارف المراد إزالتها. يمكن استعمال النقطتين ".." لتحديد مجال من الأحرف.

القيم المعادة

تعيد الدالة rtrim()‎ السلسلة النصية المعدَّلة.

أمثلة

المثال 1: مثال على استخدام الدالة rtrim()‎

<?php

$text = "\t\tThese are a few words :) ...  ";
$binary = "\x09Example string\x0A";
$hello  = "Hello World";
var_dump($text, $binary, $hello);

print "\n";

$trimmed = rtrim($text);
var_dump($trimmed);

$trimmed = rtrim($text, " \t.");
var_dump($trimmed);

$trimmed = rtrim($hello, "Hdle");
var_dump($trimmed);

//ونهايته $binary من بداية قيمة المتغير ASCII إزالة محارف التحكم الموجودة في جدول
// أي من المحرف 0 وحتى المحرف 31

$clean = rtrim($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(26) "        These are a few words :)"
string(9) "Hello Wor"
string(15) "    Example string"

انظر أيضًا

• الدالة trim()‎: تحذف المسافات البيضاء (أو الأحرف الأخرى) من بداية ونهاية السلسلة النصية.
• الدالة ltrim()‎: تحذف المسافات البيضاء (أو الأحرف الأخرى) من بداية السلسلة النصية.

مصادر

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