Manual do PHP
Anterior |  | Próxima

# ereg

(PHP 3, PHP 4, PHP 5)

ereg -- Casando expressões regulares

## Descrição

bool ereg ( string expressao, string variavel [, array registros] )

> Nota: preg_match(), você pode também utilizar as expressões regulares compátiveis com perl, uma alternativar veloz a função ereg().

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).

Se existirem parenteses de substrings na `expressao` e for passado o terceiro parâmetro `registros` para a função, a execução guardará os elementos resultantes na matriz `registros`. $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 variavel casada.

> 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().

Retorna `TRUE` se `string` casar com `pattern`, e `FALSE` se a expressão não casar ou se acontecer algum erro.

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

Exemplo 1. Exemplo da função ereg()
`<?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"; } ?>`

Veja mais em eregi(), ereg_replace(), eregi_replace(), preg_match(), strpos() e strstr().

Anterior | Principal | Próxima
ereg_replace | Acima | eregi_replace