Usina BRGuía AdvPL
Ingresar
← Todos los temas
FUNCIóNEn revisión

AIns

AIns( <aDest>, <nPos> ) --> aRet

Inserta posición Nil sin ampliar array.

AInsAdvPL
01 · DESCRIPCIÓN GENERAL

Descripción general

AIns desplaza elementos hacia adelante y descarta último conservando Len. Para preservarlo ampliar array antes e insertar contenido en posición creada. El ejemplo reserva espacio con ASize. La operación cambia índices; actualizar selecciones dependientes después. (TOTVS, s.d., ref. 1)

02 · SINTAXIS

Sintaxis

AIns( <aDest>, <nPos> ) --> aRet

Parámetros

aDest
ArrayObligatorio

Array a modificar.

nPos
NuméricoObligatorio

Posición de inserción desde 1.

Retorno

Array tras inserción.

03 · EJEMPLO PRÁCTICO

Ejemplo comentado

#Include "Protheus.ch"

User Function EdAins()
    Local aItems := {"A", "C"}
    // Reserva posicion para no descartar C.
    ASize(aItems, Len(aItems) + 1)
    AIns(aItems, 2)
    aItems[2] := "B"
    ConOut(aItems[3])
Return Nil
Resultado esperado

Array esperado: {"A", "B", "C"}; salida C. En revisión: ejemplo editorial no compilado ni ejecutado en Protheus. Comprobar includes, release, RDD y contexto antes de probar.

BUENAS PRÁCTICAS
  • Validar posición tras dimensionar. Para añadir al final AAdd expresa mejor la intención.
  • En revisión: ejemplo editorial no compilado ni ejecutado en Protheus. Comprobar includes, release, RDD y contexto antes de probar.

Contenido relacionado

REFERENCIAS
  1. TOTVS. AIns. TDN. Consulta el 2026-10-25.
Estado
En revisión
Página creada el
Última revisión el
Idioma original
Portugués
Revisión
Usina.BR
0 comentario(s) aprobado(s)

Comentarios

Todavía no hay comentarios aprobados.

Inicia sesión con Google o Microsoft para comentar.

Desarrollado con Usina Docs · Alpha