(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
$pattern
, string $string
[, int $limit = -1
] )
Divide un string en una matriz mediante una expresión regular.
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.
Esta función ha sido declarada OBSOLETA desde PHP 5.3.0. Su uso está totalmente desaconsejado.
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.
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.
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 )
Nota:
Desde PHP 5.3.0, la extensión regex queda obsoleta y en su lugar se utiliza extensión PCRE. Si se llama a esta función creará un aviso
E_DEPRECATED. Ver El listado de diferencias para obtener ayuda a convertir a PCRE.
spliti() está obsoleta a partir de PHP 5.3.0. preg_split()
con el modificador i (PCRE_CASELESS) es la alternativa sugerida.