Histórico da Página

Incrementa o valor de um campo especificado de um hash armazenado na chave.

Sintaxe

KVHINCR( < cKey >, < @aValIns > )

Parâmetros

Nome	Tipo	Descrição	Obrigatório	Referência
cKey	character	Nome da chave principal que pretende incrementar o valor de seus campos.	X
aValIns	array	Array multidimensional com nomes dos campos e valores para incremento. Novos valores serão retornados por referência.	X	X

Retorno

Nome	Tipo	Descrição
xRetKV	array	Em caso de sucesso, xRetKV será Nil, porém, caso ocorra algum erro retorna: xRetKV $1]$ = comando executado no servidor KV \| xRetKV $2]$ = mensagem do erro.

Observações

Se o valor de incremento for positivo, então será somado ao valor já existente, porém se ele for negativo, então será subtraído.

Exemplos

function u_KVHINCR()

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

  oKVClient:KVOpenConn(cSrv,nPort)

  if ( oKVClient:KVIsConnected() )

    oKVClient:KVRunCmdExec( 'HSET mykey field 10.50' )
    
    // Valor positivo
    // --------------
      aValIns := {{'field',0.1}}
      oKVClient:KVHINCR( 'mykey', @aValIns )
      
      // Valor novo modo 1 [referencia]
      conout( 'Novo valor [ref]: ' + cValToChar(aValIns[1][2]) ) // deverá ser 10.6
      
      // Valor novo modo 2 [get]
      aKV := oKVClient:KVRunCmdExec( 'HGET mykey field' )
      conout( 'Novo valor [get]: ' + cValToChar(aKV[2]) ) // deverá ser 10.6

    // Valor negativo
    // --------------
      aValIns := {{'field',-5}}
      oKVClient:KVHINCR( 'mykey', @aValIns )
      conout( 'Novo valor: ' + cValToChar(aValIns[1][2]) ) // deverá ser 5.6

  endif

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

Abrangência

20.3.0.x ou superior

Árvore de páginas

Versões comparadas

Versão antiga 1

Nova versão 2

Chave

Sintaxe

Parâmetros

Retorno

Observações

Exemplos

Abrangência