Árvore de páginas

Versões comparadas

Chave

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

...

 

Nil (Nulo)
Portuguese

Pagetitle
PutGlbValue
PutGlbValue

Função: PutGlbValue

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

Sintaxe

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

Parâmetros

/Elementos

 

Nome

Tipo

Descrição

Obrigatório

Referência

cGlbName

caractere

Indica o nome da variável global.

X

 

cGlbName

Caracter

caractere

Indica o nome da variável global.

X

 

Retorno

Nome

Tipo

Descrição

cValue

Caracter

caractere

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

X 

Observaçõ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

  Endif
Return

Abrangência

Microsiga Protheus 8.11 , Protheus 10, Protheus 11

Veja

Também

também

, , ,

 

...