(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
]] )
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).
subject
La chaîne à examiner.
mask
La 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
start
est 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.