PC Extra Super CD 1998 January/PCPLUS131.iso/DJGPP/V2/DJLSR201.ZIP/src/libc/pc_hw/kb/kbhit.txh

Text File | 1995-07-10 | 775 b | 33 lines

@node kbhit, bios
@subheading Syntax

@example
#include <pc.h>

int kbhit(void);
@end example

@subheading Description

If the user has hit a key, this function will detect it.  This function
is very fast when there is no key waiting, so it may be used inside
loops as needed.

If you test shift/alt/ctrl status with bios calls (e.g., using
@code{bioskey (2)} or @code{bioskey (0x12)}) then you should also use
bios calls for testing for keys.  This can be done with by
@code{bioskey (1)} or @code{bioskey (0x11)}.  Failing to do so can
cause trouble in multitasking environments like DESQview/X.

@subheading Return Value

Nonzero if a key has been hit, else zero.

@subheading Example

@example
while (!kbhit())
  do_stuff();
@end example