ereg

(PHP 4, PHP 5)

ereg — Casando expressões regulares

Descrição

int ereg ( string $pattern , string $string [, array &$regs ] )

Verifica se a variavel casa com a expressão regular definida em expressao em um modo sensível a distinção de caracteres (case sensitive).

Parâmetros

pattern

A expressão regular case sensitive.

string

A string de entrada.

regs

Se existirem parênteses de substrings no pattern e for passado o terceiro parâmetro regs para a função, a execução guardará os elementos resultantes na matriz regs.

$registros[1] irá conter a substring indicada pelo primeiro parenteses da esquerda; $registros[2] contém a segunda substring, e assim por diante. $registros[0] conterá uma cópia completa da variável casada.

Valor Retornado

Retorna o tamanho da string encontrada se uma combinação de pattern foi encontrado em string, ou FALSE se nenhuma combinação foi feita ou um erro que tenha ocorrido.

Se o parâmetro opcional regs não foi passado ou o tamanho da string casada é 0, esta função retorna 1.

Exemplos

Example #1 Exemplo da ereg()

O exemplo seguinte pega uma data no padrão ISO (YYYY-MM-DD) e imprime na no formato DD.MM.YYYY:

<?php
if (ereg ("([0-9]{4})-([0-9]{1,2})-([0-9]{1,2})", $data, $registros)) {
    echo "$registros[3].$registros[2].$registros[1]";
} else {
    echo "Formato de data inválido: $data";
}
?>

Notas

Note:

preg_match(), que usa a sintaxe de expressão regular compatível com Perl, é normalmente uma rápida alternativa para ereg().

Note: Nas versões superiores ao PHP 4.1.0 (inclusive) se você colocar exatamente dez elementos em $registros, ou até mesmo mais elementos, a expressão será executada. A quantidade não causará efeitos na função ereg() que tem habilidade de suportar muitas substrings. Se a expressão não casar, $registros não será alterada por ereg().

Veja Também

  • eregi() - Casando expressões regulares insensíveis a maiúsculas e minúsculas
  • ereg_replace() - Substituição através de expressões regulares
  • eregi_replace() - Substituição utilizando expressões regulares insensíveis a maiúsculas e minúsculas
  • preg_match() - Perform a regular expression match
  • strpos() - Encontra a posição da primeira ocorrência de uma string
  • strstr() - Encontra a primeira ocorrencia de uma string
  • quotemeta() - Adiciona uma barra invertida antes dos meta caracteres