TOTVSTEC

Árvore de páginas

Você está vendo a versão antiga da página. Ver a versão atual.

Comparar com o atual Ver Histórico da Página

« Anterior Versão 4 Próxima »

Função: ADel

Elimina um elemento do array e 'arrasta' os demais para trás tornando nulo o último elemento.

Sintaxe

ADel ( < aFonte>, < nPosição> ) --> Nil

Parâmetros/Elementos

 

NomeTipoDescriçãoObrigatórioReferência
aFonteVetorIndica o array que contém um elemento para ser eliminado.X 
nPosiçãoNuméricoIndica a posição do elemento no array, a partir do primeiro, que será eliminado.X 

 

Retorno
Nil (Nulo)
Observações

Além disso, o último elemento pode ser removido da estrutura, se conveniente, através da função ASize.

 

 

Exemplos
#DEFINE CRLF Chr(13)+Chr(10)
User Function Exemplo()
Local aExemplo := {1, 2, {11, 22, 33}}
Local cMensagem := ""
//+----------------------------------------------------------------------------+
//|Exemplifica o uso da função ADel                                            |
//+----------------------------------------------------------------------------+
  cMensagem += "Dimensão de AExemplo = " + cValToChar(Len(aExemplo)) + CRLF
  cMensagem += "aExemplo[1] = " + cValToChar(aExemplo[1])            + CRLF
  cMensagem += "aExemplo[2] = " + cValToChar(aExemplo[2])            + CRLF
  cMensagem += "aExemplo[3][1] = " + cValToChar(aExemplo[3][1])      + CRLF
  cMensagem += "aExemplo[3][2] = " + cValToChar(aExemplo[3][2])      + CRLF
  cMensagem += "aExemplo[3][3] = " + cValToChar(aExemplo[3][3])      + CRLF
  ADel(aExemplo, 2)
  ASize(aExemplo, 2)
  cMensagem += "Dimensão atual = " + cValToChar(Len(aExemplo))       + CRLF
  cMensagem += "aExemplo[1] = " + cValToChar(aExemplo[1])            + CRLF
  cMensagem += "aExemplo[2][1] = " + cValToChar(aExemplo[2][1])      + CRLF
  cMensagem += "aExemplo[2][2] = " + cValToChar(aExemplo[2][2])      + CRLF
  cMensagem += "aExemplo[2][3] = " + cValToChar(aExemplo[2][3])      + CRLF
//+----------------------------------------------------------------------------+
//|Apresenta uma mensagem com os resultados obtidos                            |
//+----------------------------------------------------------------------------+
Return MsgInfo(cMensagem, "Exemplo do ADel")

Preview
Exemplo da função ADel
Abrangência
Microsiga Protheus 8.11 , Protheus 10
Veja Também
Manipulação de matriz

 

  • Sem rótulos