GETAREA()

Sintaxe

GETAREA()

Propósito

Salva o ambiente ativo.

Argumentos

Nenhum.

Utilização

Essa função é utilizada para proteger e preservar o ambiente ativo quando houver a necessidade de algum processamento específico.

Para salvar outra área de trabalho (alias), que não a ativa, a função GetArea() deve ser executada dentro do alias. Por exemplo: SA1->(GetArea()).

A função retorna um array contendo as seguintes variáveis do ambiente:

• Alias()
• IndexOrd()
• Recno()

Exemplos

Suponhamos que o ambiente ativo seja do alias SA1, índice 1 e registro 345. Vejamos o exemplo abaixo:

LOCAL aAreaAnt := GETAREA()

dbSelectArea(“SC5”)

dbSetOrder(2)

…

<instruções do processamento>

…

RESTAREA(aAreaAnt)   // Retorna o ambiente anterior

RETURN NIL