ToC DocOverview CGDoc RelNotes Index PermutedIndex
Allegro CL
Home Previous Up Next Table of Contents Index
  ANSI Common Lisp   21 Streams   21.2 Dictionary of Streams

21.2.18 read-char-no-hang Function

Syntax:
read-char-no-hang &optional input-stream eof-error-p eof-value recursive-p    char

Arguments and Values:
input-stream -- an input stream designator. The default is standard input.

eof-error-p - a generalized boolean. The default is true.

eof-value - an object. The default is nil.

recursive-p - a generalized boolean. The default is false.

char - a character or nil or the eof-value.

Description:
read-char-no-hang returns a character from input-stream if such a character is available. If no character is available, read-char-no-hang returns nil.

If recursive-p is true, this call is expected to be embedded in a higher-level call to read or a similar function used by the Lisp reader.

If an end of file2 occurs and eof-error-p is false, eof-value is returned.

Examples:
;; This code assumes an implementation in which a newline is not
;; required to terminate input from the console.
 (defun test-it ()
   (unread-char (read-char))
   (list (read-char-no-hang) 
         (read-char-no-hang) 
         (read-char-no-hang)))
  TEST-IT
;; Implementation A, where a Newline is not required to terminate
;; interactive input on the console.
 (test-it)
a
 (#\a NIL NIL)
;; Implementation B, where a Newline is required to terminate
;; interactive input on the console, and where that Newline remains
;; on the input stream.
 (test-it)
a[Return]
 (#\a #\Newline NIL)

Affected By:
*standard-input*, *terminal-io*.

Exceptional Situations:
If an end of file2 occurs when eof-error-p is true, an error of type end-of-file is signaled .

See Also:
listen

Notes:
read-char-no-hang is exactly like read-char, except that if it would be necessary to wait in order to get a character (as from a keyboard), nil is immediately returned without waiting.

Allegro CL Implementation Details:
None.

Home Previous Up Next Table of Contents Index
© Franz Inc. All Rights Reserved - File last updated 2022-07-25