TOTVSTEC

Árvore de páginas

Remove elementos de um Array.

Sintaxe

ArrayDeleteItem( < 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 removidos.

 

 

nInitPos

numérico

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

 

 

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 partir de que posição do array serão removidos os elementos.
  • Caso não seja informado o segundo parâmetro, serão deletados todos elementos do Array.

Exemplos

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

  # Exibe array
  FOR x=1 TO ArrayLength(ma_dados)
    CALL CONOUT("ARRAY["||x||"] = "||ma_dados[x])
  END FOR
  
  # Remove 10 itens a partir da posicao 5
  call ArrayDeleteItem(ma_dados,10,5)
  call conout("3: Tamanho do Array apos ArrayDeleteItem(ma_dados,10,5) = "||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