substr_count

(PHP 4, PHP 5, PHP 7)

substr_countCuenta 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'33);

// genera una advertencia debido a que 5+10 > 14
echo substr_count($text'is'510);


// 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