Documentación offline PHP master

substr_count

master Ver versión oficial en línea Licencia CC-BY-3.0Descargado el 2026-08-02

En esta página

substr_count

Cuenta el número de ocurrencias de segmentos en un string

Descripción#

substr_count(string $haystack, string $needle, [int $offset], [int $length]): int
```php

`substr_count` devuelve el número de ocurrencias de `needle` en el string `haystack`. Tenga en cuenta que `needle` es sensible a mayúsculas y minúsculas.

> [!NOTE]
> Esta función no cuenta los strings que se solapan. Véase el ejemplo a continuación.

## Parámetros

`haystack`  
El string en el que se busca

`needle`  
El string que se busca

`offset`  
El desplazamiento desde donde se comienza a contar. Si la posición es negativa, el conteo comienza desde el final del string.

`length`  
La longitud máxima después del desplazamiento especificado para buscar el string. La función emite un error si el desplazamiento más la longitud es mayor que la longitud de `haystack`. Una longitud negativa hará que el conteo comience al final de `haystack`.

## Valores devueltos

Esta función devuelve un `int`.

## Historial de cambios

| Versión | Descripción |
|----|----|
| 8.0.0 | `length` ahora puede ser nullable. |
| 7.1.0 | Se agregó soporte para números negativos para `offset` y `length`. `length` también puede ser `0` ahora. |

## Ejemplos

Ejemplo con `substr_count`
14 echo substr_count($text, 'is', 5, 10), PHP_EOL; ?>

```php

Véase también#

count_chars, strpos, substr, strstr