split
Divide una cadena en una matriz mediante una expresión regular
&warn.deprecated.function.5-3-0.removed.7-0-0.alternatives;
preg_split
explode
str_split
&reftitle.description;
arraysplit
stringpattern
stringstring
intlimit-1
Divide un string en una matriz mediante una expresión regular.
&reftitle.parameters;
pattern
Expresión regular sensible 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 split (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.
&reftitle.returnvalues;
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 sensible 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,
split devuelve &false;.
&reftitle.examples;
Ejemplo de split
Para obtener los cinco primeros campos de una línea de
/etc/passwd:
]]>
Ejemplo de split
Para analizar una fecha que puede estar delimitada por barras, puntos o guiones:
\n";
?>
]]>
&reftitle.notes;
split está obsoleta a partir de PHP 5.3.0. preg_split
es la alternativa sugerida a esta función. Si no necesita la potencia de expresiones
regulares, es más rápido usar explode, que
no provoca el overhead del motor de expresiones regulares.
Para usuarios que buscan un manera de emular el comportamiento de Perl @chars =
split('', $str), por favor, vea los ejemplos de
preg_split o str_split.
&reftitle.seealso;
preg_split
spliti
str_split
explode
implode
chunk_split
wordwrap