User Tools


Differences

This shows you the differences between two versions of the page.

Link to this comparison view

cl:variables:star-terminal-io-star [2017/05/01 21:00] (current)
Line 1: Line 1:
 +====== Variable *TERMINAL-IO* ======
 +
 +====Value Type====
 +a //​[[CL:​Glossary:​bidirectional]]//​ //​[[CL:​Glossary:​stream]]//​.
 +
 +====Initial Value====
 +//​[[CL:​Glossary:​implementation-dependent]]//,​ but it must be an //​[[CL:​Glossary:​open]]//​ //​[[CL:​Glossary:​stream]]//​ that is not a //​[[CL:​Glossary:​generalized synonym stream]]// to an //​[[CL:​Glossary:​I/​O customization variables]]//​ but that might be a //​[[CL:​Glossary:​generalized synonym stream]]// to the //​[[CL:​Glossary:​value]]//​ of some //​[[CL:​Glossary:​I/​O customization variable]]//​.
 +
 +====Description====
 +The //​[[CL:​Glossary:​value]]//​ of **<​nowiki>​*terminal-io*</​nowiki>​**,​ called //​[[CL:​Glossary:​terminal I/O]]//, is ordinarily a //​[[CL:​Glossary:​bidirectional]]//​ //​[[CL:​Glossary:​stream]]//​ that connects to the user's console. Typically, writing to this //​[[CL:​Glossary:​stream]]//​ would cause the output to appear on a display screen, for example, and reading from the //​[[CL:​Glossary:​stream]]//​ would accept input from a keyboard. It is intended that standard input functions such as **[[CL:​Functions:​read]]** and **[[CL:​Functions:​read-char]]**,​ when used with this //​[[CL:​Glossary:​stream]]//,​ cause echoing of the input into the output side of the //​[[CL:​Glossary:​stream]]//​. The means by which this is accomplished are //​[[CL:​Glossary:​implementation-dependent]]//​.
 +
 +The effect of changing the //​[[CL:​Glossary:​value]]//​ of **<​nowiki>​*terminal-io*</​nowiki>​**,​ either by //​[[CL:​Glossary:​binding]]//​ or //​[[CL:​Glossary:​assignment]]//,​ is //​[[CL:​Glossary:​implementation-defined]]//​.
 +
 +====Examples====
 +<​blockquote> ​
 +([[CL:​Special Operators:​progn]] ​
 +  ([[CL:​Functions:​prin1]] '​foo) ​
 +  ([[CL:​Functions:​prin1]] 'bar *terminal-io*))
 +<​o>​FOOBAR</​o> ​
 +<​r>​BAR </r>
 +([[CL:​Macros:​with-output-to-string]] ([[CL:​Variables:​star-standard-output-star|*standard-output*]]) ​
 +  ([[CL:​Functions:​prin1]] '​foo) ​
 +  ([[CL:​Functions:​prin1]] 'bar *terminal-io*))
 +<​o>​BAR </o>
 +<​r>"​FOO"​ </r>
 +</​blockquote>​
 +
 +====Affected By====
 +None.
 +
 +====See Also====
 +  * **[[CL:​Variables:​star-debug-io-star|Variable *DEBUG-IO*]]**
 +  * **[[CL:​Variables:​star-error-output-star|Variable *ERROR-OUTPUT*]]**
 +  * **[[CL:​Variables:​star-query-io-star|Variable *QUERY-IO*]]**
 +  * **[[CL:​Variables:​star-standard-input-star|Variable *STANDARD-INPUT*]]**
 +  * **[[CL:​Variables:​star-standard-output-star|Variable *STANDARD-OUTPUT*]]**
 +  * **[[CL:​Variables:​star-trace-output-star|Variable *TRACE-OUTPUT*]]**
 +
 +====Notes====
 +None.
 +