DocumentaciónELIMINAR(tabla, selector)
Nombre
ELIMINAR - Elimina campos, registros o contenido de una tabla.
Sinopsis
ELIMINAR(tabla, selector)
Descripcion
Elimina un campo de un registro, un registro de una tabla o el contenido completo de una estructura, segun la forma usada.
Es la primitiva interna de borrado para estructuras tabulares dentro del runtime.
Comportamiento
- Puede borrar campos de un registro.
- Puede borrar registros concretos de una tabla.
- Puede vaciar una tabla completa segun la firma usada.
Funciones API relacionadas
AGREGAR()INSERTAR()ES_CAMPO()
Parámetros
| Parámetro | Tipo | Descripción |
|---|---|---|
| tabla | TABLA | Tabla/registro destino. |
| selector | ANY | Campo/registro a eliminar. |
Valor de retorno
VACIO - No retorna valor; modifica la tabla o registro recibido.
Ejemplo
ejemplo.blox
INCLUIR "tablas.api"
FUNCION cargar_persona()
FUNCION PRINCIPAL
INICIO "Test de ELIMINAR()"
TABLA persona
// 1. ELIMINAR(tabla[i], campo)
//
persona = cargar_persona()
IMPRIMIR("\n1. Antes de ELIMINAR(persona[3], \"ruc\")")
tablas.imprimir(persona)
ELIMINAR(persona[3], "ruc")
IMPRIMIR("\nDespues de ELIMINAR(persona[3], \"ruc\")")
tablas.imprimir(persona)
// 2. ELIMINAR(tabla[i])
//
persona = cargar_persona()
IMPRIMIR("\n2. Antes de ELIMINAR(persona[2])")
tablas.imprimir(persona)
ELIMINAR(persona[2])
IMPRIMIR("\nDespues de ELIMINAR(persona[2])")
tablas.imprimir(persona)
// 3. ELIMINAR(tabla, indice)
//
persona = cargar_persona()
IMPRIMIR("\n3. Antes de ELIMINAR(persona, 1)")
tablas.imprimir(persona)
ELIMINAR(persona, 1)
IMPRIMIR("\nDespues de ELIMINAR(persona, 1)")
tablas.imprimir(persona)
// 4. ELIMINAR(tabla)
//
persona = cargar_persona()
IMPRIMIR("\n4. Antes de ELIMINAR(persona)")
tablas.imprimir(persona)
ELIMINAR(persona)
IMPRIMIR("\nDespues de ELIMINAR(persona)")
IMPRIMIR("\npersona.dim = ", persona.dim)
FINAL
FUNCION cargar_persona()
INICIO
TABLA persona
persona = {
nombre = "Francisco",
edad = 30,
casado = VERDADERO,
direccion = {ciudad = "Asuncion", barrio = "Mburucuya"}
}
persona = {
nombre = "Juan",
edad = 21,
casado = VERDADERO,
direccion = {ciudad = "Encarnacion"}
}
persona = {
apellido = "Ramirez",
documento = "8346837",
ruc = "808080-8",
casado = FALSO
}
RETORNAR persona
FINAL_FUNCION