TOTVSTEC

Árvore de páginas

Adiciona novos elementos a um array que pode ser de tamanho pré-fixado ou não.

Sintaxe

ArrayAddItem( < aName >, < nQtdade >, [ nInitPos ] )

Parâmetros

Nome

Tipo

Descrição

Obrigatório

Referência

aName

vetor

Indica o Array que será manipulado.

X

 

nQtdade

numérico

Quantidade de elementos que serão incluídos.

X

 

nInitPos

numérico

Indica a posição inicial do Array onde os elementos serão inseridos.

 

 

Observações

  • Na liguagem 4GL, o tipo ARRAY pode ser criado com um tamanho pré-fixado ou não, sempre respeitando o tamanho mínimo de 1 elemento. Assim, é possível manipular o tamanho de um ARRAY incluindo e removendo elementos.
  • A partir do build 7.00.131227P versão 1.2.0, é possivel indicar a posição inicial do array onde serão inseridos novos elementos.

Exemplos

MAIN
  DEFINE ma_dados array[18] of char(15),
         x int
               
  call conout("1: Tamanho inicial do Array = "||ArrayLength(ma_dados))
  # Adiciono 20 elementos
  call ArrayAddItem(ma_dados,20)
  call conout("2: Tamanho do Array apos ArrayAddItem(ma_dados,20) = "||ArrayLength(ma_dados))
  
  # Preenche array
  FOR x=1 TO ArrayLength(ma_dados)
    LET ma_dados[x] = x
  END FOR
  
  # Exibe array
  FOR x=1 TO ArrayLength(ma_dados)
    CALL CONOUT("ARRAY["||x||"] = "||ma_dados[x])
  END FOR
END MAIN


MAIN
  DEFINE ma_dados array[18] of char(15),
         x int
         
  call conout("1: Tamanho inicial do Array = "||ArrayLength(ma_dados))
  
  # Preenche array
  FOR x=1 TO ArrayLength(ma_dados)
    LET ma_dados[x] = x
  END FOR
    
  # Inserindo 10 elementos a partir da poiscao 10. Tamanho final = 28
  call ArrayAddItem(ma_dados,10,10)
  call conout("2: Tamanho do Array apos ArrayAddItem(ma_dados,10,10) = "||ArrayLength(ma_dados))
  
  # Exibe array
  FOR x=1 TO ArrayLength(ma_dados)
    CALL CONOUT("ARRAY["||x||"] = "||ma_dados[x])
  END FOR
END MAIN

Abrangência

Disponível a partir do build 7.00.101202A

Veja também

  • Sem rótulos