Finaliza um contador de tempo de processamento (em segundos) para uma ação qualquer desejada e retorna o tempo total decorrido (em segundos) desde a chamada da função LOG_ElapsedTimeStart para a mesma ação.
Sintaxe
LOG_ElapsedTimeFinish( [ <l_action> ] ) => INTEGER
Parâmetros
Nome | Tipo | Obrigatório? | Descrição |
---|---|---|---|
l_action | CHAR | Sim | Nome fixo utilizado para identificar o cronômetro de tempo armazenado em memória. Limite de até 150 caracteres. |
Retorno
Tipo | Descrição |
---|---|
| Tempo decorrido (em segundos) para a ação indicada no parâmetro l_action desde o acionamento da função LOG_ElapsedTimeStart. |
Exemplo
#-----------------------------------# FUNCTION LOG_ElapsedTimeFinish_test() #-----------------------------------# DEFINE l_seconds INTEGER CALL LOG_ElapsedTimeStart("acao01") SLEEP 2 CALL LOG_ElapsedTimeStart("acao02") SLEEP 3 #Registra o tempo decorrido (em segundos) desde que a ação LOG_ElapsedTimeStart("acao02") foi processada CALL conout("Tempo decorrido para ação 'Ação02' = "||LOG_ElapsedTimeFinish("acao02")) #Registra o tempo decorrido (em segundos) desde que a ação LOG_ElapsedTimeStart("acao01") foi processada CALL conout("Tempo decorrido para ação 'Ação01' = "||LOG_ElapsedTimeFinish("acao01")) END FUNCTION
Informações
Fonte: funcoes_genericas.4gl, funcoes_genericas.prw
Abrangência: Disponível a partir do pacote 12.1.31 ou Fix Framework 12.1.29.FIX02.
Observações
Utilize esta função LOG_ElapsedTimeFinish() sempre em conjunto com a função LOG_ElapsedTimeStart().
Toda vez que a função LOG_ElapsedTimeFinish() é invocada, o contador de tempo de processamento da ação é retornado, mas também reinicia automaticamente o momento inicial de um novo processamento desta ação. Desta forma em nova chamada da função LOG_ElapsedTimeFinish() sem novo acionamento obrigatório da função LOG_ElapsedTimeStart().