Rechercher une fonction PHP

strspn

Contents

(PHP 4, PHP 5, PHP 7)

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

Description

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

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 calling 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");
?>
will assign 2 to $var, because the string "42" is the initial segment of subject that consists only of characters contained within "1234567890".

PHP: strspn - Manual Home of Manuel PHP  Contents Haut

Parameters

subject

The string to examine.

mask

The list of allowable characters.

start

The position in subject to start searching.

If start is given and is non-negative, then strspn() will begin examining subject at the start'th position. For instance, in the string 'abcdef', the character at position 0 is 'a', the character at position 2 is 'c', and so forth.

If start is given and is negative, then strspn() will begin examining subject at the start'th position from the end of subject.

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.

PHP: strspn - Manual Home of Manuel PHP  Contents Haut

Return Values

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

Note:

When a start parameter is set, the returned length is counted starting from this position, not from the beginning of subject.

PHP: strspn - Manual Home of Manuel PHP  Contents Haut

Examples

Example #1 strspn() 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)

PHP: strspn - Manual Home of Manuel PHP  Contents Haut

Notes

Note: This function is binary-safe.

PHP: strspn - Manual Home of Manuel PHP  Contents Haut

See Also

  • strcspn() - Find length of initial segment not matching mask

Find a PHP function

English translation

You have asked to visit this site in English. For now, only the interface is translated, but not all the content yet.

If you want to help me in translations, your contribution is welcome. All you need to do is register on the site, and send me a message asking me to add you to the group of translators, which will give you the opportunity to translate the pages you want. A link at the bottom of each translated page indicates that you are the translator, and has a link to your profile.

Thank you in advance.

Document created the 30/01/2003, last modified the 26/10/2018
Source of the printed document:https://www.gaudry.be/en/php-rf-function.strspn.html

The infobrol is a personal site whose content is my sole responsibility. The text is available under CreativeCommons license (BY-NC-SA). More info on the terms of use and the author.

References

  1. View the html document Language of the document:fr Manuel PHP : http://php.net

These references and links indicate documents consulted during the writing of this page, or which may provide additional information, but the authors of these sources can not be held responsible for the content of this page.
The author This site is solely responsible for the way in which the various concepts, and the freedoms that are taken with the reference works, are presented here. Remember that you must cross multiple source information to reduce the risk of errors.

Contents Haut