Histórico da Página

import.css=/download/attachments/6062824/tecnologia.css

Obtem Obtém o valor de chave simples ou composta a partir das colunas eleitas de um array. A chave obtida poderá ser usada nas funções: HMGet, HMSet, HMDel.armazenado correspondente a chave em um objeto da classe tHashMap.

Sintaxe

HMGet( < aArrayoHash >, [< nColuna_1yKey ]>, [ n_Trim_1 ], [ nColuna_N ], [ n_Trim_N ] < @aVal > )

Parâmetros

Retorno

Observações

Observações

• Se encontrou a chave (yKey), valor (aVal) irá conter o valor armazenado, caso contrário aVal permanecerá inalterado
• O valor de “N” varia de 0 (zero) até 8 colunas para serem combinadas na chave de busca.
• Se nenhuma coluna for adicionada (“N” = 0), usa por padrão a primeira coluna (“nColuna” = 1) e sem trim (“nTrim” = 0).
• Os valores de “nTrim” podem ser: 0 – não altera a palavra, 1 – Elimina espaços a esquerda, 2 – Elimina espaços a direita, 3 – Elimina espaços a esquerda e a direita.
• Se o valor de ”nTrim” não for fornecido, considera que não deve eliminar espaços da palavra (“nTrim” = 0).
• É recomendado que se utilize o “HMKey“ somente para obter chaves compostas, ou seja, que contenham mais de uma coluna na sua formação, pois para chaves simples (uma coluna), basta passar a variável para a inserção/busca.

Exemplos

User Function exemplo()
  Local oVal := nil
  lista := {}
  AAdd(lista, {"item1",23})
  AAdd(lista, {"item2",104})
  AAdd(lista, {"item3",41})
  AAdd(lista, {"item4",1})
  AAdd(lista, {"item5",18})
  oHash := AToHM(lista,1,3,2,3)
  
  cKey := HMKey({"item2",104},1,3,2,3)
  lRet := HMGet(oHash,cKey"item3",oVal)
  if lRet == .T.
    varinfo("Lista",oVal)
  endif 
Return

...