strstr

    (PHP 4, PHP 5, PHP 7, PHP 8)

    strstr — Encuentra la primera aparición de un string

    Descripción

    strstr(string$haystack, mixed$needle, bool$before_needle = false): string

    Devuelve parte del string haystack iniciando desde e incluyendo la primera aparición de needle (aguja) hasta el final del haystack (pajar).

    Nota:

    Esta función es sensible a mayúsculas. Para búsquedas sin importar las mayúsculas, use stristr().

    Nota:

    Si solo se quiere saber si un needle determinado aparece en un haystack, se utiliza la función strpos() que es más rápida y requiere menos memoria.

    Parámetros

    haystack

    El string en donde buscar.

    needle

    Si needle no es una cadena, se convierte a un entero y se aplica como el valor ordinal de un carácter. Este comportamiento está obsoleto a partir de PHP 7.3.0, por lo que su uso está totalmente desaconsejado. Dependiendo del comportamiento previsto, needle deberá ser convertido explícitamente a string, o realizar una llamada explícita a chr().

    before_needle

    Si se define como true, strstr() devolverá la parte del haystack antes de la primera ocurrencia de needle (excluyendo el needle).

    Valores devueltos

    Devuelve una parte de un string o false si no se encuentra el needle.

    Historial de cambios

    VersiónDescripción
    5.3.0 Se añadió el parámetro opcional before_needle.
    4.3.0strstr() se hizo segura binariamente.

    Ejemplos

    Ejemplo #1 Ejemplo de strstr()

    <?php
    $email     = 'name@example.com';
    $domain = strstr($email, '@');
    echo     $domain; // mostrará @example.com

    $user = strstr($email, '@', true); // Desde PHP 5.3.0
    echo $user; // mostrará name
    ?>

    Ver también

    • stristr() - strstr insensible a mayúsculas y minúsculas
    • strrchr() - Encuentra la última aparición de un caracter en un string
    • strpos() - Encuentra la posición de la primera ocurrencia de un substring en un string
    • strpbrk() - Buscar una cadena por cualquiera de los elementos de un conjunto de caracteres
    • preg_match() - Realiza una comparación con una expresión regular
    To Top