Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
ureadkey(3)			Allegro	manual			   ureadkey(3)

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 con-
       tains the Unicode value of the key, and if not NULL, the	pointer	 argu-
       ment  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.uni-
       code.org/.  Remember that on DOS	you must specify a custom keyboard map
       (like those found in `keyboard.dat') usually with the help of a config-
       uration file specifying the language mapping (keyboard variable in sys-
       tem 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), simu-
       late_ukeypress(3), exkeys(3)

Allegro				 version 4.4.3			   ureadkey(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=ureadkey&sektion=3&manpath=FreeBSD+Ports+14.3.quarterly>

home | help