TOTVSTEC

Árvore de páginas

Executa inserção de uma chave no servidor KV caso ela não exista. Se for chamado novamente, manterá somente o dado imputado originalmente.


Sintaxe


KVSetNX( < cKey >, < xValue > )


Parâmetros
NomeTipoDescriçãoObrigatórioReferência
cKeycharacterNome da chave que pretende incluir.X
xValuevariantValor a ser atribuído para a chave informada.X
Retorno
NomeTipoDescrição
xRetKVarrayxRetKV[1]= mensagem de Erro caso exista type:C, senão conteúdo será Nil type:U
xRetKV[2]= retorno do servidor KV ao executar comando "setnx".
Exemplos


function u_KVSetNX()

  local oKVClient := tTecKVClient():New()
  local cSrv      := '127.0.0.1'
  local nPort     := 6379
  local aKV       := {}
	local xValue

  oKVClient:KVOpenConn(cSrv,nPort)

  if ( oKVClient:KVIsConnected() )

    aKV := oKVClient:KVSetNX( 'language', 'tlpp' )
		aKV := oKVClient:KVSetNX( 'language', 'advpl' )
    if ( empty(aKV[1]) )
			oKVClient:KVGet('language',@xValue)
			conout( "language: " + cValToChar(xValue) ) // tlpp
		else
			conout( "ERROR: " + aKV[1] )
		endif
  endif

  oKVClient:Finish()  // <- Nao esquecer
return


Abrangência

20.3.0.x ou superior

  • Sem rótulos