grapheme_substr(3) [php man page]

GRAPHEME_SUBSTR(3)							 1							GRAPHEME_SUBSTR(3)

grapheme_substr - Return part of a string

       Procedural style

SYNOPSIS

       int grapheme_substr (string  $string, int  $start, [int	$length])

DESCRIPTION

	Return part of a string

PARAMETERS

	      o $string
		- The input string. Must be valid UTF-8.

	      o $start
		- Start position in default grapheme units. If $start is non-negative, the returned string will start at the $start'th position in
		$string, counting from zero. If $start is negative, the returned string will start at the $start'th grapheme unit from the end	of
		string.

	      o $length
		-  Length  in grapheme units. If $length is given and is positive, the string returned will contain at most $length grapheme units
		beginning from $start (depending on the length of string). If $length is given and is negative, then that many grapheme units will
		be  omitted  from  the	end of string (after the start position has been calculated when a start is negative). If $start denotes a
		position beyond this truncation, FALSE will be returned.

RETURN VALUES

	Returns the extracted part of $string.

CHANGELOG

       +--------+---------------------------------------------------+
       |Version |						    |
       |	|						    |
       |	|		     Description		    |
       |	|						    |
       +--------+---------------------------------------------------+
       |  5.4	|						    |
       |	|						    |
       |	|  If $length is given and positive and  the  argu- |
       |	| ment string is shorter than the specified length, |
       |	| all the rest of the string  according  to  $start |
       |	| parameter  is  returned.  Previously,  FALSE	was |
       |	| returned.					    |
       |	|						    |
       +--------+---------------------------------------------------+
EXAMPLES

       Example #1

	      grapheme_substr(3) example

	      <?php

	      $char_a_ring_nfd = "axCCx8A";  // 'LATIN SMALL LETTER A WITH RING ABOVE' (U+00E5) normalization form "D"
	      $char_o_diaeresis_nfd = "oxCCx88"; // 'LATIN SMALL LETTER O WITH DIAERESIS' (U+00F6) normalization form "D"

	      print urlencode(grapheme_substr( "ao" . $char_a_ring_nfd . "bc" . $char_o_diaeresis_nfd . "O", 2, -1 ));
	      ?>

       The above example will output:

       a%CC%8Abco%CC%88

SEE ALSO

       grapheme_extract(3),  Unicode Text Segmentation: Grapheme Cluster Boundaries .

PHP Documentation Group 													GRAPHEME_SUBSTR(3)

Check Out this Related Man Page

TRANSLITERATOR.TRANSLITERATE(3) 					 1					   TRANSLITERATOR.TRANSLITERATE(3)

Transliterator::transliterate - Transliterate a string

       Object oriented style

SYNOPSIS

       public string Transliterator::transliterate (string  $subject, [int  $start], [int  $end])

DESCRIPTION

       Procedural style
       transliterator_transliterate (mixed  $transliterator, string  $subject, [int  $start], [int  $end])

	Transforms a string or part thereof using an ICU transliterator.

PARAMETERS

	      o $transliterator
		- In the procedural version, either a Transliterator or a string from which a Transliterator can be built.

	      o $subject
		- The string to be transformed.

	      o $start
		-  The start index (in UTF-16 code units) from which the string will start to be transformed, inclusive. Indexing starts at 0. The
		text before will be left as is.

	      o $end
		- The end index (in UTF-16 code units) until which the string will be transformed, exclusive. Indexing starts at 0. The text after
		will be left as is.

RETURN VALUES

	The transfomed string on success, or FALSE on failure.

EXAMPLES

       Example #1

	      Converting escaped UTF-16 code units

	      <?php
	      $s = "u304Au65E9u3046u3054u3056u3044u307Eu3059";
	      echo transliterator_transliterate("Hex-Any/Java", $s), "
";

	      //now the reverse operation with a supplementary character
	      $supplChar = html_entity_decode('&#x1D11E;');
	      echo mb_strlen($supplChar, "UTF-8"), "
";
	      $encSupplChar = transliterator_transliterate("Any-Hex/Java", $supplChar);
	      //echoes two encoded UTF-16 code units
	      echo $encSupplChar, "
";
	      //and back
	      echo transliterator_transliterate("Hex-Any/Java", $encSupplChar), "
";
	      ?>

	      The above example will output something similar to:

	      1
	      uD834uDD1E

SEE ALSO

       Transliterator::getErrorMessage, Transliterator::__construct.

PHP Documentation Group 											   TRANSLITERATOR.TRANSLITERATE(3)

Linux and UNIX Man Pages

grapheme_substr(3) [php man page]

Check Out this Related Man Page