(PHP 4, PHP 5, PHP 7)
strcspn — Trouve un segment de chaîne ne contenant pas certains caractères
$subject
, string $mask
[, int $start
[, int $length
]] ) : int
Retourne la taille du premier segment de subject
qui ne contient aucun des caractères de
mask.
Si start et length
sont ommis, alors la totalité de subject
sera examinée. S'ils sont inclus, alors l'effet sera identique à
appeler strcspn(substr($subject, $start, $length),
$mask) (voir substr pour plus
d'informations).
subjectLa chaîne à examiner.
maskLa chaîne contenant tous les caractères désactivés.
start
La position dans subject à partir
de laquelle on commence à chercher.
Si start est fourni et n'est pas négatif,
alors strcspn() va commencer à examiner
subject à la
start ème position. Par exemple, dans
la chaîne 'abcdef', le caracère à la position
0 est 'a', le caractère
à la position 2 est
'c', et ainsi de suite.
Si start est fourni et est négatif,
alors strspn() va commencer à examiner
subject à la
start ème position depuis la fin de
subject.
length
La longueur du segment de subject
à examiner.
Si length est fourni et n'est pas négatif,
alors subject sera examiné
depuis length caractères après la position de
départ.
Si length est fourni et est négatif,
alors subject sera examiné depuis la
position de départ jusqu'à length
caractères depuis la fin de subject.
Retourne la longueur du segment initial de subject
qui contient seulement des caractères qui ne sont pas
dans mask.
Note:
Lorsque le paramètre
startest définie, la longueur retournée est comptée depuis cette position, et non depuis le début desubject.
Exemple #1 Exemple avec strcspn()
<?php
$a = strcspn('abcd', 'apple');
$b = strcspn('abcd', 'banana');
$c = strcspn('hello', 'l');
$d = strcspn('hello', 'world');
$e = strcspn('abcdhelloabcd', 'abcd', -9);
$f = strcspn('abcdhelloabcd', 'abcd', -9, -5);
var_dump($a);
var_dump($b);
var_dump($c);
var_dump($d);
var_dump($e);
var_dump($f);
?>
L'exemple ci-dessus va afficher :
int(0) int(0) int(2) int(2) int(5) int(4)
Note: Cette fonction gère les chaînes binaires.