ereg_replace
eregi_replace
Funções para Regex POSIX
PHP Manual

# 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

Exemplo #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

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

> Nota: 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

ereg_replace
eregi_replace
Funções para Regex POSIX
PHP Manual