Menu Home

trim

osbo.com | PHP | Functions | trim

Strip whitespace (or other characters) from the beginning and end of a string

Syntax

trim ( string $str [, string $character_mask = " \t\n\r\0\x0B" ] ) : string

Parameters

str

The string that will be trimmed.

character_mask

Optionally, the stripped characters can also be specified using the character_mask parameter. Simply list all characters that you want to be stripped. With .. you can specify a range of characters. Without the character_mask parameter, trim() will strip these characters:

"\0" ASCII 0 (0x00) the NUL-byte
"\t" ASCII 9 (0x09) a tab
"\n" ASCII 10 (0x0A) a new line (line feed)
"\v" ASCII 11 (0x0B) a vertical tab
"\r" ASCII 13 (0x0D) a carriage return
" " ASCII 32 (0x20) an ordinary space

Return

The trimmed string.

Examples

str

<?

$str = "\0\t\n\v\r trim\x00\x09\x0A\x0B\x0D\x20";

$return = trim($str);

var_dump($str);
var_dump($return);

?>
string(16) "    

 trim    

 "
string(4) "trim"

character_mask | list

<?

$str = "\0\t\n\v\r trim\x00\x09\x0A\x0B\x0D\x20";
$character_mask = "\0\t\n\v\r mt";

$return = trim($str, $character_mask);

var_dump($str);
var_dump($return);

?>
string(16) "    

 trim    

 "
string(2) "ri"

character_mask | Range

<?

$str = "\0\t\n\v\r trim\x00\x09\x0A\x0B\x0D\x20";
$character_mask = "\x00..\x20mt";

$return = trim($str, $character_mask);

var_dump($str);
var_dump($return);

?>
string(16) "    

 trim    

 "
string(2) "ri"

PHP