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
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas