# substr_count

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

substr_count — Cuenta el número de apariciones del substring

### Descripción

substr_count(
string `$haystack`,
string `$needle`,
int `$offset` = 0,
int `$length` = ?
): int

substr_count() devuelve el número de veces en que el substring `needle` aparece en el string `haystack`. Por favor nótese que `needle` es sensible a mayúsculas y minúsculas.

> Nota:

> Esta función no cuenta las subcadenas que se traslapan. Véase el ejemplo de abajo!

### Parámetros

`haystack`

  El string dentro del cual buscar

`needle`

  El substring a buscar

`offset`

  El desplazamiento por dónde empezar a contar

`length`

  La longitud máxima después del desplazamiento especificado para buscar el substring. Se emite una advertencia si offset más length es mayor que la longitud de `haystack`.

### Valores devueltos

Esta función devuelve un integer.

### Historial de cambios

Versión | Descripción
--- | ---
5.1.0 | Los parámetros `offset` y `length` fueron agregados

### Ejemplos

Ejemplo #1 Ejemplo de substr_count()

`<?php
$text = 'This is a test';
echo strlen($text); // 14
echo substr_count($text, 'is'); // 2
// el string es reducido a 's is a test', así que muestra 1
echo substr_count($text, 'is', 3);
// el texto es reducido a 's i', así que muestra 0
echo substr_count($text, 'is', 3, 3);
// genera una advertencia debido a que 5+10 > 14
echo substr_count($text, 'is', 5, 10);
// muestra sólo 1, debido a que no cuenta subcadenas traslapadas.
$text2 = 'gcdgcdgcd';
echo substr_count($text2, 'gcdgcd');
?>`

### Ver también

- count_chars() - Devuelve información sobre los caracteres usados en una cadena
- strpos() - Encuentra la posición de la primera ocurrencia de un substring en un string
- substr() - Devuelve parte de una cadena
- strstr() - Encuentra la primera aparición de un string