Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
portuguese
Composition Setup
import.css=/download/attachments/3279126062824/newLayouttecnologia.css

Pagetitle
GetGlbValue
GetGlbValue

Retorna

...

a string armazenada em uma variável global.

Sintaxe

Bloco de código
collapsefalse
GetGlbValue( < cGlbName > )

Parâmetros

Nome

Tipo

Descrição

Obrigatório

Referência

cGlbName

caractere

Indica o nome da variável global.

X


Retorno

Nome

Tipo

Descrição

cValue

caractere

Retorna o valor da variável global especificada no parâmetro cGlbName. Caso a variável não seja encontrada, retorna um caracter vazio.

Informações
icontrue
titleObservações
  • Uma variável global acessada pela função GetGlbValue() somente retorna uma string como conteúdo;
  • Somente é possível recuperar através da função GetGlbValue() o valor atribuído a uma variável global criada pela função PutGlbValue();
  • Para recuperar o conteúdo de variáveis globais criadas via PutGlbVars(), capazes de armazenar valores de tipos diversos, deve-se utilizar a função GetGlbVars();
  • O escopo de uma variável global é a instância do serviço do Protheus Server que está executando a aplicação AdvPL. Assim, 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
  • 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.

Exemplos

Bloco de código
languagecpp
themeEclipse
linenumberstrue
collapsefalse
User Function teste()
//Neste exemplo, será demonstrado como criar, utilizar e limpar variáveis globais
User Function teste()
  cGlbName  := "TPL_GLBVALUE"
  cGlbValue := ""
  // Alimenta variável
  PutGlbValue(cGlbName,"Teste")
  // Verifica o valor da variável
  cGlbValue := GetGlbValue(cGlbName)
  // Limpa variável
  if Trim(cGlbValue) <> ""
    ClearGlbValue(cGlbName)
  endif
return nil

Abrangência

Microsiga Protheus 8.11 , Protheus 10

Veja também