aIns

aIns insere um elemento vazio (NIL) na posicao indicada, deslocando os elementos seguintes uma posicao pra frente. Tipicamente combina com atribuicao logo depois pra preencher.

aArr := {"A", "B", "C"}
aIns(aArr, 2)             // {"A", NIL, "B", "C"}
aArr[2] := "NEW"          // {"A", "NEW", "B", "C"}

Wrapper pratico

Static Function _aInserir(aArr, nPos, xValor)
    aSize(aArr, Len(aArr) + 1)  // cria espaco
    aIns(aArr, nPos)
    aArr[nPos] := xValor
Return aArr

Pegadinhas

• Nao aumenta tamanho automatico — ultimo elemento e perdido. Use aSize antes.
• Insere NIL, nao um valor — voce precisa atribuir depois.
• nPos > Len(aArr) nao da erro mas comportamento e indefinido.