# text.dkh: expresiones regulares, texto, redondeo y HTML `text.dkh` reúne las operaciones de texto que hoy cada programa resuelve a mano: expresiones regulares, quitar acentos, generar *slugs* para URL, recortar, validar correos, redondeo comercial y escape de HTML. Viene con la distribución de Devkron 2.0 (`Devkron.Ext.Base.dll`). ## Cuándo usarla - Validar y limpiar datos de formularios: RFC, CURP, códigos postales, correos. - Búsquedas que no distingan acentos (`Pérez` = `perez`). - Nombres de archivo y URL a partir de un título (`Lista de precios 2026` → `lista-de-precios-2026`). - Redondear importes como en una factura (2.675 → 2.68). - Generar HTML seguro con datos del usuario (`html.encode`, `html.attrs`). ```dkl #include "text.dkh" ``` ## Expresiones regulares: regex.* | Función | Devuelve | Descripción | |---|---|---| | `regex.match(texto, patron)` | lógico | `@true` si el patrón aparece en el texto | | `regex.replace(texto, patron, reemplazo)` | cadena | Reemplaza todas las coincidencias; `$1` y `${nombre}` insertan grupos | | `regex.first(texto, patron)` | cadena | Primera coincidencia; `""` si no hay | | `regex.find(texto, patron)` | lista | Todas las coincidencias | | `regex.groups(texto, patron)` | registro | Grupos de la primera coincidencia: los que tienen nombre, por su nombre; los demás, `"1"`, `"2"`…; `"0"` es la coincidencia completa. Vacío si no coincide | | `regex.split(texto, patron)` | lista | Partes del texto separadas por el patrón | | `regex.escape(texto)` | cadena | El texto con los caracteres especiales escapados, para buscarlo literalmente | - Los patrones son los de .NET. Para que coincida el texto completo, use `^…$`; para no distinguir mayúsculas, empiece con `(?i)`. - **En una cadena DKL la barra invertida se escribe doble**: `\d` se escribe `"\\d"`, `\.` se escribe `"\\."`. Un `"\d"` sencillo no es lo que espera. - Cada operación tiene un límite de 5 segundos: un patrón que tarda más (como `(a+)+` sobre textos largos) lanza error en vez de colgar el servidor. ## Texto: text.* | Función | Devuelve | Descripción | |---|---|---| | `text.unaccent(texto)` | cadena | Quita acentos y diacríticos (`Ñandú` → `Nandu`) | | `text.slug(texto)` | cadena | Minúsculas, sin acentos, solo `a-z`, `0-9` y guiones | | `text.truncate(texto, n)` | cadena | A lo más `n` caracteres, con `…` al final si se cortó | | `text.is_email(texto)` | lógico | `@true` si tiene forma de correo (no comprueba que exista) | Estas funciones conviven con `text.append`, `text.append_line`, `text.cleartext` y `text.get_string` de `functions.dkh`, que siguen igual. Ojo con `left(s, n)` de `functions.dkh`: **omite** los primeros `n` caracteres (equivale a `Substring(n)` de .NET), no devuelve los `n` primeros. Para cortar a una longitud use `text.truncate` o `substring(s, 0, n)`. ## Redondeo: num.round | Función | Devuelve | Descripción | |---|---|---| | `num.round(n, decimales)` | número | Redondeo comercial: la mitad se aleja de cero (`2.675` → `2.68`, `-2.5` → `-3`). `decimales` de 0 a 28 | `round()` del motor usa redondeo bancario (la mitad va al par: `2.5` → `2`) y sigue igual. Para importes que ve el cliente y para CFDI use `num.round`. ## HTML: html.encode, html.decode, html.attrs | Función | Devuelve | Descripción | |---|---|---| | `html.encode(texto)` | cadena | Escapa `<`, `>`, `&`, `"` y `'`; los caracteres de U+00A0 a U+00FF salen como `&#nnn;` (`é` → `é`), que el navegador muestra igual | | `html.decode(texto)` | cadena | Convierte entidades (`&`, `ñ`, `ñ`) a caracteres | | `html.attrs(registro)` | cadena | `a="1" b="x"` con los valores escapados; omite campos nulos, objetos y nombres inválidos | `html.attrs` sustituye a `htmlAttributesFromRec` de `dkl-web`, que sigue igual. A diferencia de aquella, no agrega el atributo `uielement` y sí escapa los valores. Para **leer** páginas HTML use [html.dkh](/es/devkron/2.0/bibliotecas/terceros/html.md), que se instala aparte. ## Ejemplo ```dkl #include "dkli.dkh" #! program "texto" { #include "functions.dkh" #include "serialize.dkh" #include "text.dkh" rfc = "xaxx010101000" do print("RFC válido: " + str(regex.match(rfc, "(?i)^[A-ZÑ&]{3,4}\\d{6}[A-Z0-9]{3}$"))) do print(regex.replace("2026-10-27", "(\\d+)-(\\d+)-(\\d+)", "$3/$2/$1") + " primera: " + regex.first("Folio F-153 y F-154", "F-\\d+")) ref g = regex.groups("Pedido F-2026-0153", "(?[A-Z])-(?\\d{4})-(?\\d+)") do print(to.json(g)) do print(to.json(regex.find("Tel. 961 123 4567 y 55 9876 5432", "\\d{2,3} \\d{3,4} \\d{4}"))) do print(to.json(regex.split("uno, dos;tres", "[,;] ?")) + " " + regex.escape("1+1=2?")) do print(text.unaccent("Pérez Muñoz") + " | " + text.slug("Lista de Precios 2026: Ñandú & Más")) do print(text.truncate("Descripción demasiado larga para la etiqueta", 20)) do print(str(text.is_email("ventas@ejemplo.com")) + " " + str(text.is_email("ventas@"))) do print(str(num.round(2.675, 2)) + " " + str(num.round(-2.5, 0)) + " round() del motor: " + str(round(2.5, 0))) new a { @"class": "nombre" @"value": "Juan \"El Güero\" " } do print("") do print(html.encode("Ventas & más") + " | " + html.decode("Niño & niña")) x = regex.match("abc", "(") exception { do print(last_error()) } } ``` Salida: ``` RFC válido: 1 27/10/2026 primera: F-153 {"0":"F-2026-0153","serie":"F","anio":"2026","num":"0153"} ["961 123 4567","55 9876 5432"] ["uno","dos","tres"] 1\+1=2\? Perez Munoz | lista-de-precios-2026-nandu-mas Descripción demasia… 1 0 2.68 -3 round() del motor: 2 <b>Ventas & más</b> | Niño & niña {1} Error en 'regex.match. (regex.match: patrón inválido (Invalid pattern '(' at offset 1. Not enough )'s.)Exception has been thrown by the target of an invocation.) [text.dkl][Ln= 26] ``` ## Errores | Mensaje | Causa | |---|---| | `regex.match: patrón inválido (…)` | Patrón mal escrito (también en las demás `regex.*`) | | `num.round: los decimales deben estar entre 0 y 28` | `decimales` fuera de rango | | `html.attrs: se esperaba un registro` | El argumento no es registro | ## Advertencias - **Escape siempre lo que viene del usuario** antes de ponerlo en una página (`html.encode`) o en un atributo (`html.attrs`). Así evita que inyecten scripts. - `text.slug` puede dar el mismo resultado para títulos distintos. Si lo usa como nombre de archivo o URL, verifique que no exista y agregue un número si hace falta.