php man page for grapheme_strpos

GRAPHEME_STRPOS(3)							 1							GRAPHEME_STRPOS(3)

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

       Procedural style

SYNOPSIS
       int grapheme_strpos (string  $haystack, string  $needle, [int  $offset])

DESCRIPTION
	Find position (in grapheme units) of first occurrence of a 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, strpos() will return boolean FALSE.

EXAMPLES
       Example #1

	      grapheme_strpos(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 grapheme_strpos( $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_stripos(3),  grapheme_stristr(3),  grapheme_strripos(3),  grapheme_strrpos(3),	grapheme_strstr(3),   Unicode  Text  Segmentation:
       Grapheme Cluster Boundaries .

PHP Documentation Group 													GRAPHEME_STRPOS(3)