# Biblioteca Edge La biblioteca Edge es todo lo que un programa de `dkle` tiene a la mano además del lenguaje. Viene integrada en `dkle` y se activa con `#include "edge.dkh"`. Casi todas sus funciones son las de las bibliotecas de Devkron 2.0, con el mismo nombre y el mismo comportamiento (incluidos los detalles, como el redondeo bancario de `round` o las reglas de JSON), así que su referencia es la de Devkron 2.0. Esta página dice qué funciones están disponibles y dónde está la referencia de cada grupo; las que agrega Edge se describen en [Funciones nuevas](/es/devkron/2.0/dkle/funciones-nuevas.md). ## Lenguaje y funciones incorporadas Todo el lenguaje de Devkron 2.0: sentencias, bloques `$$ … $$`, flechas de listas, operadores y funciones intrínsecas (`if`, `str`, `val`, `round`, `mod`, `abs`, `ndatetime.*`…). Ver la [Referencia del lenguaje](/es/devkron/2.0/lenguaje/). Funciones incorporadas: `print` (en `dkle` escribe en la bitácora), `eval`, `ftext`, `fxml`, `isset`, `vartype`, `isnull`, `ifnull`, `_null`, `last_error`, `last_error_code`, `rise_error`, `errordet` (por ejecución), `clear_exceptions`, `pop_exception`, `dklversion` y `dump_vars`, `dump_gvars`, `dump_objects` y `dump_functions`. ## Funciones por grupo | Grupo | Funciones | Referencia | |---|---|---| | Cadenas | `trim`, `ltrim`, `rtrim`, `left`, `right`, `substring`, `lremove`, `rremove`, `remove`, `length`, `toupper`, `tolower`, `split`, `replace`, `padleft`, `padright`, `contains`, `findstr`, `findstrex`, `ranychars`, `ranydiffchars`, `cut`, `isany`, `containschar`, `containsword`, `isanyword`, `format`; búfer de texto `text.create`, `text.echo`, `text.say`, `text.get`, `text.clear` | [Cadenas](/es/devkron/2.0/bibliotecas/motor/functions/cadenas.md) | | Texto, expresiones regulares y HTML | `text.unaccent`, `text.slug`, `text.truncate`, `text.is_email`, `num.round`, `regex.match`, `regex.replace`, `regex.first`, `regex.find`, `regex.groups`, `regex.split`, `regex.escape`, `html.encode`, `html.decode`; nuevas: `text.starts_with`, `text.ends_with` | [text.dkh](/es/devkron/2.0/bibliotecas/estandar/text.md) | | Registros | `record.create`, `record.copy`, `record.copyex`, `record.copyexin`, `record.caseinsensitive`, `record.clear`, `field.exist`, `field.typeof`, `field.str`, `field.num`, `field.obj`, `field.dstr`, `field.dnum`, `field.dobj`, `field.remove`, `@`, `@@`, `@set`, `@@set`, `@context.begin`, `@context.end` | [Registros](/es/devkron/2.0/bibliotecas/motor/functions/registros.md) | | Listas | `list.create`, `list.create_from_fields`, `list.count`, `list.add`, `list.addstr`, `list.addnum`, `list.addobj`, `list.addnull`, `list.ins`, `list.insstr`, `list.insnum`, `list.insobj`, `list.set`, `list.setstr`, `list.setnum`, `list.str`, `list.num`, `list.obj`, `list.atstr`, `list.atnum`, `list.atobj`, `list.type`, `list.get`, `list.remove`, `list.del`, `list.clear`, `list.merge`, `list.copy`, `list.slice`, `list.join`, `list.split`, `list.indexstr`, `list.indexnum`, `list.of`, `@count`, `@item` (solo listas); nuevas: `list.sort`, `list.sort_by`, `list.reverse` | [Listas](/es/devkron/2.0/bibliotecas/motor/functions/listas.md) | | Conversión y recorridos | `parse.num`, `parse.bool`, `field.parse.dnum`, `field.parse.dbool`, `foreach.fstr`, `foreach.fnum`, `foreach.fobj`, `foreach.lstr`, `foreach.lnum`, `foreach.lobj`; globales `@true`, `@false`, `@null`, `@bool`, `@int`, `@number`, `@positive`, `@negative`, `@string` | [Utilidades](/es/devkron/2.0/bibliotecas/motor/functions/utilidades.md) | | JSON y XML | `to.json`, `from.json`, `to.xml`, `parse.xmlStr`, `@parseSettings`; nueva: `to.json_pretty` | [serialize.dkh](/es/devkron/2.0/bibliotecas/motor/serialize/) | | Codificación | `md5`, `uuid`, `to.base64`, `from.base64`, `url_encode`, `url_dcode`, `encryp`, `decryp`; nueva: `uuid.v4` | [Codificación](/es/devkron/2.0/bibliotecas/motor/functions/codificacion.md) | | Fechas con objeto `DateTime` | `now`, `str2dt`, `dt2str`, `date_str` | [Fechas](/es/devkron/2.0/bibliotecas/motor/functions/fechas.md) | | Fechas numéricas y zonas horarias | `date.now`, `date.utc_now`, `date.add`, `date.diff`, `date.start`, `date.end`, `date.weekday`, `date.iso`, `date.from_iso`, `date.unix`, `date.from_unix`, `date.unix_utc`, `date.from_unix_utc`, `tz.now`, `tz.convert`, `tz.offset`; nuevas: `date.iso_utc`, `date.http` | [time.dkh](/es/devkron/2.0/bibliotecas/estandar/time.md) | | Hashes y JWT | `hash.sha256`, `hash.sha512`, `hash.hmac_sha256`, `hash.random_token`, `hash.equals`, `hash.b64url`, `hash.from_b64url`, `hash.pkce_challenge`, `jwt.encode`, `jwt.decode`, `jwt.read`, `jwt.encode_rs256`, `jwt.encode_rs256_kid`, `jwt.verify_rs256`, `jwt.verify_rs256_pem`, `jwt.clear_jwks`; nuevas: `hash.hmac_sha256_b64`, `hash.hmac_sha1`, `hash.hmac_sha1_b64`, `hash.hmac_sha512`, `hash.hmac_sha512_b64`, `hash.hex_to_b64`, `hash.b64_to_hex` | [hash.dkh](/es/devkron/2.0/bibliotecas/estandar/hash.md) | | URL | `url.host`, `url.scheme`, `url.path`, `url.port`, `url.absolute`, `url.is_absolute`, `url.query`, `url.with_query`, `url.encode`, `url.decode` | [url.dkh](/es/devkron/2.0/bibliotecas/estandar/url.md) | | Petición recibida | `httpreq.get`, `httpreq.post`, `httpreq.headers`, `httpreq.cookies`, `httpreq.has`, `httpreq.arg`, `httpreq.darg`, `httpreq.num`, `httpreq.dnum`, `httpreq.header`, `httpreq.cookie`, `httpreq.body`, `httpreq.json`, `httpreq.method`, `httpreq.is_post`, `httpreq.host`, `httpreq.uri`, `httpreq.url`, `httpreq.is_https`, `httpreq.ip`, `httpreq.user_agent`, `httpreq.auth_scheme`, `httpreq.bearer`, `httpreq.basic`; nuevas: `httpreq.path`, `httpreq.body_b64` | [http.dkh](/es/devkron/2.0/bibliotecas/estandar/http.md) | | Respuesta | `httpres.status`, `httpres.header`, `httpres.content_type`, `httpres.redirect`, `httpres.text`, `httpres.json`, `httpres.cors`, `httpres.no_cache`, `httpres.require_basic`, `httpres.cookie_raw`, `httpres.cookie`, `httpres.del_cookie`; nueva: `httpres.binary_b64` | [http.dkh](/es/devkron/2.0/bibliotecas/estandar/http.md) | | Cliente HTTP | `http.get_json`, `http.post_json`, `http.call`, `http.post_form`, `http.text`, `http.parallel`, `http.status`, `http.bearer`, `http.basic` y el encabezado especial `__timeout`; nuevas: `http.forward_headers`, `http.response_headers` | [http.dkh](/es/devkron/2.0/bibliotecas/estandar/http.md) | | OAuth 2.0 | `oauth.client_credentials`, `oauth.authorize_url`, `oauth.exchange_code`, `oauth.refresh`, `oauth.bearer` | [oauth.dkh](/es/devkron/2.0/bibliotecas/estandar/oauth.md) | | Caché en memoria | `cache.set`, `cache.setnum`, `cache.get`, `cache.dget`, `cache.str`, `cache.num`, `cache.obj`, `cache.type`, `cache.has`, `cache.del`, `cache.clear`, `cache.count`; nuevas: `cache.incr`, `cache.set_nx`, `cache.keys`, `cache.ttl` | [threads.dkh](/es/devkron/2.0/bibliotecas/estandar/threads.md) y [Funciones nuevas](/es/devkron/2.0/dkle/funciones-nuevas.md) | | Candados y pausa | `threads.lock`, `threads.unlock`, `threads.sleep` | [threads.dkh](/es/devkron/2.0/bibliotecas/estandar/threads.md) | | Configuración y entorno | `config.get`, `config.dget`, `env.get`, `env.dget` (nuevas) | [Funciones nuevas](/es/devkron/2.0/dkle/funciones-nuevas.md) | | Bitácora | `log.info`, `log.warn`, `log.error`, `log.json`, `log.write` | [Funciones nuevas](/es/devkron/2.0/dkle/funciones-nuevas.md) | ## Lo que cambia en Edge Las funciones de la tabla se comportan como en Devkron 2.0, con estas diferencias, todas a propósito: - **Cultura invariante.** `format`, `dt2str`, `date_str` y demás leen y escriben siempre con la cultura invariante: punto decimal, sin separador de miles por cultura y nombres de meses y días en inglés. El formato se da con la cadena de formato. Edge sirve API, no pantallas. - **Caché y candados por sitio.** `cache.*` y `threads.lock` solo ven las llaves y candados de su sitio, con tope de memoria (`max_cache_mb`); un candado sin liberar se libera al terminar la ejecución. - **Cliente HTTP con límites.** Aplica `outbound` y `max_response_kb` del sitio; no guarda cookies entre peticiones; acepta respuestas comprimidas con gzip y deflate (no brotli). - **Bitácora.** `log.*` escribe una línea JSON en la salida estándar; no hay `log.to` ni `log.file`. - **`@count` y `@item`** son solo para listas. - **`field.typeof` de un campo nulo** devuelve su tipo sin lanzar el error interno que lanza Devkron 2.0. ## Lo que no está en Edge Llamar a estas funciones desde un sitio da el error «La función '…' no está disponible en Devkron Edge», y `dkle check` las marca antes: | Grupo | Funciones | |---|---| | Archivos y carpetas | `file.*`, `dir.*`, `list.files`, `list.dirs`, `path.concat`, `hash.md5_file`, `hash.sha256_file`, `parse.dklFile`, `parse.xmlFile` | | Subida y descarga de archivos | `httpreq.files`, `httpreq.file`, `httpreq.save_file`, `httpres.file`, `httpres.binary` (use `httpres.binary_b64`), `http.post_multipart` | | Tablas | `table.*`, `row.*`, `col.*`, `cell.*` (use registros y listas) | | Hilos y procesos | `threads.run`, `threads.run_code`, `threads.wait`, `threads.wait_any`, `threads.done`, `threads.result`, `threads.error`, `threads.pool`, `threads.cpus`, `exec`, `commandline`, `from.args` | | Duplicados o sustituidos | `hmacsha256` (use `hash.hmac_sha256`), `md5e`, `to.b64`/`from.b64` (use `to.base64`/`from.base64`), `to.jsonNet`, `parse.dklStr`, `parse.buildXml`, `httpres.ok`, `httpres.fail` (use `httpres.json` con `httpres.status`), `html.attrs`, `encoding`, `text.append`, `text.append_line`, `text.cleartext`, `text.get_string` | | Bibliotecas completas | `dbr.dkh` (bases de datos), `webcl.dkh` (cliente HTTP y correo antiguos), `fs.dkh`, `zip.dkh`, `log.dkh` y las bibliotecas de terceros | Tampoco hay interop con ensamblados (`#import`, `_import_library`, `_map_function`, `_invoke`), ni `runcode`.