Ir para o conteúdo

Função trace

trace(var#1,var#2,...,var#n) acompanha as avaliações através da Janela de saída.

Devolve uma cadeia com o valor dos argumentos, cuja ordem de saída e texto envolvente são definidos pelo primeiro argumento. Indicar o primeiro argumento de texto é opcional.

trace() é uma função criada para ajudar os utilizadores a depurar scripts.

Sintaxe

Se var#1 não for texto, trace() devolve os valores separados por vírgulas.

Exemplo

Se var#1 for texto, trace() devolve a cadeia (sem outros valores).

Exemplo

Se var#1 for texto com formato de trace, trace() devolve uma cadeia de acordo com o padrão de var#1.

Para mostrar valores de variáveis com texto ou ordem personalizados, insira entre chavetas o índice de posição da variável de trace(). O índice de posição é 0 para var#2, 1 para var#3, 2 para var#4, etc.

Exemplo

Nota: as chavetas escrevem-se com Shift+[ para "{" e Shift+] para "}".

A saída de trace() pode forçar a avaliação se um dos seguintes prefixos for colocado antes do índice de posição:

  • S: para avaliação simbólica
  • N: para avaliação numérica

Exemplo

Utilização

trace() pode ser utilizada:

  • diretamente, como uma função comum que requer avaliação numérica (=) ou simbólica (→)
  • diretamente, dentro de ciclos while
  • diretamente, dentro de ciclos for (deve ser efetuada pelo menos uma operação dentro do ciclo)
  • diretamente, dentro de line() (deve ser efetuada pelo menos uma operação dentro de line())
  • dentro de funções definidas pelo utilizador

Ver também

Esta página baseia-se num artigo da antiga wiki, escrito por Davide Carpi.