Blox - Donde la lógica se vuelve natural

Nombre

INSERTAR - Inserta un registro en una posicion concreta de una tabla.

Sinopsis

INSERTAR(tabla, registro, indice)

Descripcion

Inserta un registro en la posicion indicada dentro de una tabla ya existente.

Es una primitiva interna de mutacion posicional cuando se necesita conservar un orden concreto.

Comportamiento

Recibe la tabla destino, el registro y el indice deseado.
Desplaza los registros posteriores segun corresponda.
Modifica la tabla por referencia.

Funciones API relacionadas

AGREGAR()
ELIMINAR()

Parámetros

Parámetro	Tipo	Descripción
tabla	TABLA	Tabla destino.
registro	TABLA	Registro a insertar.
indice	NUMERICO	Posición de inserción.

Valor de retorno

VACIO - No retorna valor.

Ejemplo

ejemplo.blox

FUNCION PRINCIPAL
INICIO

    TABLA personas, nuevo

    personas = {
        nombre = "Uno",
        orden = 1
    }

    personas = {
        nombre = "Tres",
        orden = 3
    }

    nuevo = {
        nombre = "Cero",
        orden = 0
    }

    INSERTAR(personas, {nombre = "Dos", orden = 2}, 2)
    INSERTAR(personas, nuevo, 1)
    nuevo[1].nombre = "MUTADO"
    INSERTAR(personas, {nombre = "Cuatro", orden = 4}, personas.dim + 1)

    IMPRIMIR("dim=", personas.dim)
    IMPRIMIR("|", personas[1], ",", personas[2], ",", personas[3], ",", personas[4], ",", personas[5])

FINAL

INSERTAR(tabla,registro,indice)\texttt{INSERTAR}(tabla, registro, indice)INSERTAR(tabla,registro,indice)

Parámetros

Valor de retorno

Ejemplo

$\texttt{INSERTAR}(tabla, registro, indice)$