(PHP 4, PHP 5)
preg_split — Divide a string por uma expressão regular
Divide uma dada string por uma expressão regular.
O padrão a ser usado.
A string de entrada.
Se especificado, então somente limit pedaços da string serão retornados, e se limit for -1, significa "sem limite", que é útil quando especificando flags.
flags pode ser uma combinação das seguintes flags (combinada com o operador | bit-a-bit):
Se esta flag é usada, para cada combinação o offset da string será também retornado. Note que isto modifica o valor de retorno em um array onde cada elemento é um array contendo a string combinada no índice 0 e o offset da mesma em subject no índice 1.
Retorna um array contendo pedaços de strings de subject divididos pelo que for combinado pelo pattern.
Versão | Descrição |
---|---|
4.3.0 | A PREG_SPLIT_OFFSET_CAPTURE foi adicionada |
4.0.5 | A PREG_SPLIT_DELIM_CAPTURE foi adicionada |
4.0.0 | O parâmetro flags foi adicionado |
Exemplo #1 Exemplo da preg_split(): Obtendo partes de uma string
<?php
// reparte a frase por algum número caracteres de vírgula ou espaço,
// incluindo " ", \r, \t, \n e \f
$keywords = preg_split("/[\s,]+/", "hypertext language, programming");
?>
Exemplo #2 Dividindo a string em cada caractere que a compõe
<?php
$str = 'string';
$chars = preg_split('//', $str, -1, PREG_SPLIT_NO_EMPTY);
print_r($chars);
?>
Exemplo #3 Dividindo a string pela combinação e seus offsets
<?php
$str = 'hypertext language programming';
$chars = preg_split('/ /', $str, -1, PREG_SPLIT_OFFSET_CAPTURE);
print_r($chars);
?>
O exemplo acima irá imprimir:
Array ( [0] => Array ( [0] => hypertext [1] => 0 ) [1] => Array ( [0] => language [1] => 10 ) [2] => Array ( [0] => programming [1] => 19 ) )
Se você não precisa do poder das expressões regulares, pode optar por alternativa mais rápidas como explode() ou str_split().