preg_splitDivide una cadena mediante expresión regular
&reftitle.description;
arrayfalsepreg_splitstringpatternstringsubjectintlimit-1intflags0
Divide una cadena mediante expresión regular.
&reftitle.parameters;
pattern
El patrón a buscar, en forma de &string;.
subject
La cadena de entrada.
limit
Si limit está especificado, entonces solo se devuelven
las limit primeras sub-caenas con el resto de la cadena
colocado en la última sub-caena.
Un limit de -1 o 0 significa "sin límite".
flagsflags puede ser la combinación de las
siguientes opciones (combinadas con el operador |):
PREG_SPLIT_NO_EMPTY
Si esta opción está activada, solo se devuelven las sub-caenas no vacías
por preg_split.
PREG_SPLIT_DELIM_CAPTURE
Si esta opción está activada, las expresiones entre paréntesis entre
los delimitadores de patrones también serán capturadas y devueltas.
PREG_SPLIT_OFFSET_CAPTURE
Si esta opción está activada, para cada resultado, su posición será devuelta.
Tenga en cuenta que esto cambia el valor devuelto a un array donde cada elemento es un
array compuesto por la cadena encontrada en la posición &zero;
y la posición de la cadena en subject en
la posición &one;.
&reftitle.returnvalues;
Devuelve un array que contiene las sub-caenas de subject,
separadas por las cadenas que coinciden con pattern, &return.falseforfailure;.
&reftitle.errors;
&pcre.pattern.warning;
&reftitle.examples;
Ejemplo con preg_split: División de una cadena de búsqueda
]]>
&example.outputs;
lenguaje
[1] => de
[2] => marcado
[3] => programación
)
]]>
Dividir una cadena en caracteres
]]>
&example.outputs;
s
[1] => t
[2] => r
[3] => i
[4] => n
[5] => g
)
]]>
Dividir una cadena y capturar las posiciones
]]>
&example.outputs;
Array
(
[0] => lenguaje
[1] => 0
)
[1] => Array
(
[0] => de
[1] => 8
)
[2] => Array
(
[0] => marcado,
[1] => 12
)
[3] => Array
(
[0] => programación
[1] => 22
)
)
]]>
&reftitle.notes;
Si no se necesita el poder de las expresiones regulares,
pueden elegirse alternativas más rápidas (aunque más simples)
como explode o str_split.
Si la búsqueda de una coincidencia falla, se devuelve un array que contiene
un solo elemento que contiene la cadena de entrada.
&reftitle.seealso;
Patrones PCREpreg_quoteexplodepreg_matchpreg_match_allpreg_replacepreg_last_error