1
0
mirror of https://github.com/SquidDev-CC/CC-Tweaked synced 2024-12-26 10:00:36 +00:00
CC-Tweaked/doc/events/char.md
Jonathan Coates 52b78f92cd
Use standard Markdown link syntax for references
References are now written using normal links: You now use [`print`] or
[print a string][`print`]) instead of @{print} or @{print|print a
string}.
2023-08-24 11:23:33 +01:00

869 B

module: [kind=event] char see: key To listen to any key press.

The [char] event is fired when a character is typed on the keyboard.

The [char] event is different to a key press. Sometimes multiple key presses may result in one character being typed (for instance, on some European keyboards). Similarly, some keys (e.g. Ctrl) do not have any corresponding character. The [key] should be used if you want to listen to key presses themselves.

Return values

  1. [string]: The event name.
  2. [string]: The string representing the character that was pressed.

Example

Prints each character the user presses:

while true do
    local event, character = os.pullEvent("char")
    print(character .. " was pressed.")
end