Á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
PutGlbValue
PutGlbValue

...

Função: PutGlbValue

Cria e define um valor ( string ) 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


  Nil (Nulo)
Informações
icon
true
titleObservações
  • Uma variável global
alimentada
  • criada pela função PutGlbValue() somente recebe uma string como conteúdo
, e somente
  • ;
  • 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
identificadores
  • variáveis globais capazes de armazenar conteúdos de outros tipos de dados,
utilize
  • 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
  • AdvPL.
Devido
  • Assim, devido ao escopo não se restringir ao ambiente (Environment) ou ao processo (Thread) do programa
Advpl
  • 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
  • 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

...

...

...

...

 

...