From cba372066aa94f14dc7b078fe625606ffaa32904 Mon Sep 17 00:00:00 2001
From: JailDoctor <jaildoctor@gmail.com>
Date: Tue, 17 Mar 2026 13:41:18 +0100
Subject: [PATCH] Add key.utf8char

---
 key.utf8char.md | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)
 create mode 100644 key.utf8char.md

diff --git a/key.utf8char.md b/key.utf8char.md
new file mode 100644
index 0000000..ed9757e
--- /dev/null
+++ b/key.utf8char.md
@@ -0,0 +1,20 @@
+# key.utf8char()
+Retorna una cadena amb el caracter utf-8 que s'ha polsat, o nil si no s'ha polsat res. Alguns caracters utf-8 ocupen mes de un char, per aixó torne una cadena.
+Nomes funciona si abans s'ha activat l'entrada de text amb [key.text](key.text).
+Si no fa falta, mantindre desactivat i nomes activar en els moment necesaris, ja que pot interferir en la detecció normal de tecles.
+
+### Torna
+Una cadena amb el caracter utf-8 generat amb el teclat o nil.
+
+### Exemple
+```
+key.text(true)
+local nom = ""
+local c = key.utf8char()
+if c then
+    nom = nom .. c
+end
+```
+
+### Vore també
+* [key.text](key.text)