Bloco de Função PREG_SPLIT

O bloco de função PREG_SPLIT divide uma string com base em uma expressão regular.

Aviso: Esta função é Binary-Safe. Isso significa que caracteres UTF8 não podem ser manipulados diretamente.

Aviso: Este bloco de função pode ter mais de quatro saídas. Você pode clicar com o botão direito do mouse no bloco de função para adicionar outra saída.

Aviso: Para divisões normais, recomenda-se o bloco de função EXPLODE.

Entrada PATTERN

A expressão a ser procurada, como uma string.

Entrada SUBJECT

A string a ser dividida.

Entrada LIMIT

Se especificado, no máximo LIMIT substrings serão retornados, com o restante da string armazenado na última substring. Um limite de -1, 0 ou NULL significa "sem limite".

Entrada NO_EMPTY

Se esta entrada for verdadeira, o bloco de função retornará apenas as partes que não estão vazias.

Entrada DELIM_CAPTURE

Se esta entrada for verdadeira, também serão capturadas e retornadas as expressões entre parênteses do padrão de busca do delimitador.

Entrada OFFSET_CAPTURE

Se esta entrada for verdadeira, o deslocamento correspondente na string será retornado com cada correspondência encontrada. Observe que isso altera os valores de retorno.

Saída ERR

É verdadeiro em caso de erro.

Saída COUNT

Retorna o número de divisões ou o tamanho do array interno.

Saídas P0..P#

Mais saídas podem ser adicionadas. Cada divisão é transferida para uma saída. Se o array interno for menor que o número de saídas, o resultado nas saídas maiores será NULL.

Veja Também