DocumentaciónAGREGAR(tabla, valor)
Nombre
AGREGAR - Agrega campos o registros a una tabla.
Sinopsis
AGREGAR(tabla, valor)
Descripcion
Agrega un elemento a una tabla o un campo a un registro, segun la forma de uso.
Es una primitiva interna de construccion y crecimiento dinamico de estructuras tabulares.
Comportamiento
- Puede agregar un registro completo a una tabla.
- Puede agregar un campo a un registro.
- Modifica la estructura recibida por referencia.
Funciones API relacionadas
ELIMINAR()INSERTAR()ES_CAMPO()
Parámetros
| Parámetro | Tipo | Descripción |
|---|---|---|
| tabla | TABLA | Tabla/registro destino. |
| valor | ANY | Campo/registro a agregar. |
Valor de retorno
VACIO - No retorna valor; modifica la tabla o registro recibido.
Ejemplo
ejemplo.blox
INCLUIR "tablas.api"
FUNCION PRINCIPAL
INICIO "Test de tabla basica"
TABLA persona, reg
persona = {
nombre = "Francisco",
edad = 30,
direccion = {ciudad = "Asuncion", barrio = "Mburucuya"}
}
persona = {
nombre = "Juan",
edad = 21,
direccion = {Ciudad = "Encarnacion"}
}
reg = {
apellido = "Ramirez",
documento = "8346837"
}
// 1. AGREGAR un registro tipo variable a la tabla
//
AGREGAR(persona, reg[1])
// 2. AGREGAR un registro tipo valor a la tabla
//
AGREGAR(persona, {nombre = "Santiago", apellido = "Perez", edad = 33})
// 3. AGREGAR un campo al registro 3 de la tabla persona
//
AGREGAR(persona[3], "nombre")
persona[3].nombre = "Joaquin"
tablas.imprimir(persona)
FINAL