Rechercher une fonction PHP

strcspn

Table des matières

(PHP 4, PHP 5, PHP 7)

strcspn — Trouve un segment de chaîne ne contenant pas certains caractères

Description

int strcspn ( string $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).

  

Liste de paramètres

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.

  

Valeurs de retour

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 de subject.

  

Exemples

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)

  

Notes

Note: Cette fonction gère les chaînes binaires.

  

Voir aussi

  • strspn() - Trouve la longueur du segment initial d'une chaîne contenant tous les caractères d'un masque donné

Rechercher une fonction PHP

Document créé le 30/01/2003, dernière modification le 26/10/2018
Source du document imprimé : https://www.gaudry.be/php-rf-function.strcspn.html

L'infobrol est un site personnel dont le contenu n'engage que moi. Le texte est mis à disposition sous licence CreativeCommons(BY-NC-SA). Plus d'info sur les conditions d'utilisation et sur l'auteur.

Références

  1. Consulter le document html Langue du document :fr Manuel PHP : http://php.net

Ces références et liens indiquent des documents consultés lors de la rédaction de cette page, ou qui peuvent apporter un complément d'information, mais les auteurs de ces sources ne peuvent être tenus responsables du contenu de cette page.
L'auteur de ce site est seul responsable de la manière dont sont présentés ici les différents concepts, et des libertés qui sont prises avec les ouvrages de référence. N'oubliez pas que vous devez croiser les informations de sources multiples afin de diminuer les risques d'erreurs.

Table des matières Haut