Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Portuguese

Pagetitle
PutGlbValue
PutGlbValue

Função: PutGlbValue

Define o valor para uma variável

Cria e define um valor ( string ) para uma variável global.

PutGlbValue ( < cGlbName>, < cValue> ) --> Nil

 

NomeTipoDescriçãoObrigatórioReferência
cGlbNameCaracterIndica o nome da variável global.X 
cValueCaracterIndica o valor da a string de conteúdo a ser armazenado na variável global.X 

 

Nil (Nulo)

Variáveis globais podem ser acessadas de qualquer programa dentro de uma mesma sessão do TOTVS Smart Client, pois facilita o acesso as informações de alta prioridade.

Uma variável global alimentada pela função PutGlbValue() somente recebe uma string como conteúdo, e somente é possível recuperar o valor atribuído através da função GetGlbValue(). Para criar identificadores globais capazes de armazenar conteúdos de outros tipos de dados, utilize a função PutGlbVars(). O escopo de uma variável global é a instância do serviço do Protheus Server que está executando a aplicação Advpl. Devido ao escopo não se restringir ao ambiente (Environment) ou ao processo (Thread) do programa Advpl que criou a variável global, seu conteúdo somente será eliminado da memória mediante a chamada da função ClearGlbValue(), ou após a finalização de todos os programas Advpl em execução na instância do Protheus Server onde a variável global foi criada.

 

// Neste exemplo, será demonstrado como criar, utilizar e limpar variáveis globaiscGlbNameglobais
cGlbName := "TPL_GLBVALUE"
cGlbValue := ""// Alimenta variávelPutGlbValuevariável
PutGlbValue(cGlbName,"Teste")
// Verifica valor da variável
cGlbValue := GetGlbValue(cGlbName)
// Limpa variávelifvariável
If Trim(cGlbValue) <> ""
ClearGlbValue(cGlbName)endif
Endif
Microsiga Protheus 8.11 , Protheus 10, Protheus 11