# Bibliotecas del motor Son las cuatro bibliotecas que vienen con Devkron desde la versión 1 y que usa prácticamente todo programa DKL. En Devkron 2.0 LTS se distribuyen junto a `dkl` con sus DLL y conservan los mismos nombres de función y el mismo comportamiento que en 1.x, con las correcciones y las funciones nuevas que se indican en cada página. | Encabezado | DLL | Para qué sirve | Página | |---|---|---|---| | `functions.dkh` | `Devkron.Functions.dll` | Registros, listas, tablas en memoria, cadenas, fechas, codificación y cifrado, archivos y carpetas, utilidades de conversión e iteración | [functions.dkh](/es/devkron/2.0/bibliotecas/motor/functions/) | | `serialize.dkh` | `Devkron.Serialize.dll` | JSON (`to.json`, `from.json`), y lectura y escritura de árboles XML y DKL | [serialize.dkh](/es/devkron/2.0/bibliotecas/motor/serialize/) | | `dbr.dkh` | `Devkron.DBR.dll` y adaptadores | Bases de datos relacionales (MySQL, SQL Server, PostgreSQL, Firebird): consultas, transacciones, sesiones, bloqueos y administración de conexiones | [dbr.dkh](/es/devkron/2.0/bibliotecas/motor/dbr/) | | `webcl.dkh` | `Devkron.WebClient.dll` | Cliente HTTP (`http.*`) y envío de correo (`smtp.send`) | [webcl.dkh](/es/devkron/2.0/bibliotecas/motor/webcl/) | ## Uso ```dkl #include "dkli.dkh" #! program "mi servicio" { #include "functions.dkh" #include "serialize.dkh" #include "dbr.dkh" #include "webcl.dkh" do print("listo") } ``` ```text listo ``` ## Conceptos que comparten las cuatro bibliotecas **Registros.** Un registro (`new r { … }`, `record.create()`, el resultado de `from.json` o `dbr.rec`) es un diccionario de campos. Sus nombres de campo **no distinguen mayúsculas**: `field.str(r, "FOLIO")` encuentra `folio`. Los campos que contienen otro objeto se asignan con `*` al final del nombre: `r<"cliente*">: otro`. **Listas.** Una lista (`list.create()`, `split`, `from.json` de un arreglo, `dbr.list`) tiene índice base cero. **Referencias.** Toda función que devuelve un objeto (registro, lista, tabla, conexión, fecha) se asigna a una variable `ref`: ```dkl ref l = list.create() ref db = dbr.open("principal@tienda") ``` **Rutas de campo.** `field.*`, `@` y `@@` aceptan rutas `"domicilio/ciudad"` para llegar a campos de registros anidados. **Números y objetos en parámetros de objeto.** En una función que recibe un objeto (`list.add`, `cell.set`, el tercer argumento de `@@set`…), un **número** o una cadena que es un número entero se interpreta como el índice interno de un objeto, no como el valor. Por eso: - para agregar cadenas o números a una lista use `list.addstr` y `list.addnum`; - para poner un número en una celda use `row.upd` o `row.add` con un registro; - un campo que debe guardar un objeto devuelto por una función se asigna con `r<"campo*">: f(x)`, no con `@"campo": f(x)` dentro de `new`. **Errores.** Una función que falla lanza una excepción con el formato `{1} Error en 'nombre.función. (mensaje…)'`. Se captura con un bloque `exception` después de la sentencia: ```dkl do print(field.str(r, "no_existe")) exception { do print(last_error()) do clear_exceptions() } ``` **Cultura.** Toda lectura de números y fechas es invariante (punto decimal); solo `format`, `date_str` y las marcas con formato usan la cultura de presentación del servidor. Ver [Fecha y hora](/es/devkron/2.0/bibliotecas/motor/functions/fechas.md) y [Cadenas](/es/devkron/2.0/bibliotecas/motor/functions/cadenas.md) (`format`). ## Relación con la documentación 1.x | Página 1.x | Página 2.0 | |---|---| | [functions.dkh](/es/devkron/Bibliotecas-de-funciones/functions/functions.md) | [functions.dkh](/es/devkron/2.0/bibliotecas/motor/functions/) | | [serialize.dkh](/es/devkron/Bibliotecas-de-funciones/serialize/serialize.md) | [serialize.dkh](/es/devkron/2.0/bibliotecas/motor/serialize/) | | [dbr.dkh](/es/devkron/Bibliotecas-de-funciones/dbr/dbr.md) | [dbr.dkh](/es/devkron/2.0/bibliotecas/motor/dbr/) | | [webcl.dkh](/es/devkron/Bibliotecas-de-funciones/webcl/webcl.md) | [webcl.dkh](/es/devkron/2.0/bibliotecas/motor/webcl/) |