str_contains

(PHP 8)

str_containsDetermina 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 resultado del ejemplo sería:

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 resultado del ejemplo sería:

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 binariamente.

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