# Funciones de consola | Función | Descripción | |---|---| | `print(texto)` | Escribe el texto y un fin de línea. | | `write(texto)` | Escribe el texto sin fin de línea. | | `write_utf8(texto)` | Escribe el texto en UTF-8, sin importar la codificación de la consola. | | `write_bytes(bytes)` | Escribe un arreglo de bytes de .NET tal cual. | | `input([mensaje])` | Lee una línea (hasta Enter) y la devuelve. | | `stdin([milisegundos])` | Lee toda la entrada estándar hasta el final y la devuelve. | Todas devuelven 0 salvo `input` y `stdin`, que devuelven la cadena leída. En un servidor web la consola es la bitácora del servidor, no el navegador. ## print `print(texto)` escribe el texto en la salida estándar seguido de un fin de línea. Un número se escribe con punto decimal. ## write `write(texto)` escribe el texto sin agregar fin de línea. ```dkl do write("Procesando") do write("...") do print(" listo") do write("con salto\n") do print(1234.5) ``` ```text Procesando... listo con salto 1234.5 ``` ## write_utf8 `write_utf8(texto)` escribe el texto codificado en UTF-8 directamente en la salida estándar, aunque la consola esté configurada con otra codificación (útil en Windows al generar archivos por redirección). No agrega fin de línea. ```dkl do write_utf8("Año: 2026, señal ñ\n") ``` ```text Año: 2026, señal ñ ``` ## write_bytes `write_bytes(bytes)` escribe los bytes de un arreglo `byte[]` de .NET, sin conversión. Sirve para emitir contenido binario (una imagen, un PDF) por la salida estándar. ```dkl ref cod = _new("System.Text.UTF8Encoding") do _map_function(-1, "System.Text.UTF8Encoding", "GetBytes", "utf8.bytes", "System.String", "*") ref by = _invoke(cod, "utf8.bytes", "bytes directos\n") do write_bytes(by) ``` ```text bytes directos ``` Si recibe algo que no es `byte[]`, en 2.0 el error dice el tipo real: `Se esperaba un arreglo de Bytes, sin embargo se recibió un tipo 'System.Text.StringBuilder'`. Con una referencia nula: `El arreglo de Bytes no puede ser Null`. ## input `input([mensaje])` escribe el mensaje (si lo hay), espera a que el usuario escriba una línea y presione Enter, y la devuelve sin el fin de línea. Sin entrada disponible devuelve `""`. ```dkl nombre = input("Su nombre: ") do print("Hola, " + nombre) ``` Ejecutado con `echo Ana | dkl ejemplo.dkl -hide-log`: ```text Su nombre: Hola, Ana ``` (El mensaje y el saludo salen en la misma línea porque el Enter lo escribió el usuario, no el programa.) ## stdin `stdin()` lee **toda** la entrada estándar hasta el final y la devuelve como una cadena. Con un argumento numérico fija un tiempo máximo de lectura en milisegundos. Es la forma de escribir filtros que reciben datos por tubería. ```dkl texto = stdin() ref lineas = split(trim(texto), "\n") do print("Líneas recibidas: " + str(list.count(lineas))) do print("Última: " + list.atstr(lineas, -1)) ``` Ejecutado con `printf 'uno\ndos\ntres\n' | dkl ejemplo.dkl -hide-log`: ```text Líneas recibidas: 3 Última: tres ``` Después de `stdin()`, un `input()` ya no tiene nada que leer.