firestring_estr_chug(3) [debian man page]

firestring_estr_chug(3) 				     Library Functions Manual					   firestring_estr_chug(3)

NAME

       firestring_estr_chug - remove whitespace from the beginning of an estring

SYNOPSIS

       #include <firestring.h>
       -lfirestring

       void firestring_estr_chug(struct firestring_estr_t *string)

DESCRIPTION

       firestring_estr_chug shortens string by moving the start forward until the string begins with a non-whitespace character or is empty.

CAVEATS

       This  function moves the starting pointer inside string.  If string was allocated with firestring_estr_alloc(3), (as opposed to constructed
       manually pointing inside other memory), future calls to firestring_estr_free(3) will fail if this function trimmed any space from the start
       of the string.  In these cases, use firestring_estr_ip_chug(3) instead.

RETURN VALUE

       None.

AUTHOR

       Ian Gulliver <ian@penguinhosting.net>

SEE ALSO

       libfirestring(3)

								    2003-07-30						   firestring_estr_chug(3)

RTRIM(3)								 1								  RTRIM(3)

rtrim - Strip whitespace (or other characters) from the end of a string

SYNOPSIS

       string rtrim (string  $str, [string  $character_mask])

DESCRIPTION

	This function returns a string with whitespace stripped from the end of $str.

	Without the second parameter, rtrim(3) will strip these characters:

	      o " " (ASCII
		32 ( 0x20)), an ordinary space.

	      o "	" (ASCII
		9 ( 0x09)), a tab.

	      o "
" (ASCII
		10 ( 0x0A)), a new line (line feed).

	      o "
" (ASCII
		13 ( 0x0D)), a carriage return.

	      o "" (ASCII
		0 ( 0x00)), the NULL-byte.

	      o "x0B" (ASCII
		11 ( 0x0B)), a vertical tab.

PARAMETERS

	      o $str
		- The input string.

	      o $character_mask
		-  You	can  also  specify the characters you want to strip, by means of the $character_mask parameter. Simply list all characters
		that you want to be stripped. With .. you can specify a range of characters.

RETURN VALUES

	Returns the modified string.

EXAMPLES

       Example #1

	      Usage example of rtrim(3)

	      <?php

	      $text = "		These are a few words :) ...  ";
	      $binary = "x09Example stringx0A";
	      $hello  = "Hello World";
	      var_dump($text, $binary, $hello);

	      print "
";

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

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

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

	      // trim the ASCII control characters at the end of $binary
	      // (from 0 to 31 inclusive)
	      $clean = rtrim($binary, "x00..x1F");
	      var_dump($clean);

	      ?>

	      The above example will output:

	      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"

SEE ALSO

       trim(3), ltrim(3).

PHP Documentation Group 														  RTRIM(3)