# Bibliotecas de funciones DKL tiene pocas funciones incorporadas en el lenguaje (`print`, `str`, `val`, `isnull`, `ftext`…). Casi todo lo que hace un programa real (leer un campo de un registro, consultar MySQL, llamar una API, escribir un archivo) lo resuelven **bibliotecas**: encabezados `.dkh` que se incluyen en el programa y que conectan nombres de función DKL con código .NET o con funciones escritas en DKL. Esta sección es para el programador de Devkron 2.0 LTS que escribe servicios JSON, sitios con nginx, tareas de consola o integraciones. Explica qué bibliotecas hay, de dónde salen, cómo se incluye cada una y documenta cada función con ejemplos ejecutados. ## Los tres grupos | Grupo | Qué trae | Cómo se obtiene | Documentación | |---|---|---|---| | **1. Bibliotecas del motor** | `functions.dkh` (registros, listas, tablas, cadenas, fechas, codificación, archivos, utilidades), `serialize.dkh` (JSON, XML, DKL), `dbr.dkh` (bases de datos relacionales), `webcl.dkh` (HTTP y correo SMTP) | Vienen con la distribución de Devkron, junto a `dkl` | [Bibliotecas del motor](/es/devkron/2.0/bibliotecas/motor/) | | **2. Bibliotecas estándar nuevas de 2.0** | `threads.dkh`, `http.dkh` (con `httpreq.*` y `httpres.*`), `url.dkh`, `zip.dkh`, `time.dkh`, `text.dkh`, `hash.dkh` (con JWT), `oauth.dkh`, `fs.dkh`, `log.dkh` | Vienen con la distribución de Devkron 2.0, junto a `dkl` | [Bibliotecas estándar](/es/devkron/2.0/bibliotecas/estandar/) | | **3. Bibliotecas de terceros** | `csv.dkh`, `xlsx.dkh` y `doc.dkh` (office), `image.dkh`, `html.dkh`, `markdown.dkh` | Se instalan aparte: un zip por biblioteca del repositorio `Induxsoft/dkl2-thirdparty` | [Bibliotecas de terceros](/es/devkron/2.0/bibliotecas/terceros/) | Además, en esta sección: | Página | Para qué | |---|---| | [Devkron Data Model (DDM)](/es/devkron/2.0/bibliotecas/ddm/) | Dialecto `.ddm` para definir bases de datos y las herramientas `dbgen` e `install-model` que generan el SQL y actualizan bases en producción | ## Cómo se incluye cada tipo ### Bibliotecas del motor y estándar Ya están en la carpeta de `dkl`. Basta con incluir el encabezado **dentro** del bloque `program`, después de `dkli.dkh`: ```dkl #include "dkli.dkh" #! program "mi servicio" { #include "functions.dkh" #include "serialize.dkh" #include "dbr.dkh" #include "webcl.dkh" do print("listo") } ``` ```text listo ``` - `dkli.dkh` va **fuera** de `program` y antes de `#!`: define la sintaxis imperativa. Los demás encabezados van dentro. - `#include "functions.dkh"` se busca en la carpeta del programa, en las carpetas agregadas con `#path` y en la carpeta de `dkl`. - Cada encabezado carga su DLL (`Devkron.Functions.dll`, `Devkron.Serialize.dll`, `Devkron.DBR.dll`, `Devkron.WebClient.dll`) con `_import_library`, que la busca junto a `dkl`. - Incluya solo lo que use: cada encabezado es independiente. `functions.dkh` casi siempre hace falta, porque las demás bibliotecas devuelven registros y listas que se leen con sus funciones. - Las bibliotecas estándar nuevas se incluyen igual (`#include "http.dkh"`); vea su [página](/es/devkron/2.0/bibliotecas/estandar/). ### Bibliotecas de terceros No vienen con el motor porque dependen de componentes de otros autores. Para usarlas: 1. Descargue el zip de la biblioteca (`dkl2--.zip`) del repositorio `Induxsoft/dkl2-thirdparty`. 2. Descomprímalo **en la carpeta de `dkl`**, sin subcarpetas: la DLL, sus dependencias y el `.dkh` quedan junto a `dkl`. 3. Si FastCGI ya estaba corriendo, reinícielo (las DLL se cargan una vez por proceso). 4. Incluya el encabezado como cualquier otro: `#include "csv.dkh"`. ```bash cd /opt/devkron sudo unzip -o ~/dkl2-csv-1.0.0.zip sudo systemctl restart devkron ``` El detalle (Windows, comprobación de la instalación, licencias) está en [Bibliotecas de terceros](/es/devkron/2.0/bibliotecas/terceros/). ## Errores típicos | Mensaje | Causa | Solución | |---|---|---| | `Función: to.json no reconocida o no registrada` | Falta el `#include` del encabezado que define la función (aquí `serialize.dkh`) | Agregue el `#include` dentro de `program` | | `Función: context.begin no reconocida o no registrada` | El nombre está mal escrito (la función se llama `@context.begin`) | Revise el nombre exacto en la página de la biblioteca | | `{9999} Error de sintaxis … No se puede encontrar el archivo csv.dkh` | La biblioteca de terceros no está instalada junto a `dkl` | Descomprima su zip en la carpeta de `dkl` | ## Si viene de Devkron 1.x Las cuatro bibliotecas del motor tienen **las mismas funciones** que en 1.x, con el mismo comportamiento (salvo las correcciones que se indican en cada página). Lo nuevo: - `functions.dkh` agrega funciones `list.*` con índices negativos y altas tipadas (`list.addstr`, `list.atnum`, `list.slice`, `list.join`, `list.of`…). - `dbr.dkh` funciona igual con drivers actuales; PostgreSQL y Firebird quedan probados y varios defectos se corrigieron. - Las bibliotecas estándar y de terceros son nuevas; sustituyen a `dkl.async`, a partes de `dkl-web` y a extensiones sueltas. La documentación anterior, por función, está en las páginas 1.x de [functions.dkh](/es/devkron/Bibliotecas-de-funciones/functions/functions.md), [serialize.dkh](/es/devkron/Bibliotecas-de-funciones/serialize/serialize.md), [dbr.dkh](/es/devkron/Bibliotecas-de-funciones/dbr/dbr.md) y [webcl.dkh](/es/devkron/Bibliotecas-de-funciones/webcl/webcl.md).