grapheme_stripos(3) [php man page]

GRAPHEME_STRIPOS(3)							 1						       GRAPHEME_STRIPOS(3)

grapheme_stripos - Find position (in grapheme units) of first occurrence of a case-insensitive string

       Procedural style

SYNOPSIS

       int grapheme_stripos (string  $haystack, string	$needle, [int  $offset])

DESCRIPTION

	Find position (in grapheme units) of first occurrence of a case-insensitive string

PARAMETERS

	      o $haystack
		- The string to look in. Must be valid UTF-8.

	      o $needle
		- The string to look for. Must be valid UTF-8.

	      o $offset
		-  The	optional  $offset parameter allows you to specify where in haystack to start searching as an offset in grapheme units (not
		bytes or characters). The position returned is still relative to the beginning of haystack regardless of the value of $offset.

RETURN VALUES

	Returns the position as an integer. If needle is not found, grapheme_stripos() will return boolean FALSE.

EXAMPLES

       Example #1

	      grapheme_stripos(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"
	      $char_O_diaeresis_nfd = "OxCCx88"; // 'LATIN CAPITAL LETTER O WITH DIAERESIS' (U+00D6) normalization form "D"

	      print grapheme_stripos( $char_a_ring_nfd . $char_a_ring_nfd . $char_o_diaeresis_nfd, $char_O_diaeresis_nfd);

	      ?>

       The above example will output:

       2

SEE ALSO

       grapheme_stristr(3),  grapheme_strpos(3),  grapheme_strripos(3),  grapheme_strrpos(3),  grapheme_strstr(3),   Unicode  Text   Segmentation:
       Grapheme Cluster Boundaries .

PHP Documentation Group 												       GRAPHEME_STRIPOS(3)

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)