sc_error_exit("nome_app/URL", "Target")

A sc_error_exit interrompe a execução do código.

Quando utilizada sem parâmetro a macro utiliza um return, desta forma, ao utilizá-la em um método PHP apenas a execução do código no método será interrompida, retornando ao evento de origem e executando o restante do código. Neste caso, para interromper a execução do evento da aplicação, a macro precisa ser utilizada também no retorno do método.

Esta macro deve ser utilizada obrigatoriamente após a macro sc_error_message();

Parâmetros

Ela possui dois parâmetros que não são obrigatórios e o uso ou não dos parâmetros interfere no funcionamento da macro.

Parâmetro Descrição Passagem de parâmetro
noma_da_app/URL

Este parâmetro não obrigatório.

Quando informado, sempre que a macro for acionada, o usuário será redirecionado para a aplicação ou página informada, que pode ser aberta na mesma aba ou em uma nova, conforme o parâmetro target.

O nome da aplicação ou URL devem está entre aspas duplas, ou simples.

Exemplo com URL
sc_error_exit('www.scriptcase.com.br');

Exemplo com Aplicação
sc_error_exit('app_Login');

target

Este parâmetro não obrigatório.

Ele define se a aplicação/URL será aberta na mesma aba ou em uma nova.

Os valores podem ser:

  • _blank - Que exibe a aplicação/URL em uma nova aba.
  • _self - Exibe a aplicação/URL na mesma aba da aplicação.

Caso nenhum valor seja informado, o _self será utilizado como padrão.

Este parâmetro deve ser informado entre aspas duplas, ou simples.

Exemplo abrindo mesma aba
sc_error_exit('www.scriptcase.com.br');

sc_error_exit('www.scriptcase.com.br', '_self');

Exemplo abrindo nova aba
sc_error_exit('app_Login', '_blank');

 

Exemplos

Ex. 1: Exibe apenas a mensagem de erro.

sc_error_message('Mensagem de erro');
sc_error_exit();


Ex. 2: Exibe as mensagens de erro e o botão "OK" para redirecionar para a URL informada.

sc_error_message('Mensagem de erro');
sc_error_exit(http://www.meusite.com);

 

Ex. 3: Exibe as mensagens de erro e o botão "OK" para redirecionar para a Aplicação informada.

sc_error_message('Mensagem de erro');
sc_error_exit(minha_aplicacao, "_blank");