TOTVSTEC

Árvore de páginas

Versões comparadas

Versão antiga 5

changes.mady.by.user Usuário desconhecido (santos.vitor)

Gravado em

comparado com

Nova versão 6

changes.mady.by.user Fabio Garbin

Gravado em

Chave

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

Pagetitle
PutGlbValue
PutGlbValue

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

Sintaxe

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

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

...

cGlbName

...

caractere

...

Indica o nome da variável global.

...

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 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.

Exemplos

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

Abrangência

Microsiga Protheus 8.11 , Protheus 10, Protheus 11

Veja também