TOTVSTEC

Árvore de páginas

Versões comparadas

Versão antiga 1

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

Gravado em

comparado com

Nova versão Atual

changes.mady.by.user Usuário desconhecido (ailton.lichman)

Gravado em

Chave

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

Pagetitle
PutGlbVars
PutGlbVars

...

Cria uma variável global para armazenar múltiplos valores de tipos diversos e armazena os valores fornecidos.

Sintaxe

Bloco de código
collapsefalse
PutGlbVars( < cGlbName >, < xValue1...N > )

Parâmetros

Nome

Tipo

Descrição

Obrigatório

Referência

cGlbName

caractere

Indica o nome

...

da variável global a ser

...

criada.

X

...

 


xValue1...N

qualquer

Indica

...

um ou mais

...

valores a serem armazenados na variável global. Ver Observações para os tipos suportados.

X


Observações

  • e em seus respectivos lugares serão armazenados valores do tipo NIL;
  • Caso um array a ser armazenado contenha elementos de tipos não suportados, somente estes elementos específicos serão submetidos às regras de substituição mencionadas;
  • Somente é possível recuperar os valores atribuídos a uma variável global criada Uma variável global alimentada pela função PutGlbVars() pode ter seus conteúdos recuperados através da 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 AdvplAdvPL. 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.
Informações
icontrue
titleObservações
  • Os valores a serem armazenados
armazenadas sob o identificador global. As variáveis
  • podem ser de qualquer tipo,
porém
  • a não ser bloco de código ou objeto;
  • Valores dos tipos bloco de código
e objetos
  • ou objeto não
são
  • serão armazenados na variável global
. O tipo Array é suportado, porém caso o array contenha elementos do tipo bloco de código ou objeto, eles não serão guardados – serão armazenados como NIL.

X

 

Exemplos

Bloco de código
languagecpp
themeEclipse
linenumberstrue
collapsefalse
User Function teste()
  // Alimenta valores das variáveis globais
  aGlbPut := {}
  aadd(aGlbPut,{"VarGlb01","Valor 01"})
  aadd(aGlbPut,{"VarGlb02","Valor 02"})
  aadd(aGlbPut,{"VarGlb03","Valor 03"})
  nValor := 123
  PutGlbVars("GlbNames",aGlbPut,nValor)
  // Retorna os valores das variáveis globais
  nValRet := 0
  aGlbRet := {}
  GetGlbVars("GlbNames",
<at:var
at:name="
aGlbRet,
"
/>nValRet
nValRet)
Return

Abrangência

Microsiga Protheus 8.11 , Protheus 10, Protheus 11

Veja também