ArrayAddItem

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
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

Árvore de páginas

Sintaxe

Parâmetros

Observações

Exemplos

Abrangência

Veja também