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. Al-
     legro 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 Uni-
     code 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.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 configura-
     tion file specifying the language mapping (keyboard variable in system sec-
     tion 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+15.1.quarterly>

home | help