Determina si una cadena contiene un substring dado

# str_contains

(PHP 8)

str_contains — Determina si una cadena contiene un substring dado

### Descripción

function str_contains(string `$haystack`, string `$needle`): bool

Realiza una verificación sensible a mayúsculas y minúsculas para indicar si `needle` (aguja) está contenida en `haystack` (pajar).

### Parámetros

`haystack`

  El string en el que se realiza la búsqueda.

`needle`

  El substring a buscar en `haystack`.

### Valores devueltos

Devuelve `true` si `needle` está en `haystack`, de lo contrario `false`.

### Ejemplos

Ejemplo #1 Con un string vacío `''`

    <?php
    if (str_contains('abc', '')) {
        echo "Verificar la existencia de la cadena vacía siempre devolverá true";
    }
    ?>

El ejemplo anterior mostrará:

    Verificar la existencia de la cadena vacía siempre devolverá true

Ejemplo #2 Demostración de la sensibilidad a mayúsculas y minúsculas

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

    if (str_contains($string, 'lazy')) {
        echo "La cadena 'lazy' fue encontrada en la cadena\n";
    }

    if (str_contains($string, 'Lazy')) {
        echo 'La cadena "Lazy" fue encontrada en la cadena';
    } else {
        echo '"Lazy" no fue encontrada porque las mayúsculas y minúsculas no coinciden';
    }

    ?>

El ejemplo anterior mostrará:

    La cadena 'lazy' fue encontrada en la cadena
    "Lazy" no fue encontrada porque las mayúsculas y minúsculas no coinciden

### Notas

> Nota: Esta función es segura para sistemas binarios.

### Ver también

- str_ends_with() - Determina si una cadena termina con un substring dado
- str_starts_with() - Determina si un string comienza con un substring dado
- stripos() - Busca la posición de la primera ocurrencia en un string, sin distinguir mayúsculas de minúsculas
- strrpos() - Busca la posición de la última ocurrencia de una subcadena en una cadena
- strripos() - Busca la posición de la última ocurrencia de un string contenido en otro, de forma insensible a mayúsculas y minúsculas
- strstr() - Encuentra la primera ocurrencia en un string
- strpbrk() - Busca un conjunto de caracteres en un string
- substr() - Devuelve un segmento de string
- preg_match() - Realiza una búsqueda de coincidencia con una expresión regular estándar

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open