trigger_errorGera uma mensagem a nível de usuário de erro/alerta/nota
&reftitle.description;
truetrigger_errorstringmessageinterror_levelE_USER_NOTICE
Usado para disparar uma condição de erro, pode ser usado em conjunto
com o gerenciador de erro interno, ou com uma função definida pelo usuário que
tenha sido definida como novo gerenciador de erro
(set_error_handler).
Esta função é útil quando for necessário gerar uma resposta em particular
a uma exceção em tempo de execução.
&reftitle.parameters;
message
A mensagem de erro designada para este erro. É limitada a 1024
bytes em tamanho. Quaisquer caracteres adicionais além de 1024 bytes serão
truncados.
error_level
O tipo de erro designado para este erro. Funciona apenas com a família de constantes
E_USER_*, e o padrão é E_USER_NOTICE.
Passar E_USER_ERROR como o
error_level agora foi descontinuado.
Alternativamente, uma Exception pode ser lançada ou
exit pode ser chamada.
&reftitle.returnvalues;
&return.true.always;
&reftitle.errors;
Esta função lança uma exceção ValueError se
error_level não for uma das constantes
E_USER_ERROR, E_USER_WARNING,
E_USER_NOTICE ou E_USER_DEPRECATED.
&reftitle.changelog;
&Version;&Description;8.4.0
Passar E_USER_ERROR como
error_level agora foi descontinuado.
Alternativamente, uma Exception pode ser lançada
ou exit pode ser chamada.
8.4.0
A função agora tem um tipo de retorno true
ao invés de bool.
8.0.0
A função agora lança uma exceção ValueError se um
error_level inválido for especificado. Anteriormente, retornava &false;.
&reftitle.examples;
Exemplo de trigger_error
Consulte set_error_handler para um exemplo mais extensivo.
]]>
&reftitle.notes;
As entidades HTML contidas no parâmetro message
não são escapadas. Utilize htmlentities na mensagem
se for necessário exibir o erro em um navegador.
&reftitle.seealso;
error_reportingset_error_handlerrestore_error_handlerAs constantes de nível de erroO atributo Deprecated