lovr.textinput

This callback is called when text has been entered.

For example, when shift + 1 is pressed on an American keyboard, lovr.textinput will be called with !.

function lovr.textinput(text, code)
  -- your code here
end

Arguments

NameTypeDescription
textstringThe UTF-8 encoded character.
codenumberThe integer codepoint of the character.

Returns

Nothing

Notes

Some characters in UTF-8 unicode take multiple bytes to encode. Due to the way Lua works, the length of these strings will be bigger than 1 even though they are just a single character. lovr.graphics.print is compatible with UTF-8 but doing other string processing on these strings may require a library. Lua 5.3+ has support for working with UTF-8 strings.

See also