Árvore de páginas

Versões comparadas

Chave

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

Pagetitle
PutGlbValue
PutGlbValue

Função: PutGlbValue

Define o valor para uma variável global.

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

...

Cria uma variável global para armazenar um único valor do tipo string e armazena a string de conteúdo fornecida.

Sintaxe

Bloco de código
collapsefalse
PutGlbValue( < cGlbName >, < cValue > )

Parâmetros

Nome

Tipo

Descrição

Obrigatório

Referência

cGlbName

...

caractere

Indica o nome da variável global a ser criada.

X


cValue

...

caractere

Indica

...

a string de conteúdo a ser armazenado na variável global.

X


Informações
icontrue
titleObservações
  • Uma variável global criada pela função PutGlbValue() somente recebe uma string como conteúdo;
  • Somente é possível recuperar o valor atribuído a uma variável global criada pela função PutGlbValue() através da função GetGlbValue();
  • Para criar variáveis globais capazes de armazenar conteúdos de outros tipos de dados, deve-se utilizar 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. 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.

Exemplos

Bloco de código
languagecpp
themeEclipse
linenumberstrue
collapsefalse
User Function teste()
  
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.

// Neste exemplo, será demonstrado como criar, utilizar e limpar variáveis globais
  
globaiscGlbName
cGlbName  := "TPL_GLBVALUE"
  cGlbValue := ""// Alimenta 
variávelPutGlbValue
variável
  PutGlbValue(cGlbName,"Teste")
  // Verifica valor da variável
  cGlbValue := GetGlbValue(cGlbName)
  // Limpa variável
 
variávelif
 If Trim(cGlbValue) <> ""
    ClearGlbValue(cGlbName)
endif

  Endif
Return

Abrangência

Microsiga Protheus 8.11 , Protheus 10, Protheus 11

Veja

...

também

...

...

...