Uso e exemplo da função preg_split() do PHP

PHP Expressão Regular (PCRE)

A função preg_replace separa a string usando uma expressão regular.

Sintaxe

array preg_split ( string $pattern , string $subject [, int $limit = -1 [, int $flags = 0 ]] )

Separa a string fornecida por um expressão regular.

Descrição dos parâmetros:

• $pattern: Modelo de busca utilizado, em formato de string.

• $subject: String de entrada.

• $limit: Opcional. Se especificado, limitará o número de substrings obtidos pela separação a no máximo $limit. O último substring conterá todos os restantes.-1Quando 0 ou null, representa "não limitado". Como padrão do PHP, você pode usar null para pular a configuração de flags.

• $flags: Opcional, pode ser a combinação de qualquer marcador a seguir (com operação bitwise OR):

  • PREG_SPLIT_NO_EMPTY: Se este marcador estiver configurado, o preg_split() retornará partes não vazias após a separação.
  • PREG_SPLIT_DELIM_CAPTURE: Se este marcador estiver configurado, os expressões em parenteses do padrão de separação serão capturadas e retornadas.
  • PREG_SPLIT_OFFSET_CAPTURE: Se este marcador estiver configurado, para cada ocorrência, será adicionado o deslocamento da string. Nota: Isso mudará cada elemento do array de retorno, tornando cada elemento um array cujo primeiro elemento é o substring separado, e o segundo elemento é o deslocamento do substring no subject.1Cada elemento é um array que contém o deslocamento do substring no subject.

Retorno

Retorna um array composto por substrings obtidas ao dividir o subject com o pattern.

Exemplo online

<?php
//Usar vírgula ou espaço (inclusos " ", \r, \t, \n, \f) para separar frases
$keywords = preg_split("/[\s,]+/", "hipertexto linguagem, programação");
print_r($keywords);
?>

Os resultados de execução são exibidos a seguir:

Array
(
    [0] => hipertexto
    [1] => linguagem
    [2] => programação
)

<?php
$str = 'w3codebox';
$chars = preg_split('//', $str, -1, PREG_SPLIT_NO_EMPTY);
print_r($chars);
?>

Os resultados de execução são exibidos a seguir:

Array
(
    [0] => r
    [1] => u
    [2] => n
    [3] => o
    [4] => o
    [5] => b
)

<?php

$chars = preg_split('/ /', $str, -1, PREG_SPLIT_OFFSET_CAPTURE);
print_r($chars);
?>

Os resultados de execução são exibidos a seguir:

Array
(
    [0] => Array
        (
            [0] => hipertexto
            [1] => 0
        )
    [1] => Array
        (
            [0] => linguagem
            [1] => 10
        )
    [2] => Array
        (
            [0] => programação
            [1] => 19
        )
)

PHP Expressão Regular (PCRE)