ADVPL em essência é o Clipper (piorado). A linguagem possui uma coisa chamada escopo dinâmico, umas das piores invenções da computação. Mas não é um grande problema, porque esteesse mecanismo é totalmente opcional, você pode usar variáveis locais como qualquer linguagem e ter o escopo léxico normalmente, sem prejuízos. Todo bom programador sabe que não deve usar escopo dinâmico, a não ser em linguagens feitas só para criacriar scripts, mesmo nessas linguagens não é incentivado pelos próprios autores.
O escopo da variável é determinado pelo momento da execução que ela foi criada e sobrevive e e éé visível até que o escopo esteja ativo ainda, mesmo que o escopo léxico seja outro. Ou seja, a variável é criada em uma função e todas as funções que ela chamar e as que foram chamadas na pilha toda, a variávelela existe e é visível normalmente, ela só deixa de existir quando finalizar a função que a criou. Ela é criada por padrão se não colocar nenhumalgum atributo modificador de escopo ou se for explícito e declarar a variável como private
.
É uma espécie de variável pública global, onde esta tem o tempo de vida por toda a aplicação a partir do momento que é criada e sempre é visível, mesmo fora (depois de finalizar) de onde ela foi criada, só que a variável privada tem io escopo um pouco reduzido, já que ela só exiteexiste pra cima da pilha e não pra baixo.
Então em seus códigos só use local
(ou static
em alguns raros casos), não use public
ou private
em hipótese alguma. Mas consuma as variáveis existentes declaradas assim pelo sistema. Elas acabam fazendo parte do contrato, da API. Considere elas sempre como se eleselas tivesse sido recebidas como parâmetro.
Lamento você ter que passar por istoisso. Também passei. Tive que pedir a criação de pontos de entrada novos para resolver sem depender dessas variáveis. Quando eles criam coisas novas eles fazem certo e passam argumentos para a minha função de usuário, hoje eles sabem que não é para usar istoisso. Mas adivinha de novo? Nem todos os programadores lá sabem o que estão fazendo ou estão comprometidos em fazer certo e muita coisa ainda é criada desta forma. Quando passa no único departamento que é ISO 9000 lá (sim, só um departamento minúsculo tem a certificação) fazem certo. E obviamente que tudo o que é legado não tem como resolver porque a maioria das variáveis viraram parte do "contrato".
Olhe na depuração as variáveis disponíveis, faça isso em vários lugares e veja se é algo pontual como diz a outra resposta. Algumas pessoas temtêm acesso aos fontes atuais do Protheus, se você tiver veja se é pontual. Eu vi, e não é ainda, hoje. A lista só não aumenta mais porque agora entendem que não devem criar novas assim, o que confirma tudo o que eu disse acima.