Edit Report a Bug

str_starts_with

(PHP 8)

str_starts_with — Détermine si une chaîne commence par une sous-chaîne donnée

Description

str_starts_with(string $haystack, string $needle): bool

Effectue une vérification sensible à la casse indiquant si haystack commence par needle.

Liste de paramètres

haystack: La chaîne dans laquelle on effectue la recherche.
needle: La sous-chaîne à rechercher dans haystack.

Valeurs de retour

Renvoie true si haystack commence par needle, sinon false.

Exemples

Exemple #1 Avec une chaîne vide ''

<?php
if (str_starts_with('abc', '')) {
    echo "All strings start with the empty string";
}
?>

L'exemple ci-dessus va afficher :

All strings start with the empty string

Exemple #2 Démonstration de la sensibilité à la casse

<?php
$string = 'The lazy fox jumped over the fence';

if (str_starts_with($string, 'The')) {
    echo "The string starts with 'The'\n";
}

if (str_starts_with($string, 'the')) {
    echo 'The string starts with "the"';
} else {
    echo '"the" was not found because the case does not match';
}

?>

L'exemple ci-dessus va afficher :

The string starts with 'The'
"the" was not found because the case does not match

Notes

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

Voir aussi

str_contains() - Détermine si une chaîne contient une sous-chaîne donnée
str_ends_with() - Détermine si une chaîne se termine par une sous-chaîne donnée
stripos() - Recherche la position de la première occurrence dans une chaîne, sans tenir compte de la casse
strrpos() - Cherche la position de la dernière occurrence d'une sous-chaîne dans une chaîne
strripos() - Cherche la position de la dernière occurrence d'une chaîne contenue dans une autre, de façon insensible à la casse
strstr() - Trouve la première occurrence dans une chaîne
strpbrk() - Recherche un ensemble de caractères dans une chaîne de caractères
substr() - Retourne un segment de chaîne
preg_match() - Effectue une recherche de correspondance avec une expression rationnelle standard

add a note

User Contributed Notes 3 notes

down

Paul Phillips ¶

3 years ago


You can use this in PHP versions less than 8.

<?php
function str_starts_with ( $haystack, $needle ) {
  return strpos( $haystack , $needle ) === 0;
}

down

jgusta ¶

3 years ago


With credit to Paul Phillips for the original polyfill posted.

If you do not have PHP 8, you can use these functions to get the capability of the new string functions. 

But! Remember to use a conditional check to make sure the function is not already defined.

<?php
// source: Laravel Framework
// https://github.com/laravel/framework/blob/8.x/src/Illuminate/Support/Str.php
if (!function_exists('str_starts_with')) {
    function str_starts_with($haystack, $needle) {
        return (string)$needle !== '' && strncmp($haystack, $needle, strlen($needle)) === 0;
    }
}
if (!function_exists('str_ends_with')) {
    function str_ends_with($haystack, $needle) {
        return $needle !== '' && substr($haystack, -strlen($needle)) === (string)$needle;
    }
}
if (!function_exists('str_contains')) {
    function str_contains($haystack, $needle) {
        return $needle !== '' && mb_strpos($haystack, $needle) !== false;
    }
}
?>

This keeps it from breaking in case you upgrade and forget that you added it. This is a good practice generally when using the global scope for your helper functions.

down

Reinder ¶

3 years ago


In PHP7 you may want to use:

if (!function_exists('str_starts_with')) {
  function str_starts_with($str, $start) {
    return (@substr_compare($str, $start, 0, strlen($start))==0);
  }
}

AFAIK that is binary safe and doesn't need additional checks.

add a note