aDestArrayObrigatório
Array a modificar.
FUNçãOEm revisão
AIns
AIns( <aDest>, <nPos> ) --> aRetInsere uma posição nula sem aumentar o array.
Visão geral
AIns desloca os elementos para frente e descarta o último, mantendo Len. Para preservar o último elemento, aumente o array antes de inserir e depois atribua o novo conteúdo à posição criada. O exemplo usa ASize para reservar espaço. A operação muda índices e deve ser feita antes de atualizar seleções que dependam deles. (TOTVS, s.d., ref. 1)
Sintaxe
AIns( <aDest>, <nPos> ) --> aRetParâmetros
nPosNuméricoObrigatório
Posição da inserção, a partir de 1.
Retorno
Array após a inserção.
Exemplo comentado
#Include "Protheus.ch"
User Function EdAins()
Local aItens := {"A", "C"}
// Reserva uma posicao para nao descartar C.
ASize(aItens, Len(aItens) + 1)
AIns(aItens, 2)
aItens[2] := "B"
ConOut(aItens[3])
Return NilResultado esperado
Array esperado: {"A", "B", "C"}; saída C. Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.
- Validar a posição após o dimensionamento. Para apenas acrescentar ao final, AAdd costuma expressar melhor a intenção.
- Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.
Comentários
Ainda não há comentários aprovados.
Entre com Google ou Microsoft para comentar.