|
ANSI Common Lisp 21 Streams 21.2 Dictionary of Streams
21.2.35 clear-input |
Function |
- Syntax:
-
clear-input
&optional input-stream
nil
- Arguments and Values:
-
input-stream - an input stream designator.
The default is standard input.
- Description:
-
Clears any available input from input-stream.
If clear-input does not make sense for input-stream,
then clear-input does nothing.
- Examples:
-
;; The exact I/O behavior of this example might vary from implementation
;; to implementation depending on the kind of interactive buffering that
;; occurs. (The call to SLEEP here is intended to help even out the
;; differences in implementations which do not do line-at-a-time buffering.)
(defun read-sleepily (&optional (clear-p nil) (zzz 0))
(list (progn (print '>) (read))
;; Note that input typed within the first ZZZ seconds
;; will be discarded.
(progn (print '>)
(if zzz (sleep zzz))
(print '>>)
(if clear-p (clear-input))
(read))))
(read-sleepily)
> 10
>
>> 20
(10 20)
(read-sleepily t)
> 10
>
>> 20
(10 20)
(read-sleepily t 10)
> 10
> 20 ; Some implementations won't echo typeahead here.
>> 30
(10 30)
- Side Effects:
-
The input-stream is modified.
- Affected By:
-
*standard-input*
- Exceptional Situations:
-
Should signal an error of type type-error if input-stream is not a stream designator.
- See Also:
-
clear-output
- Allegro CL Implementation Details:
-
None.
|