ureadkey

Section: Allegro manual (3)
Updated: version 4.2.2
Index Return to Main Contents
 

NAME

ureadkey - Returns the next unicode character from the keyboard buffer. Allegro game programming library.  

SYNOPSIS

#include <allegro.h>

int ureadkey(int *scancode);  

DESCRIPTION

Returns the next character from the keyboard buffer, in Unicode format. If the buffer is empty, it waits until a key is pressed. You can see if there are queued keypresses with keypressed(). The return value contains the Unicode value of the key, and if not NULL, the pointer argument will be set to the scancode. Unlike readkey(), this function is able to return character values greater than 255. Example:

   int val, scancode;
   ...
   val = ureadkey(&scancode);
   if (val == 0x00F1)
      allegro_message("You pressed n with tilde\n");
   
   if (val == 0x00DF)
      allegro_message("You pressed sharp s\n");
   
You should be able to find Unicode character maps at http://www.unicode.org/. Remember that on DOS you must specify a custom keyboard map (like those found in `keyboard.dat') usually with the help of a configuration file specifying the language mapping (keyboard variable in system section of `allegro.cfg'), or you will get the default US keyboard mapping.

 

SEE ALSO

install_keyboard(3), readkey(3), keypressed(3), clear_keybuf(3), simulate_ukeypress(3), exkeys(3)