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.2			   ureadkey(3)

NAME | SYNOPSIS | DESCRIPTION | SEE ALSO

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

home | help