PROCLINE()
 Retorna o número de linha do código fonte da ativaçao corrente ou anterior
------------------------------------------------------------------------------

 Sintaxe

     PROCLINE([<nAtivaçao>]) --> nLinhaFonte

 Argumentos

     <nAtivaçao> é um valor numérico que especifica qual ativaçao a
     questionar.  Zero refere-se à ativaçao corrente, 1 (um) refere-se à
     ativaçao anterior, etc.  Caso nao haja especificaçao, o valor padrao é
     zero.

 Retorno

     PROCLINE() retorna o número da última linha executada em uma rotina,
     funçao, ou bloco de código corrente, na forma de um valor numérico
     inteiro.  Se for usada a opçao de compilador /L para suprimir a
     informaçao sobre número de linha, PROCLINE() sempre retorna zero.

 Descriçao

     PROCLINE() questiona a pilha de ativaçao do Clipper a respeito da
     última linha executada em uma rotina, funçao definida pelo usuário, ou
     bloco de código corrente.  A pilha de ativaçao é uma estrutura interna
     que mantém um registro para cada invocaçao de rotina, funçao, ou bloco
     de código.  Números de linha têm relaçao com o início do arquivo fonte
     original.  Linhas incluem uma diretiva de compilador, pré-processador,
     linha em branco, comentário, e uma continuaçao de linha.  Uma linha de
     várias declaraçoes é considerada uma única linha.

     Para a ativaçao corrente, PROCLINE() retorna o número da linha
     corrente.  Para uma ativaçao anterior, PROCLINE() retorna o número da
     linha que invocou a rotina, ou uma funçao definida pelo usuário onde
     PROCLINE() é invovcada.

     Caso a ativaçao que está sendo questionada seja uma avaliaçao de bloco
     de código, PROCLINE() retorna o número da linha da rotina na qual o
     bloco de código foi originariamente definido.

     PROCLINE() é utilizada juntamente com PROCNAME() para depuraçao.

 Exemplos

     Este exemplo demonstra o número de linha retornado por PROCLINE() para
     a ativaçao corrente, seguido do número de linha da ativaçao anterior:

     // Primeira linha do arquivo fonte
     MyFunction()
     RETURN

     FUNCTION MyFunction
        ? PROCLINE()            // Resulta: 6 (ativacao corrente)
        ? PROCLINE(1)           // Resulta: 2 (ativacao anterior)
        RETURN NIL

 Arquivos:  Biblioteca CLIPPER.LIB.
 To download this example - click here.

See Also: PROCNAME()