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
1 · str
<? $str = "\0\t\n\v\r trim\x00\x09\x0A\x0B\x0D\x20"; $return = trim($str); var_dump($str, $return); ?>
string(16) " trim " string(4) "trim"
2 · 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, $return); ?>
string(16) " trim " string(2) "ri"
3 · 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, $return); ?>
string(16) " trim " string(2) "ri"
