Recupera o nome do fonte (4GL ou ADVPL) a partir da pilha de execução de funções, permitindo assim identificar, por exemplo, o nome do fonte que invocou alguma função.
Esta função questiona a pilha de execução, da linguagem AdvPL e 4GL, a respeito da última linha executada em uma rotina ou função. A pilha de execução é uma estrutura interna que mantém um registro para chamada de cada função.
Sintaxe
APPLICATION_getSourceFromStackTrace( [ < l_stackCount > ] ) => CHAR
Parâmetros
Nome | Tipo | Obrigatório? | Descrição |
---|---|---|---|
l_stackCount | INTEGER | Sim | Sequencia da pilha de execução desejada para recuperar o nome do respectivo fonte. Para recuperar o fonte da chamada atual, informe o valor 0. Para recuperar o fonte da chamada anterior, ou seja, pra a origem de chamada da funcao atual, informe 1 e assim por diante. |
Retorno
Tipo | Descrição |
---|---|
CHAR | Nome do programa/fonte correspondente a sequencia da pilha de execução informada no parâmetro. |
Exemplo
#---------------------------------------------# FUNCTION APPLICATION_getSourceFromStackTrace() #---------------------------------------------# #Exibe no LOG o nome do fonte em que esta chamada de função está sendo realizada. CALL conout("esta linha de execução pertence ao fonte = "||APPLICATION_getSourceFromStackTrace(0)) END FUNCTION
Informações
Fonte: application.4gl, application.prw
Abrangência: Disponível a partir do pacote 12.1.32 ou Framework 12.1.29.FIX02.