str_contains

(PHP 8)

str_contains — Determina si una cadena contiene un substring dado

Descripción

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