TOTVSTEC

Árvore de páginas

Adiciona um novo item ao objeto tHashMap, indicando qual o campo da chave de busca.

Sintaxe

HMAdd( < oHash >, < aVal >, [ nColuna_1 ], [ nTrim_1 ], [ nColuna_N ], [ nTrim_N ] )

Parâmetros

Nome

Tipo

Descrição

Obrigatório

Referência

oHash

objeto

Objeto da classe HashMap (tHashMap)

X

 

aVal

vetor

Array com os valores que serão adicionados ao HashMap

X

 

nColuna_1

numérico

Indica o número da coluna que contem o valor da chave a ser inserida

 

 

nTrim_1

numérico

Tipo de Trim para colunas de caractere

 

 

nColuna_N

numérico

Informar mais de uma coluna se necessário (máximo 8)

 

 

nTrim_N

numérico

Tipo de Trim para as colunas do tipo caractere.

 

 

Retorno

Nome

Tipo

Descrição

lRet

lógico

Verdadeiro (.T.) se adicionou com sucesso e Falso (.F) se houve erro

Observações

  • 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).

Exemplos

Exemplo 1
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 := HMAdd(oHash,{"item10",5},1,3,2,3)
  aList := {}
  HMList(oHash,aList)
  varinfo("",aList) 
Return

Abrangência

Totvs Application Server com versão igual ou superior a 7.00.131227A

Veja também

  • Sem rótulos