spliti
(PHP 4 >= 4.0.1, PHP 5)
spliti — Divide una cadena en una matriz mediante una expresión regular insensible a mayúsculas-minúsculas
Advertencia
Esta función está OBSOLETA en PHP 5.3.0, por lo tanto,
será ELIMINADA en PHP 7.0.0.
Las alternativas a esta función son:
Descripción
spliti
( string $pattern
, string $string
[, int $limit
= -1
] ) : array
Esta función es idéntica a split() excepto que ignora
la distinción de mayúsculas-minúsculas cuando se comparan caracteres alfanuméricos.
Parámetros
-
pattern
-
Expresión regular insensible a mayúsculas-minúsculas.
Si quiere dividir cualesquiera caracteres que están considerados
especiales por las expresiones regulares, necesitará escaparlos primero. Si
piensa que spliti() (o, de hecho, cualquier otra función de
expresión regular) está haciendo algo extraño, por favor, lea el archivo
regex.7, incluido en el subdirectorio
regex/ de la distribución de PHP. Estas páginas de ayuda
están en formato "man", por lo que será necesaria una orden como
man /usr/local/src/regex/regex.7 para poder leerlo.
-
string
-
La cadena de entrada.
-
limit
-
Si se establece limit
, la matriz devuelta
contendrá un máximo de limit
elementos con el
último elemento conteniendo el resto completo de
string
.
Valores devueltos
Devuelve una matriz de cadenas, siendo cada una de ellas una sub-cadena de
string
formada al dividir éste con los límites establecidos
mediante la expresión regular insensible a mayúsculas-minúsculas pattern
.
Si hay n incidencias de
pattern
, la matriz devuelta contentrá
n+1 elementos. Por ejemplo, si
no hay incidencias de pattern
, será devuelta
una matriz con sólo un elemento. Por supuesto, esto también es verdadero si
string
está vacío. Si se produce un error,
spliti() devuelve FALSE
.
Ejemplos
Este ejemplo divide una cadena usando 'a' como separador :
Ejemplo #1 Ejemplo de spliti()
<?php
$cadena = "aBBBaCCCADDDaEEEaGGGA";
$trozos = spliti ("a", $cadena, 5);
print_r($trozos);
?>
El resultado del ejemplo sería:
Array
(
[0] =>
[1] => BBB
[2] => CCC
[3] => DDD
[4] => EEEaGGGA
)
Ver también
- preg_split() - Divide un string mediante una expresión regular
- split() - Divide una cadena en una matriz mediante una expresión regular
- explode() - Divide un string en varios string
- implode() - Une elementos de un array en un string