strspn(3) [php man page]

STRSPN(3)								 1								 STRSPN(3)

strspn - Finds the length of the initial segment of a string consisting entirely of characters contained within a given mask.

SYNOPSIS

       int strspn (string  $subject, string  $mask, [int  $start], [int  $length])

DESCRIPTION

	Finds the length of the initial segment of $subject that contains only characters from $mask.

	If  $start and $length are omitted, then all of $subject will be examined. If they are included, then the effect will be the same as call-
       ing strspn(substr($subject, $start, $length), $mask) (see "substr" for more information).

	The line of code:

       <?php
       $var = strspn("42 is the answer to the 128th question.", "1234567890");
       ?>
       2 to $var, because the string "42" is the initial segment of $subject that consists only of characters contained within "1234567890".

PARAMETERS

	      o $subject
		- The string to examine.

	      o $mask
		- The list of allowable characters.

	      o $start
		- The position in $subject to start searching.	If $start is given and is non-negative, then strspn(3) will begin examining  $sub-
		ject at the $start'th position. For instance, in the string ' abcdef', the character at position 0 is ' a', the character at posi-
		tion 2 is ' c', and so forth.  If $start is given and is negative, then strspn(3) will begin examining $subject at  the  $start'th
		position from the end of $subject.

	      o $length
		- The length of the segment from $subject to examine.  If $length is given and is non-negative, then $subject will be examined for
		$length characters after the starting position.  If $length is given and is negative, then $subject  will  be  examined  from  the
		starting position up to $length characters from the end of $subject.

RETURN VALUES

	Returns the length of the initial segment of $subject which consists entirely of characters in $mask.

EXAMPLES

       Example #1

	      strspn(3) example

	      <?php
	      // subject does not start with any characters from mask
	      var_dump(strspn("foo", "o"));

	      // examine two characters from subject starting at offset 1
	      var_dump(strspn("foo", "o", 1, 2));

	      // examine one character from subject starting at offset 1
	      var_dump(strspn("foo", "o", 1, 1));
	      ?>

	      The above example will output:

	      int(0)
	      int(2)
	      int(1)

NOTES

       Note

	      This function is binary-safe.

SEE ALSO

       strcspn(3).

PHP Documentation Group 														 STRSPN(3)

Check Out this Related 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)

Linux and UNIX Man Pages

strspn(3) [php man page]

Check Out this Related Man Page