Função: AIns
Inclui um elemento nulo na posição definida e 'empurra' os demais para frente descartando o último elemento.
AIns ( < aDestino>, < nPosicao> ) --> Nil
Nome | Tipo | Descrição | Obrigatório | Referência |
aDestino | Vetor | Indica o array que será manipulado. | X | |
nPosicao | Numérico | Indica a posição, a partir da primeira, na qual será inserido um elemento nulo. | X |
Nil (Nulo)
- Essa função não altera a quantidade de elementos do array. Após inserir um elemento nulo na posição definida, os demais sobem uma posição e o último é descartado.
- Se precisar adicionar um elemento sem perder o último, utilize a função AAdd. Essa função, permite acrescentar um elemento no final do array e, em seguida, inserir na posição desejada.
#DEFINE CRLF Chr(13)+Chr(10)
User Function Exemplo()
Local aExemplo := {1, 2, {11, 22, 33}, 4, 5}
Local cMensagem := ""
//+----------------------------------------------------------------------------+
//|Exemplifica o uso da função AIns |
//+----------------------------------------------------------------------------+
AIns(aExemplo[3], 2)
AIns(aExemplo, 2)
AIns(aExemplo, 3)
cMensagem += "aExemplo[1] = " + cValToChar(aExemplo[1]) + CRLF
cMensagem += "aExemplo[2] = " + cValToChar(aExemplo[2]) + CRLF
cMensagem += "aExemplo[3] = " + cValToChar(aExemplo[3]) + CRLF
cMensagem += "aExemplo[4] = " + cValToChar(aExemplo[4]) + CRLF
cMensagem += "aExemplo[5] = " + cValToChar(aExemplo[5])
//+----------------------------------------------------------------------------+
//|Apresenta uma mensagem com os resultados obtidos |
//+----------------------------------------------------------------------------+
Return MsgInfo(cMensagem, "Exemplo do AIns")
Exemplo da função AIns
Microsiga Protheus 8.11 , Protheus 10
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas