Árvore de páginas

Insere ou Atualiza o valor de uma "chave" na "Tabela X" de uma determinada sessão, sem fazer bloqueio da "chave" <cChave> (Dirty).

Sintaxe

 

VarSetXD
lRet := VarSetXD( <cUID>, <cChave>, <xValor> )

Parâmetros

NomeTipoDescriçãoObrigatórioReferênciaObservações
cUIDCaractere

Identificador da sessão de Variáveis Globais

X  
cChaveCaractereIdentificador da chaveX  
xValorNumérico / Caractere / Data / LógicoValor a ser armazenadoX (aviso) O "Lógico" só está disponível em Build igual ou superior a 7.00.131227A NG

Retorno

NomeTipoDescriçãoObservações
lRetLógico

Indica se conseguiu armazenar o valor referente a sessão <cUID> e a chave <cChave>

Retorna .T. se a função foi executada corretamente e se houver algum erro retorna .F.

Observações

Se a chave <cChave> já existir, o valor armazenado será substituído pelo novo valor <xValor>.

Como esta função não faz o bloqueio da chave esta função sempre irá atualizar o valor, mesmo que uma transação esteja em curso.

Por conta de não fazer bloqueio na chave esta função é mais rápida que a função "VarSetX" , ou seja, se os seus "Jobs/Threads" não tiverem a necessidade de fazer uma transação, de preferência para o uso desta função.

(aviso) Disponível em Build igual ou superior a 7.00.131227A

Exemplos

Exemplo 

User Function exemplo()
  Local cMyUID := "teste_UID_RL"
  Local cChave := "chave"
  Local nValor := 32
  Local lRet := .F.
 
  lRet := VarSetUID(cMyUID, .T.)
  If(!lRet)
    ConOut("Erro na criação da sessão: " + cMyUID)
  EndIf

  lRet := VarSetXD(cMyUID, cChave, nValor)
  If(!lRet)
    ConOut("Erro na atualização da chave: " + cChave)
  EndIf
Return .T.
  • Sem rótulos