--- name: "aa_getkey" section: "3" platform: "linux" package: "aalib" version: "1.4rc5-19" release: "Arch Linux 2026-11-01" platforms: ["linux"] url: "https://new.carta.tech/aa_getkey" --- # aa\_getkey(3) return next keypress event from queue. ## NAME aa\_getkey - return next keypress event from queue. ## SYNOPSIS **#include \** **int aa\_getkey**\ **(**\ \ **aa\_context \*c,**\ \ **int wait**\ **);** ## PARAMETERS - **aa\_context \*c** Specifies the AA-lib context to operate on. - **int wait** 1 if you wish to wait for the even when queue is empty. ## DESCRIPTION Return next keypress event from queue. ## RETURNS Next keypress event from queue (values lower than 256 are used to report ascii values of pressed keys and higher values are used to represent some special keys like arrows) See the AA-lib texinfo documentation for more details. ## SEE ALSO [save\_d(3)](/save_d/3.md), [mem\_d(3)](/mem_d/3.md), [aa\_help(3)](/aa_help/3.md), [aa\_formats(3)](/aa_formats/3.md), [aa\_fonts(3)](/aa_fonts/3.md), [aa\_dithernames(3)](/aa_dithernames/3.md), [aa\_drivers(3)](/aa_drivers/3.md), [aa\_kbddrivers(3)](/aa_kbddrivers/3.md), [aa\_mousedrivers(3)](/aa_mousedrivers/3.md), [aa\_kbdrecommended(3)](/aa_kbdrecommended/3.md), [aa\_mouserecommended(3)](/aa_mouserecommended/3.md), [aa\_displayrecommended(3)](/aa_displayrecommended/3.md), [aa\_defparams(3)](/aa_defparams/3.md), [aa\_defrenderparams(3)](/aa_defrenderparams/3.md), [aa\_scrwidth(3)](/aa_scrwidth/3.md), [aa\_scrheight(3)](/aa_scrheight/3.md), [aa\_mmwidth(3)](/aa_mmwidth/3.md), [aa\_mmheight(3)](/aa_mmheight/3.md), [aa\_imgwidth(3)](/aa_imgwidth/3.md), [aa\_imgheight(3)](/aa_imgheight/3.md), [aa\_image(3)](/aa_image/3.md), [aa\_text(3)](/aa_text/3.md), [aa\_attrs(3)](/aa_attrs/3.md), [aa\_currentfont(3)](/aa_currentfont/3.md), [aa\_autoinit(3)](/aa_autoinit/3.md), [aa\_autoinitkbd(3)](/aa_autoinitkbd/3.md), [aa\_autoinitmouse(3)](/aa_autoinitmouse/3.md), [aa\_recommendhi(3)](/aa_recommendhi/3.md), [aa\_recommendlow(3)](/aa_recommendlow/3.md), [aa\_init(3)](/aa_init/3.md), [aa\_initkbd(3)](/aa_initkbd/3.md), [aa\_initmouse(3)](/aa_initmouse/3.md), [aa\_close(3)](/aa_close/3.md), [aa\_uninitkbd(3)](/aa_uninitkbd/3.md), [aa\_uninitmouse(3)](/aa_uninitmouse/3.md), [aa\_fastrender(3)](/aa_fastrender/3.md), [aa\_render(3)](/aa_render/3.md), [aa\_puts(3)](/aa_puts/3.md), [aa\_printf(3)](/aa_printf/3.md), [aa\_gotoxy(3)](/aa_gotoxy/3.md), [aa\_hidecursor(3)](/aa_hidecursor/3.md), [aa\_showcursor(3)](/aa_showcursor/3.md), [aa\_getmouse(3)](/aa_getmouse/3.md), [aa\_hidemouse(3)](/aa_hidemouse/3.md), [aa\_showmouse(3)](/aa_showmouse/3.md), [aa\_registerfont(3)](/aa_registerfont/3.md), [aa\_setsupported(3)](/aa_setsupported/3.md), [aa\_setfont(3)](/aa_setfont/3.md), [aa\_getevent(3)](/aa_getevent/3.md), [aa\_resize(3)](/aa_resize/3.md), [aa\_resizehandler(3)](/aa_resizehandler/3.md), [aa\_parseoptions(3)](/aa_parseoptions/3.md), [aa\_edit(3)](/aa_edit/3.md), [aa\_createedit(3)](/aa_createedit/3.md), [aa\_editkey(3)](/aa_editkey/3.md), [aa\_putpixel(3)](/aa_putpixel/3.md), [aa\_recommendhikbd(3)](/aa_recommendhikbd/3.md), [aa\_recommendlowkbd(3)](/aa_recommendlowkbd/3.md), [aa\_recommendhimouse(3)](/aa_recommendhimouse/3.md), [aa\_recommendlowmouse(3)](/aa_recommendlowmouse/3.md), [aa\_recommendhidisplay(3)](/aa_recommendhidisplay/3.md), [aa\_recommendlowdisplay(3)](/aa_recommendlowdisplay/3.md)