Edit Report a Bug

str_starts_with

(PHP 8)

str_starts_with — Checks if a string starts with a given substring

Beschreibung

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

Performs a case-sensitive check indicating if haystack begins with needle.

Parameter-Liste

haystack: The string to search in.
needle: The substring to search for in the haystack.

Rückgabewerte

Returns true if haystack begins with needle, false otherwise.

Beispiele

Beispiel #1 Using the empty string ''

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

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

All strings start with the empty string

Beispiel #2 Showing case-sensitivity

<?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';
}

?>

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

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

Anmerkungen

Hinweis: Diese Funktion ist binärsicher.

Siehe auch

str_contains() - Determine if a string contains a given substring
str_ends_with() - Checks if a string ends with a given substring
stripos() - Findet das erste Vorkommen eines Teilstrings in einem String, unabhängig von Groß- und Kleinschreibung
strrpos() - Findet die Position des letzten Vorkommens eines Teilstrings innerhalb einer Zeichenkette
strripos() - Findet das letzte Vorkommen der gesuchten Zeichenkette in einem String, unabhängig von Groß- und Kleinschreibung
strstr() - Findet das erste Vorkommen eines Strings
strpbrk() - Durchsucht einen String nach einem Zeichen aus einer Gruppe von Zeichen
substr() - Liefert einen Teil eines Strings
preg_match() - Führt eine Suche mit einem regulären Ausdruck durch

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 ¶

2 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