Linha Logix

Páginas filhas
  • APPLICATION_getSourceFromStackTrace


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_stackCountINTEGERSim

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.