mb_stripos

(PHP 5 >= 5.2.0, PHP 7, PHP 8)

mb_stripos — Trouve la première occurrence d'une chaîne dans une autre, sans tenir compte de la casse

Description

function mb_stripos(
    string $haystack,
    string $needle,
    int $offset = 0,
    ?string $encoding = null
): int|false

mb_stripos() retourne la position numérique de la première occurrence de needle dans la chaîne haystack. Contrairement à mb_strpos(), mb_stripos() est insensible à la casse. Si needle n'est pas trouvé, la fonction retournera false.

Liste de paramètres

haystack: La chaîne depuis laquelle on récupère la position de la première occurrence de needle
needle: La chaîne à chercher dans haystack
offset: La position dans haystack où l'on doit commencer à chercher. Une position négative compte à partir de la fin de la chaîne de caractères.
encoding: Le paramètre encoding est l'encodage des caractères. S'il est omis ou null, l'encodage de caractères interne sera utilisé.

Valeurs de retour

Retourne la position numérique de la première occurrence de needle dans la chaîne haystack ou false si needle n'est pas trouvé.

Erreurs / Exceptions

Si offset est supérieur à la longueur de haystack, une ValueError sera levée.

À partir de PHP 8.0.0, une ValueError est levée si encoding est un encodage invalide. Avant PHP 8.0.0, un E_WARNING était émis à la place.

Historique

Version	Description
8.0.0	`needle` accepte désormais une chaîne vide.
8.0.0	`encoding` est désormais nullable.
8.0.0	Lève désormais une ValueError si `encoding` est un encodage invalide. Auparavant, un `E_WARNING` était émis et `false` était retourné.
7.1.0	Support pour `offset`s négatifs a été ajouté.

Voir aussi

stripos() - Recherche la position de la première occurrence dans une chaîne, sans tenir compte de la casse
strpos() - Cherche la position de la première occurrence dans une chaîne
mb_strpos() - Repère la première occurrence d'un caractère dans une chaîne

Found A Problem?

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

＋add a note

User Contributed Notes 1 note

down

FangTS_ ¶

7 years ago

How works on examples mb_stripos:

First we will watch example on symbols(..?).
<?php
$text = "Look! It's a text! Wow!"; //simple text
$spaceIsHere = mb_stripos($text," "); //you can replace " " on something what you need or want
$text2 = mb_substr($text,$spaceIsHere); //cutting text with $spaceIsHere
print ($text2); 
/* Print will show that result:
" It's a text! Wow!"
Look. That " " wasn't cutted, because mb_substr don't write in var position after " " - he write WHERE is " " in string. */
?>

Also it can work on words, sentences...
Here's one of examples:
<?php
$text = "Look! It's a text! Wow!"; //familiar text, right?)
$afterNeededWord = mb_stripos($text,"text!"); //you can replace "text!" on something else what you need
$text3 = mb_substr($text, $afterNeededWord); //cutting string (it is string? im stupid in that question xD)
print ($text3); 
/* Print will show that result:
"text! Wow!"
Explaining the same. */
?>

I hope it was useful with my "good" English skills. ;D
Have a nice day, coder.

＋add a note