split

(PHP 4, PHP 5)

split — Separa strings em array utilizando expressões regulares

Descrição

array split ( string $pattern , string $string [, int $limit ] )

Separa uma string em array por expressão regular.

Parâmetros

pattern

A expressão regular case sensitive.

Se separar caracteres que são consideredos especiais para as expressões regulares, será necessário usar o caracter de escape primeiramente. Se você pensar que split() (ou outra função para execução de expressões regulares) é muito estranha, por favor leia o arquivo regex.7, incluido na pasta regex/ no subdiretório da distribuição do PHP. Está no formato manpage e você deverá usar o comando man /usr/local/src/regex/regex.7 para maiores informações.

string

A string de entrada.

limit

Se limit é definido, o array retornado conterá no máximo de limit elementos, sendo que o último elemento conterá o resto da string.

Valor Retornado

Retorna uma matriz de strings, contendo as substrings de string separadas pelos limites descritos na expressão regular pattern.

Se existirem n ocorrências da pattern, será retornado uma matriz (array) contendo n+1 items. Por exemplo, se não existir uma ocorrência de pattern, uma matriz com um único elemento será retornado. Certamente, isto também é válido se string estiver vazia. Se um erro ocorrer, split() retorna FALSE.

Exemplos

Example #1 Exemplo da split()

Separa os quatro primeiro elementos de uma linha do arquivo /etc/passwd:

<?php
list($user,$pass,$uid,$gid,$extra) =
    split (":", $passwd_line, 5);
?>

Example #2 Exemplo da split()

Separação de dados delimitados por barras, pontos, ou traços:

<?php
// Delimitado por barras, pontos ou traços
$data = "04/30/1973";
list ($mes, $dia, $ano) = split ('[/.-]', $data);
echo "Mês: $mes; Dia: $dia; Ano: $ano<br />\n";
?>

Notas

Tip

preg_split(), que usa sintaxe de expressão regular compatível com Perl, é normalmente a rápida alternativa para split(). Se você não precisa do poder das expressões regulares, é mais eficiente usar explode(), que não faz overhead como engine de expressão regular.

Tip

Para visualizar uma emulação do Perl e seus métodos @chars = split('', $str), veja os exemplos da preg_split().

Veja Também

  • preg_split() - Divide a string por uma expressão regular
  • spliti() - Separa strings em array utilizando expressões regulares insensíveis a maiúsculas e minúsculas
  • str_split() - Converte uma string para um array
  • explode() - Divide uma string em strings
  • implode() - Junta elementos de uma matriz em uma string
  • chunk_split() - Divide uma string em pequenos pedaços
  • wordwrap() - Quebra uma string em um dado número de caracteres