Function            inkeyc - get a key, any alphabetics capitalized

  Syntax              int inkeyc(boolean wait);

  Prototype in        keyboard.h

  Remarks             inkeyc returns the key code of the key pressed. If
                      no key was pressed (WAIT = FALSE) 0 is returned.
                      Any letters detected are capitalized before being
                      returned. This function is similar to getchar()
                      except input is not echoed to the screen and inkeyc
                      will detect any key press (any standard keypress.
                      It cannot distinguish between the grey '+' key and
                      the white '+'. This function is interrupt driven.
                      It will detect ALT combinations, Del, PgUp,
                      function keys, etc., any keyboard INTerrupt
                      accepted keys.)

  Return value        returns the key code of the key pressed, from 1 to
                      511, all letters are capitalized. If WAIT = FALSE,
                      and no key is pressed, zero is returned.

  See also            keycode.h
                      getc_match(), getk(), getc_match(), getlogical(),
                      getyn(), inkey(), inkeycdv(), inkeydv(), tocapkey()

  Example             #include <keyboard.h>
                      #include <stdio.h>

                      main()
                      {
                           int c;

                           c = inkeyc(WAIT);
                           printf("Key code # in keycode.h: %d\n", c);
                      }