strpbrk

(PHP 5, PHP 7, PHP 8)

strpbrk — Recherche un ensemble de caractères dans une chaîne de caractères

Description

function strpbrk(string $string, string $characters): string|false

strpbrk() recherche dans la chaîne string n'importe lequel des caractères de characters.

Liste de paramètres

string: La chaîne dans laquelle on cherche characters.
characters: Ce paramètre est sensible à la casse.

Valeurs de retour

Retourne une chaîne, commençant au premier caractère trouvé, ou false s'il n'a pas été trouvé.

Erreurs / Exceptions

Lève une exception ValueError si characters est vide.

Historique

Version	Description
8.0.0	Lève désormais une exception ValueError si `characters` est vide. Auparavant, une `E_WARNING` était émise et `false` était retourné.

Exemples

Exemple #1 Exemple avec strpbrk()

<?php

$text = 'This is a Simple text.';

// Ceci affichera "is is a Simple text." car 'i' correspond au premier
echo strpbrk($text, 'mi'), PHP_EOL;

// Ceci affichera "Simple text." car les caractères sont sensibles à la casse
echo strpbrk($text, 'S'), PHP_EOL;
?>

Voir aussi

strpos() - Cherche la position de la première occurrence dans une chaîne
strstr() - Trouve la première occurrence dans une chaîne
preg_match() - Effectue une recherche de correspondance avec une expression rationnelle standard

Found A Problem?

Learn How To Improve This Page • Submit a Pull Request • Report a Bug

＋add a note

User Contributed Notes 2 notes

down

devnuhl ¶

12 years ago

If you're not looking to duplicate the rest of the string, but instead just want the offset, in the spirit of the str*pos() functions, use strcspn()

down

guillaume dot barranco at free dot fr ¶

9 years ago

A little modification to Evan's code to use an array for the second parameter :

<?php

function strpbrkpos($s, $accept) {
  $r = FALSE;
  $t = 0;
  $i = 0;
  $accept_l = count($accept);

  for ( ; $i < $accept_l ; $i++ )
    if ( ($t = strpos($s, $accept[$i])) !== FALSE )
      if ( ($r === FALSE) || ($t < $r) )
        $r = $t;

    return $r;
}

?>

＋add a note