trigger_error

(PHP 4 >= 4.0.1, PHP 5)

trigger_error — Gera uma mensagem a nível de usuário de erro/aviso/notícia

Descrição

bool trigger_error ( string $error_msg [, int $error_type = E_USER_NOTICE ] )

Usado para realizar uma condição de erro, pode ser usado em conjunto com o manipulador de erro interno, ou com uma função definida pelo usuário que foi definida como novo manipulador de erro (set_error_handler()).

Esta função é útil se você precisa gerar uma resposta em particular para uma exceção em tempo de execução.

Parâmetros

error_msg

A mensagem de erro definida para este erro. É limitada a 1024 caracteres em tamanho. Quaisquer caracteres além de 1024 serão truncados.

error_type

O tipo de erro definido para este erro. Funciona apenas com a família de constantes E_USER, e o padrão será E_USER_NOTICE.

Valor Retornado

Esta função retorna FALSE se for especificado error_type errado, TRUE se não.

Exemplos

Example #1 Exemplo trigger_error()

Veja set_error_handler() para um exemplo mais extensivo.

<?php
if (assert($divisor == 0)) {
    trigger_error("Cannot divide by zero", E_USER_ERROR);
}
?>

Notas

Warning

As entidades HTML contidas no parâmetro error_msg não são escapadas. Utilize htmlentities() na mensagem para que o erro seja exibido no navegador.

Veja Também