~ubuntu-branches/debian/lenny/ucblogo/lenny

« back to all changes in this revision

Viewing changes to emacs/docs/usermanual_3.html

  • Committer: Bazaar Package Importer
  • Author(s): Hamish Moffatt
  • Date: 2001-09-02 15:15:21 UTC
  • Revision ID: james.westby@ubuntu.com-20010902151521-doo25fmfq7v3pxkg
Tags: upstream-5.1
ImportĀ upstreamĀ versionĀ 5.1

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
<HTML>
 
2
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
 
3
<!-- Created on July, 24  2001 by texi2html 1.64 -->
 
4
<!-- 
 
5
Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
 
6
            Karl Berry  <karl@freefriends.org>
 
7
            Olaf Bachmann <obachman@mathematik.uni-kl.de>
 
8
            and many others.
 
9
Maintained by: Olaf Bachmann <obachman@mathematik.uni-kl.de>
 
10
Send bugs and suggestions to <texi2html@mathematik.uni-kl.de>
 
11
 
 
12
-->
 
13
<HEAD>
 
14
<TITLE>BERKELEY LOGO: COMMUNICATION</TITLE>
 
15
 
 
16
<META NAME="description" CONTENT="BERKELEY LOGO: COMMUNICATION">
 
17
<META NAME="keywords" CONTENT="BERKELEY LOGO: COMMUNICATION">
 
18
<META NAME="resource-type" CONTENT="document">
 
19
<META NAME="distribution" CONTENT="global">
 
20
<META NAME="Generator" CONTENT="texi2html 1.64">
 
21
 
 
22
</HEAD>
 
23
 
 
24
<BODY LANG="" BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#800080" ALINK="#FF0000">
 
25
 
 
26
<A NAME="SEC66"></A>
 
27
<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
 
28
<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_2.html#SEC65"> &lt; </A>]</TD>
 
29
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC67"> &gt; </A>]</TD>
 
30
<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_2.html#SEC6"> &lt;&lt; </A>]</TD>
 
31
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual.html#SEC_Top"> Up </A>]</TD>
 
32
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_4.html#SEC108"> &gt;&gt; </A>]</TD>
 
33
<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual.html#SEC_Top">Top</A>]</TD>
 
34
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_toc.html#SEC_Contents">Contents</A>]</TD>
 
35
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_12.html#SEC354">Index</A>]</TD>
 
36
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_abt.html#SEC_About"> ? </A>]</TD>
 
37
</TR></TABLE>
 
38
<H1> 3. Communication </H1>
 
39
<!--docid::SEC66::-->
 
40
<P>
 
41
 
 
42
<BLOCKQUOTE><TABLE BORDER=0 CELLSPACING=0> 
 
43
<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="usermanual_3.html#SEC67">3.1 Transmitters</A></TD><TD>&nbsp;&nbsp;</TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
 
44
<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="usermanual_3.html#SEC71">3.2 Receivers</A></TD><TD>&nbsp;&nbsp;</TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
 
45
<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="usermanual_3.html#SEC78">3.3 File Access</A></TD><TD>&nbsp;&nbsp;</TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
 
46
<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="usermanual_3.html#SEC101">3.4 Terminal Access</A></TD><TD>&nbsp;&nbsp;</TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
 
47
</TABLE></BLOCKQUOTE>
 
48
<P>
 
49
 
 
50
<A NAME="TRANSMITTERS"></A>
 
51
<HR SIZE="6">
 
52
<A NAME="SEC67"></A>
 
53
<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
 
54
<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC66"> &lt; </A>]</TD>
 
55
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC68"> &gt; </A>]</TD>
 
56
<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC66"> &lt;&lt; </A>]</TD>
 
57
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC66"> Up </A>]</TD>
 
58
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC71"> &gt;&gt; </A>]</TD>
 
59
<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual.html#SEC_Top">Top</A>]</TD>
 
60
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_toc.html#SEC_Contents">Contents</A>]</TD>
 
61
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_12.html#SEC354">Index</A>]</TD>
 
62
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_abt.html#SEC_About"> ? </A>]</TD>
 
63
</TR></TABLE>
 
64
<H2> 3.1 Transmitters </H2>
 
65
<!--docid::SEC67::-->
 
66
<P>
 
67
 
 
68
<BLOCKQUOTE><TABLE BORDER=0 CELLSPACING=0> 
 
69
<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="usermanual_3.html#SEC68">print</A></TD><TD>&nbsp;&nbsp;</TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
 
70
<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="usermanual_3.html#SEC69">type</A></TD><TD>&nbsp;&nbsp;</TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
 
71
<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="usermanual_3.html#SEC70">show</A></TD><TD>&nbsp;&nbsp;</TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
 
72
</TABLE></BLOCKQUOTE>
 
73
<P>
 
74
 
 
75
Note:  If there is a variable named <VAR>PRINTDEPTHLIMIT</VAR> with a nonnegative
 
76
integer value, then complex list and array structures will be printed
 
77
only to the allowed depth.  That is, members of members of... of members
 
78
will be allowed only so far.  The members omitted because
 
79
they are just past the depth limit are indicated by an ellipsis for each
 
80
one, so a too-deep list of two members will print as [<small>...</small> <small>...</small>].
 
81
</P><P>
 
82
 
 
83
If there is a variable named <VAR>PRINTWIDTHLIMIT</VAR> with a nonnegative integer
 
84
value, then only the first so many members of any array or
 
85
list will be printed.  A single ellipsis replaces all missing data
 
86
within the structure.  The width limit also applies to the number of
 
87
characters printed in a word, except that a <VAR>PRINTWIDTHLIMIT</VAR> between 0 and 9
 
88
will be treated as if it were 10 when applied to words.  This limit
 
89
applies not only to the top-level printed datum but to any substructures
 
90
within it.
 
91
</P><P>
 
92
 
 
93
See section <A HREF="usermanual_11.html#SEC349">printdepthlimit</A> ,
 
94
<A HREF="usermanual_11.html#SEC350">printwidthlimit</A>
 
95
</P><P>
 
96
 
 
97
If there is a variable named <VAR>FULLPRINTP</VAR> whose value is TRUE, then
 
98
words that were created using backslash or vertical bar (to include
 
99
characters that would otherwise not be treated as part of a word) are
 
100
printed with the backslashes or vertical bars shown, so that the printed
 
101
result could be re-read by Logo to produce the same value.  If
 
102
FULLPRINTP is TRUE then the empty word (however it was created) prints
 
103
as ||.  (Otherwise it prints as nothing at all.)
 
104
</P><P>
 
105
 
 
106
See section <A HREF="usermanual_11.html#SEC347">fullprintp</A> .
 
107
</P><P>
 
108
 
 
109
<A NAME="PRINT"></A>
 
110
<HR SIZE="6">
 
111
<A NAME="SEC68"></A>
 
112
<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
 
113
<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC67"> &lt; </A>]</TD>
 
114
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC69"> &gt; </A>]</TD>
 
115
<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC66"> &lt;&lt; </A>]</TD>
 
116
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC67"> Up </A>]</TD>
 
117
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC71"> &gt;&gt; </A>]</TD>
 
118
<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual.html#SEC_Top">Top</A>]</TD>
 
119
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_toc.html#SEC_Contents">Contents</A>]</TD>
 
120
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_12.html#SEC354">Index</A>]</TD>
 
121
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_abt.html#SEC_About"> ? </A>]</TD>
 
122
</TR></TABLE>
 
123
<H3> print </H3>
 
124
<!--docid::SEC68::-->
 
125
<P>
 
126
 
 
127
<TABLE><tr><td>&nbsp;</td><td class=example><pre>PRINT thing
 
128
PR thing
 
129
(PRINT thing1 thing2 ...)
 
130
(PR thing1 thing2 ...)
 
131
</pre></td></tr></table></P><P>
 
132
 
 
133
command.  Prints the input or inputs to the current write stream
 
134
(initially the terminal).  All the inputs are printed on a single line,
 
135
separated by spaces, ending with a newline.  If an input is a list,
 
136
square brackets are not printed around it, but brackets are printed
 
137
around sublists.  Braces are always printed around arrays.
 
138
</P><P>
 
139
 
 
140
<A NAME="TYPE"></A>
 
141
<HR SIZE="6">
 
142
<A NAME="SEC69"></A>
 
143
<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
 
144
<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC68"> &lt; </A>]</TD>
 
145
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC70"> &gt; </A>]</TD>
 
146
<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC66"> &lt;&lt; </A>]</TD>
 
147
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC67"> Up </A>]</TD>
 
148
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC71"> &gt;&gt; </A>]</TD>
 
149
<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual.html#SEC_Top">Top</A>]</TD>
 
150
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_toc.html#SEC_Contents">Contents</A>]</TD>
 
151
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_12.html#SEC354">Index</A>]</TD>
 
152
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_abt.html#SEC_About"> ? </A>]</TD>
 
153
</TR></TABLE>
 
154
<H3> type </H3>
 
155
<!--docid::SEC69::-->
 
156
<P>
 
157
 
 
158
<TABLE><tr><td>&nbsp;</td><td class=example><pre>TYPE thing
 
159
(TYPE thing1 thing2 ...)
 
160
</pre></td></tr></table></P><P>
 
161
 
 
162
command.  Prints the input or inputs like PRINT, except that no newline
 
163
character is printed at the end and multiple inputs are not separated by
 
164
spaces.  Note: printing to the terminal is ordinarily "line buffered";
 
165
that is, the characters you print using TYPE will not actually appear on
 
166
the screen until either a newline character is printed (for example, by
 
167
PRINT or SHOW) or Logo tries to read from the keyboard (either at the
 
168
request of your program or after an instruction prompt).  This buffering
 
169
makes the program much faster than it would be if each character
 
170
appeared immediately, and in most cases the effect is not disconcerting.
 
171
To accommodate programs that do a lot of positioned text display using
 
172
TYPE, Logo will force printing whenever SETCURSOR is invoked.  This
 
173
solves most buffering problems.  Still, on occasion you may find it
 
174
necessary to force the buffered characters to be printed explicitly;
 
175
this can be done using the WAIT command.  <TT>WAIT 0</TT> will force printing
 
176
without actually waiting.
 
177
</P><P>
 
178
 
 
179
See section <A HREF="usermanual_3.html#SEC104">setcursor</A> ,
 
180
<A HREF="usermanual_8.html#SEC311">wait</A>
 
181
</P><P>
 
182
 
 
183
<A NAME="SHOW"></A>
 
184
<HR SIZE="6">
 
185
<A NAME="SEC70"></A>
 
186
<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
 
187
<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC69"> &lt; </A>]</TD>
 
188
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC71"> &gt; </A>]</TD>
 
189
<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC66"> &lt;&lt; </A>]</TD>
 
190
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC67"> Up </A>]</TD>
 
191
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC71"> &gt;&gt; </A>]</TD>
 
192
<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual.html#SEC_Top">Top</A>]</TD>
 
193
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_toc.html#SEC_Contents">Contents</A>]</TD>
 
194
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_12.html#SEC354">Index</A>]</TD>
 
195
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_abt.html#SEC_About"> ? </A>]</TD>
 
196
</TR></TABLE>
 
197
<H3> show </H3>
 
198
<!--docid::SEC70::-->
 
199
<P>
 
200
 
 
201
<TABLE><tr><td>&nbsp;</td><td class=example><pre>SHOW thing
 
202
(SHOW thing1 thing2 ...)
 
203
</pre></td></tr></table></P><P>
 
204
 
 
205
command.  Prints the input or inputs like PRINT, except that if an input
 
206
is a list it is printed inside square brackets.
 
207
</P><P>
 
208
 
 
209
See section <A HREF="usermanual_3.html#SEC68">print</A> .
 
210
</P><P>
 
211
 
 
212
<A NAME="RECEIVERS"></A>
 
213
<HR SIZE="6">
 
214
<A NAME="SEC71"></A>
 
215
<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
 
216
<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC70"> &lt; </A>]</TD>
 
217
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC72"> &gt; </A>]</TD>
 
218
<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC67"> &lt;&lt; </A>]</TD>
 
219
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC66"> Up </A>]</TD>
 
220
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC78"> &gt;&gt; </A>]</TD>
 
221
<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual.html#SEC_Top">Top</A>]</TD>
 
222
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_toc.html#SEC_Contents">Contents</A>]</TD>
 
223
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_12.html#SEC354">Index</A>]</TD>
 
224
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_abt.html#SEC_About"> ? </A>]</TD>
 
225
</TR></TABLE>
 
226
<H2> 3.2 Receivers </H2>
 
227
<!--docid::SEC71::-->
 
228
<P>
 
229
 
 
230
<BLOCKQUOTE><TABLE BORDER=0 CELLSPACING=0> 
 
231
<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="usermanual_3.html#SEC72">readlist</A></TD><TD>&nbsp;&nbsp;</TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
 
232
<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="usermanual_3.html#SEC73">readword</A></TD><TD>&nbsp;&nbsp;</TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
 
233
<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="usermanual_3.html#SEC74">readrawline</A></TD><TD>&nbsp;&nbsp;</TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
 
234
<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="usermanual_3.html#SEC75">readchar</A></TD><TD>&nbsp;&nbsp;</TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
 
235
<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="usermanual_3.html#SEC76">readchars</A></TD><TD>&nbsp;&nbsp;</TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
 
236
<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="usermanual_3.html#SEC77">shell</A></TD><TD>&nbsp;&nbsp;</TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
 
237
</TABLE></BLOCKQUOTE>
 
238
<P>
 
239
 
 
240
<A NAME="READLIST"></A>
 
241
<HR SIZE="6">
 
242
<A NAME="SEC72"></A>
 
243
<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
 
244
<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC71"> &lt; </A>]</TD>
 
245
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC73"> &gt; </A>]</TD>
 
246
<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC67"> &lt;&lt; </A>]</TD>
 
247
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC71"> Up </A>]</TD>
 
248
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC78"> &gt;&gt; </A>]</TD>
 
249
<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual.html#SEC_Top">Top</A>]</TD>
 
250
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_toc.html#SEC_Contents">Contents</A>]</TD>
 
251
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_12.html#SEC354">Index</A>]</TD>
 
252
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_abt.html#SEC_About"> ? </A>]</TD>
 
253
</TR></TABLE>
 
254
<H3> readlist </H3>
 
255
<!--docid::SEC72::-->
 
256
<P>
 
257
 
 
258
<TABLE><tr><td>&nbsp;</td><td class=example><pre>READLIST
 
259
RL
 
260
</pre></td></tr></table></P><P>
 
261
 
 
262
reads a line from the read stream (initially the terminal) and outputs
 
263
that line as a list.  The line is separated into members as though it
 
264
were typed in square brackets in an instruction.  If the read stream is
 
265
a file, and the end of file is reached, READLIST outputs the empty word
 
266
(not the empty list).  READLIST processes backslash, vertical bar, and
 
267
tilde characters in the read stream; the output list will not contain
 
268
these characters but they will have had their usual effect.  READLIST
 
269
does not, however, treat semicolon as a comment character.
 
270
</P><P>
 
271
 
 
272
<A NAME="READWORD"></A>
 
273
<HR SIZE="6">
 
274
<A NAME="SEC73"></A>
 
275
<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
 
276
<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC72"> &lt; </A>]</TD>
 
277
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC74"> &gt; </A>]</TD>
 
278
<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC67"> &lt;&lt; </A>]</TD>
 
279
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC71"> Up </A>]</TD>
 
280
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC78"> &gt;&gt; </A>]</TD>
 
281
<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual.html#SEC_Top">Top</A>]</TD>
 
282
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_toc.html#SEC_Contents">Contents</A>]</TD>
 
283
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_12.html#SEC354">Index</A>]</TD>
 
284
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_abt.html#SEC_About"> ? </A>]</TD>
 
285
</TR></TABLE>
 
286
<H3> readword </H3>
 
287
<!--docid::SEC73::-->
 
288
<P>
 
289
 
 
290
<TABLE><tr><td>&nbsp;</td><td class=example><pre>READWORD
 
291
RW
 
292
</pre></td></tr></table></P><P>
 
293
 
 
294
reads a line from the read stream and outputs that line as a word.  The
 
295
output is a single word even if the line contains spaces, brackets, etc.
 
296
If the read stream is a file, and the end of file is reached, READWORD
 
297
outputs the empty list (not the empty word).  READWORD processes
 
298
backslash, vertical bar, and tilde characters in the read stream.  In
 
299
the case of a tilde used for line continuation, the output word DOES
 
300
include the tilde and the newline characters, so that the user program
 
301
can tell exactly what the user entered.  Vertical bars in the line are
 
302
also preserved in the output.  Backslash characters are not preserved in
 
303
the output, but the character following the backslash has 128 added to
 
304
its representation.  Programs can use BACKSLASHEDP to check for this
 
305
code.  (Backslashedness is preserved only for certain characters.)
 
306
</P><P>
 
307
 
 
308
See section <A HREF="usermanual_2.html#SEC54">backslashedp</A> .
 
309
</P><P>
 
310
 
 
311
<A NAME="READRAWLINE"></A>
 
312
<HR SIZE="6">
 
313
<A NAME="SEC74"></A>
 
314
<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
 
315
<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC73"> &lt; </A>]</TD>
 
316
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC75"> &gt; </A>]</TD>
 
317
<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC67"> &lt;&lt; </A>]</TD>
 
318
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC71"> Up </A>]</TD>
 
319
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC78"> &gt;&gt; </A>]</TD>
 
320
<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual.html#SEC_Top">Top</A>]</TD>
 
321
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_toc.html#SEC_Contents">Contents</A>]</TD>
 
322
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_12.html#SEC354">Index</A>]</TD>
 
323
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_abt.html#SEC_About"> ? </A>]</TD>
 
324
</TR></TABLE>
 
325
<H3> readrawline </H3>
 
326
<!--docid::SEC74::-->
 
327
<P>
 
328
 
 
329
<TABLE><tr><td>&nbsp;</td><td class=example><pre>READRAWLINE
 
330
</pre></td></tr></table></P><P>
 
331
 
 
332
reads a line from the read stream and outputs that line as a word.  The
 
333
output is a single word even if the line contains spaces, brackets, etc.
 
334
If the read stream is a file, and the end of file is reached, READRAWLINE
 
335
outputs the empty list (not the empty word).  READRAWLINE outputs the
 
336
exact string of characters as they appear in the line, with no special
 
337
meaning for backslash, vertical bar, tilde, or any other formatting
 
338
characters.
 
339
</P><P>
 
340
 
 
341
See section <A HREF="usermanual_3.html#SEC73">readword</A> .
 
342
</P><P>
 
343
 
 
344
<A NAME="READCHAR"></A>
 
345
<HR SIZE="6">
 
346
<A NAME="SEC75"></A>
 
347
<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
 
348
<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC74"> &lt; </A>]</TD>
 
349
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC76"> &gt; </A>]</TD>
 
350
<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC67"> &lt;&lt; </A>]</TD>
 
351
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC71"> Up </A>]</TD>
 
352
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC78"> &gt;&gt; </A>]</TD>
 
353
<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual.html#SEC_Top">Top</A>]</TD>
 
354
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_toc.html#SEC_Contents">Contents</A>]</TD>
 
355
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_12.html#SEC354">Index</A>]</TD>
 
356
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_abt.html#SEC_About"> ? </A>]</TD>
 
357
</TR></TABLE>
 
358
<H3> readchar </H3>
 
359
<!--docid::SEC75::-->
 
360
<P>
 
361
 
 
362
<TABLE><tr><td>&nbsp;</td><td class=example><pre>READCHAR
 
363
RC
 
364
</pre></td></tr></table></P><P>
 
365
 
 
366
reads a single character from the read stream and outputs that character
 
367
as a word.  If the read stream is a file, and the end of file is
 
368
reached, READCHAR outputs the empty list (not the empty word).  If the
 
369
read stream is a terminal, echoing is turned off when READCHAR is
 
370
invoked, and remains off until READLIST or READWORD is invoked or a Logo
 
371
prompt is printed.  Backslash, vertical bar, and tilde characters have
 
372
no special meaning in this context.
 
373
</P><P>
 
374
 
 
375
See section <A HREF="usermanual_3.html#SEC72">readlist</A> .
 
376
</P><P>
 
377
 
 
378
<A NAME="READCHARS"></A>
 
379
<HR SIZE="6">
 
380
<A NAME="SEC76"></A>
 
381
<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
 
382
<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC75"> &lt; </A>]</TD>
 
383
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC77"> &gt; </A>]</TD>
 
384
<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC67"> &lt;&lt; </A>]</TD>
 
385
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC71"> Up </A>]</TD>
 
386
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC78"> &gt;&gt; </A>]</TD>
 
387
<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual.html#SEC_Top">Top</A>]</TD>
 
388
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_toc.html#SEC_Contents">Contents</A>]</TD>
 
389
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_12.html#SEC354">Index</A>]</TD>
 
390
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_abt.html#SEC_About"> ? </A>]</TD>
 
391
</TR></TABLE>
 
392
<H3> readchars </H3>
 
393
<!--docid::SEC76::-->
 
394
<P>
 
395
 
 
396
<TABLE><tr><td>&nbsp;</td><td class=example><pre>READCHARS num
 
397
RCS num
 
398
</pre></td></tr></table></P><P>
 
399
 
 
400
reads <CODE>num</CODE> characters from the read stream and outputs those characters
 
401
as a word.  If the read stream is a file, and the end of file is
 
402
reached, READCHARS outputs the empty list (not the empty word).  If the
 
403
read stream is a terminal, echoing is turned off when READCHARS is
 
404
invoked, and remains off until READLIST or READWORD is invoked or a Logo
 
405
prompt is printed.  Backslash, vertical bar, and tilde characters have
 
406
no special meaning in this context.
 
407
</P><P>
 
408
 
 
409
See section <A HREF="usermanual_3.html#SEC72">readlist</A> ,
 
410
<A HREF="usermanual_3.html#SEC73">readword</A>
 
411
</P><P>
 
412
 
 
413
<A NAME="SHELL"></A>
 
414
<HR SIZE="6">
 
415
<A NAME="SEC77"></A>
 
416
<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
 
417
<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC76"> &lt; </A>]</TD>
 
418
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC78"> &gt; </A>]</TD>
 
419
<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC67"> &lt;&lt; </A>]</TD>
 
420
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC71"> Up </A>]</TD>
 
421
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC78"> &gt;&gt; </A>]</TD>
 
422
<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual.html#SEC_Top">Top</A>]</TD>
 
423
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_toc.html#SEC_Contents">Contents</A>]</TD>
 
424
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_12.html#SEC354">Index</A>]</TD>
 
425
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_abt.html#SEC_About"> ? </A>]</TD>
 
426
</TR></TABLE>
 
427
<H3> shell </H3>
 
428
<!--docid::SEC77::-->
 
429
<P>
 
430
 
 
431
<TABLE><tr><td>&nbsp;</td><td class=example><pre>SHELL command
 
432
(SHELL command wordflag)
 
433
</pre></td></tr></table></P><P>
 
434
 
 
435
Under Unix, outputs the result of running <CODE>command</CODE> as a shell command.
 
436
(The command is sent to <SAMP>`/bin/sh'</SAMP>, not <SAMP>`csh'</SAMP> or other alternatives.)  If the command is a literal list in the instruction line, and if you want a
 
437
backslash character sent to the shell, you must use \\ to get the
 
438
backslash through Logo's reader intact.  The output is a list containing
 
439
one member for each line generated by the shell command.  Ordinarily
 
440
each such line is represented by a list in the output, as though the
 
441
line were read using READLIST.  If a second input is given, regardless
 
442
of the value of the input, each line is represented by a word in the
 
443
output as though it were read with READWORD.  Example:
 
444
</P><P>
 
445
 
 
446
<TABLE><tr><td>&nbsp;</td><td class=example><pre>to dayofweek
 
447
output first first shell [date]
 
448
end
 
449
</pre></td></tr></table></P><P>
 
450
 
 
451
This is "first first" to extract the first word of the first (and only)
 
452
line of the shell output.
 
453
</P><P>
 
454
 
 
455
Under DOS, SHELL is a command, not an operation; it sends its input to a
 
456
DOS command processor but does not collect the result of the command.
 
457
</P><P>
 
458
 
 
459
The Macintosh, of course, is not programmable.
 
460
</P><P>
 
461
 
 
462
<A NAME="FILE ACCESS"></A>
 
463
<HR SIZE="6">
 
464
<A NAME="SEC78"></A>
 
465
<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
 
466
<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC77"> &lt; </A>]</TD>
 
467
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC79"> &gt; </A>]</TD>
 
468
<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC71"> &lt;&lt; </A>]</TD>
 
469
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC66"> Up </A>]</TD>
 
470
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC101"> &gt;&gt; </A>]</TD>
 
471
<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual.html#SEC_Top">Top</A>]</TD>
 
472
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_toc.html#SEC_Contents">Contents</A>]</TD>
 
473
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_12.html#SEC354">Index</A>]</TD>
 
474
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_abt.html#SEC_About"> ? </A>]</TD>
 
475
</TR></TABLE>
 
476
<H2> 3.3 File Access </H2>
 
477
<!--docid::SEC78::-->
 
478
<P>
 
479
 
 
480
<BLOCKQUOTE><TABLE BORDER=0 CELLSPACING=0> 
 
481
<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="usermanual_3.html#SEC79">setprefix</A></TD><TD>&nbsp;&nbsp;</TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
 
482
<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="usermanual_3.html#SEC80">prefix</A></TD><TD>&nbsp;&nbsp;</TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
 
483
<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="usermanual_3.html#SEC81">openread</A></TD><TD>&nbsp;&nbsp;</TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
 
484
<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="usermanual_3.html#SEC82">openwrite</A></TD><TD>&nbsp;&nbsp;</TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
 
485
<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="usermanual_3.html#SEC83">openappend</A></TD><TD>&nbsp;&nbsp;</TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
 
486
<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="usermanual_3.html#SEC84">openupdate</A></TD><TD>&nbsp;&nbsp;</TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
 
487
<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="usermanual_3.html#SEC85">close</A></TD><TD>&nbsp;&nbsp;</TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
 
488
<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="usermanual_3.html#SEC86">allopen</A></TD><TD>&nbsp;&nbsp;</TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
 
489
<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="usermanual_3.html#SEC87">closeall</A></TD><TD>&nbsp;&nbsp;</TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
 
490
<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="usermanual_3.html#SEC88">erasefile</A></TD><TD>&nbsp;&nbsp;</TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
 
491
<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="usermanual_3.html#SEC89">dribble</A></TD><TD>&nbsp;&nbsp;</TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
 
492
<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="usermanual_3.html#SEC90">nodribble</A></TD><TD>&nbsp;&nbsp;</TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
 
493
<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="usermanual_3.html#SEC91">setread</A></TD><TD>&nbsp;&nbsp;</TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
 
494
<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="usermanual_3.html#SEC92">setwrite</A></TD><TD>&nbsp;&nbsp;</TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
 
495
<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="usermanual_3.html#SEC93">reader</A></TD><TD>&nbsp;&nbsp;</TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
 
496
<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="usermanual_3.html#SEC94">writer</A></TD><TD>&nbsp;&nbsp;</TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
 
497
<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="usermanual_3.html#SEC95">setreadpos</A></TD><TD>&nbsp;&nbsp;</TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
 
498
<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="usermanual_3.html#SEC96">setwritepos</A></TD><TD>&nbsp;&nbsp;</TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
 
499
<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="usermanual_3.html#SEC97">readpos</A></TD><TD>&nbsp;&nbsp;</TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
 
500
<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="usermanual_3.html#SEC98">writepos</A></TD><TD>&nbsp;&nbsp;</TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
 
501
<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="usermanual_3.html#SEC99">eofp</A></TD><TD>&nbsp;&nbsp;</TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
 
502
<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="usermanual_3.html#SEC100">filep</A></TD><TD>&nbsp;&nbsp;</TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
 
503
</TABLE></BLOCKQUOTE>
 
504
<P>
 
505
 
 
506
<A NAME="SETPREFIX"></A>
 
507
<HR SIZE="6">
 
508
<A NAME="SEC79"></A>
 
509
<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
 
510
<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC78"> &lt; </A>]</TD>
 
511
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC80"> &gt; </A>]</TD>
 
512
<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC71"> &lt;&lt; </A>]</TD>
 
513
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC78"> Up </A>]</TD>
 
514
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC101"> &gt;&gt; </A>]</TD>
 
515
<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual.html#SEC_Top">Top</A>]</TD>
 
516
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_toc.html#SEC_Contents">Contents</A>]</TD>
 
517
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_12.html#SEC354">Index</A>]</TD>
 
518
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_abt.html#SEC_About"> ? </A>]</TD>
 
519
</TR></TABLE>
 
520
<H3> setprefix </H3>
 
521
<!--docid::SEC79::-->
 
522
<P>
 
523
 
 
524
<TABLE><tr><td>&nbsp;</td><td class=example><pre>SETPREFIX string
 
525
</pre></td></tr></table></P><P>
 
526
 
 
527
command.  Sets a prefix that will be used as the implicit beginning of
 
528
filenames in OPENREAD, OPENWRITE, OPENAPPEND, OPENUPDATE, LOAD, and SAVE
 
529
commands.  Logo will put the appropriate separator character (slash for
 
530
Unix, backslash for DOS/Windows, colon for MacOS) between the prefix and
 
531
the filename entered by the user.  The input to SETPREFIX must be a
 
532
word, unless it is the empty list, to indicate that there should be no
 
533
prefix.
 
534
</P><P>
 
535
 
 
536
See section <A HREF="usermanual_3.html#SEC81">openread</A> , 
 
537
See section <A HREF="usermanual_3.html#SEC82">openwrite</A> ,
 
538
See section <A HREF="usermanual_3.html#SEC83">openappend</A> ,
 
539
See section <A HREF="usermanual_3.html#SEC84">openupdate</A> ,
 
540
See section <A HREF="usermanual_7.html#SEC289">load</A> ,
 
541
See section <A HREF="usermanual_7.html#SEC287">save</A> .
 
542
</P><P>
 
543
 
 
544
<A NAME="PREFIX"></A>
 
545
<HR SIZE="6">
 
546
<A NAME="SEC80"></A>
 
547
<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
 
548
<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC79"> &lt; </A>]</TD>
 
549
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC81"> &gt; </A>]</TD>
 
550
<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC71"> &lt;&lt; </A>]</TD>
 
551
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC78"> Up </A>]</TD>
 
552
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC101"> &gt;&gt; </A>]</TD>
 
553
<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual.html#SEC_Top">Top</A>]</TD>
 
554
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_toc.html#SEC_Contents">Contents</A>]</TD>
 
555
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_12.html#SEC354">Index</A>]</TD>
 
556
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_abt.html#SEC_About"> ? </A>]</TD>
 
557
</TR></TABLE>
 
558
<H3> prefix </H3>
 
559
<!--docid::SEC80::-->
 
560
<P>
 
561
 
 
562
<TABLE><tr><td>&nbsp;</td><td class=example><pre>PREFIX
 
563
</pre></td></tr></table></P><P>
 
564
 
 
565
outputs the current file prefix, or [] if there is no prefix.
 
566
</P><P>
 
567
 
 
568
See section <A HREF="usermanual_3.html#SEC79">setprefix</A> .
 
569
</P><P>
 
570
 
 
571
<A NAME="OPENREAD"></A>
 
572
<HR SIZE="6">
 
573
<A NAME="SEC81"></A>
 
574
<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
 
575
<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC80"> &lt; </A>]</TD>
 
576
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC82"> &gt; </A>]</TD>
 
577
<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC71"> &lt;&lt; </A>]</TD>
 
578
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC78"> Up </A>]</TD>
 
579
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC101"> &gt;&gt; </A>]</TD>
 
580
<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual.html#SEC_Top">Top</A>]</TD>
 
581
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_toc.html#SEC_Contents">Contents</A>]</TD>
 
582
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_12.html#SEC354">Index</A>]</TD>
 
583
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_abt.html#SEC_About"> ? </A>]</TD>
 
584
</TR></TABLE>
 
585
<H3> openread </H3>
 
586
<!--docid::SEC81::-->
 
587
<P>
 
588
 
 
589
<TABLE><tr><td>&nbsp;</td><td class=example><pre>OPENREAD filename
 
590
</pre></td></tr></table></P><P>
 
591
 
 
592
command.  Opens the named file for reading.  The read position is
 
593
initially at the beginning of the file.
 
594
</P><P>
 
595
 
 
596
<A NAME="OPENWRITE"></A>
 
597
<HR SIZE="6">
 
598
<A NAME="SEC82"></A>
 
599
<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
 
600
<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC81"> &lt; </A>]</TD>
 
601
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC83"> &gt; </A>]</TD>
 
602
<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC71"> &lt;&lt; </A>]</TD>
 
603
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC78"> Up </A>]</TD>
 
604
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC101"> &gt;&gt; </A>]</TD>
 
605
<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual.html#SEC_Top">Top</A>]</TD>
 
606
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_toc.html#SEC_Contents">Contents</A>]</TD>
 
607
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_12.html#SEC354">Index</A>]</TD>
 
608
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_abt.html#SEC_About"> ? </A>]</TD>
 
609
</TR></TABLE>
 
610
<H3> openwrite </H3>
 
611
<!--docid::SEC82::-->
 
612
<P>
 
613
 
 
614
<TABLE><tr><td>&nbsp;</td><td class=example><pre>OPENWRITE filename
 
615
</pre></td></tr></table></P><P>
 
616
 
 
617
command.  Opens the named file for writing.  If the file already
 
618
existed, the old version is deleted and a new, empty file created.
 
619
</P><P>
 
620
 
 
621
<A NAME="OPENAPPEND"></A>
 
622
<HR SIZE="6">
 
623
<A NAME="SEC83"></A>
 
624
<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
 
625
<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC82"> &lt; </A>]</TD>
 
626
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC84"> &gt; </A>]</TD>
 
627
<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC71"> &lt;&lt; </A>]</TD>
 
628
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC78"> Up </A>]</TD>
 
629
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC101"> &gt;&gt; </A>]</TD>
 
630
<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual.html#SEC_Top">Top</A>]</TD>
 
631
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_toc.html#SEC_Contents">Contents</A>]</TD>
 
632
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_12.html#SEC354">Index</A>]</TD>
 
633
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_abt.html#SEC_About"> ? </A>]</TD>
 
634
</TR></TABLE>
 
635
<H3> openappend </H3>
 
636
<!--docid::SEC83::-->
 
637
<P>
 
638
 
 
639
<TABLE><tr><td>&nbsp;</td><td class=example><pre>OPENAPPEND filename
 
640
</pre></td></tr></table></P><P>
 
641
 
 
642
command.  Opens the named file for writing.  If the file already exists,
 
643
the write position is initially set to the end of the old file, so that
 
644
newly written data will be appended to it.
 
645
</P><P>
 
646
 
 
647
<A NAME="OPENUPDATE"></A>
 
648
<HR SIZE="6">
 
649
<A NAME="SEC84"></A>
 
650
<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
 
651
<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC83"> &lt; </A>]</TD>
 
652
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC85"> &gt; </A>]</TD>
 
653
<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC71"> &lt;&lt; </A>]</TD>
 
654
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC78"> Up </A>]</TD>
 
655
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC101"> &gt;&gt; </A>]</TD>
 
656
<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual.html#SEC_Top">Top</A>]</TD>
 
657
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_toc.html#SEC_Contents">Contents</A>]</TD>
 
658
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_12.html#SEC354">Index</A>]</TD>
 
659
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_abt.html#SEC_About"> ? </A>]</TD>
 
660
</TR></TABLE>
 
661
<H3> openupdate </H3>
 
662
<!--docid::SEC84::-->
 
663
<P>
 
664
 
 
665
<TABLE><tr><td>&nbsp;</td><td class=example><pre>OPENUPDATE filename
 
666
</pre></td></tr></table></P><P>
 
667
 
 
668
command.  Opens the named file for reading and writing.  The read and
 
669
write position is initially set to the end of the old file, if any.
 
670
Note: each open file has only one position, for both reading and
 
671
writing.  If a file opened for update is both READER and WRITER at the
 
672
same time, then SETREADPOS will also affect WRITEPOS and vice versa.
 
673
Also, if you alternate reading and writing the same file, you must
 
674
SETREADPOS between a write and a read, and SETWRITEPOS between a read
 
675
and a write.
 
676
</P><P>
 
677
 
 
678
See section <A HREF="usermanual_3.html#SEC93">reader</A> ,
 
679
<A HREF="usermanual_3.html#SEC94">writer</A> ,
 
680
<A HREF="usermanual_3.html#SEC95">setreadpos</A> ,
 
681
<A HREF="usermanual_3.html#SEC96">setwritepos</A>
 
682
</P><P>
 
683
 
 
684
<A NAME="CLOSE"></A>
 
685
<HR SIZE="6">
 
686
<A NAME="SEC85"></A>
 
687
<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
 
688
<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC84"> &lt; </A>]</TD>
 
689
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC86"> &gt; </A>]</TD>
 
690
<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC71"> &lt;&lt; </A>]</TD>
 
691
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC78"> Up </A>]</TD>
 
692
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC101"> &gt;&gt; </A>]</TD>
 
693
<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual.html#SEC_Top">Top</A>]</TD>
 
694
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_toc.html#SEC_Contents">Contents</A>]</TD>
 
695
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_12.html#SEC354">Index</A>]</TD>
 
696
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_abt.html#SEC_About"> ? </A>]</TD>
 
697
</TR></TABLE>
 
698
<H3> close </H3>
 
699
<!--docid::SEC85::-->
 
700
<P>
 
701
 
 
702
<TABLE><tr><td>&nbsp;</td><td class=example><pre>CLOSE filename
 
703
</pre></td></tr></table></P><P>
 
704
 
 
705
command.  Closes the named file.
 
706
</P><P>
 
707
 
 
708
<A NAME="ALLOPEN"></A>
 
709
<HR SIZE="6">
 
710
<A NAME="SEC86"></A>
 
711
<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
 
712
<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC85"> &lt; </A>]</TD>
 
713
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC87"> &gt; </A>]</TD>
 
714
<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC71"> &lt;&lt; </A>]</TD>
 
715
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC78"> Up </A>]</TD>
 
716
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC101"> &gt;&gt; </A>]</TD>
 
717
<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual.html#SEC_Top">Top</A>]</TD>
 
718
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_toc.html#SEC_Contents">Contents</A>]</TD>
 
719
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_12.html#SEC354">Index</A>]</TD>
 
720
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_abt.html#SEC_About"> ? </A>]</TD>
 
721
</TR></TABLE>
 
722
<H3> allopen </H3>
 
723
<!--docid::SEC86::-->
 
724
<P>
 
725
 
 
726
<TABLE><tr><td>&nbsp;</td><td class=example><pre>ALLOPEN
 
727
</pre></td></tr></table></P><P>
 
728
 
 
729
outputs a list whose members are the names of all files currently open.
 
730
This list does not include the dribble file, if any.
 
731
</P><P>
 
732
 
 
733
<A NAME="CLOSEALL"></A>
 
734
<HR SIZE="6">
 
735
<A NAME="SEC87"></A>
 
736
<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
 
737
<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC86"> &lt; </A>]</TD>
 
738
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC88"> &gt; </A>]</TD>
 
739
<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC71"> &lt;&lt; </A>]</TD>
 
740
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC78"> Up </A>]</TD>
 
741
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC101"> &gt;&gt; </A>]</TD>
 
742
<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual.html#SEC_Top">Top</A>]</TD>
 
743
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_toc.html#SEC_Contents">Contents</A>]</TD>
 
744
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_12.html#SEC354">Index</A>]</TD>
 
745
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_abt.html#SEC_About"> ? </A>]</TD>
 
746
</TR></TABLE>
 
747
<H3> closeall </H3>
 
748
<!--docid::SEC87::-->
 
749
<P>
 
750
 
 
751
<TABLE><tr><td>&nbsp;</td><td class=example><pre>CLOSEALL                                       (library procedure)
 
752
</pre></td></tr></table></P><P>
 
753
 
 
754
command.  Closes all open files.  Abbreviates <TT>FOREACH ALLOPEN [CLOSE ?]</TT>
 
755
</P><P>
 
756
 
 
757
See section <A HREF="usermanual_8.html#SEC326">foreach</A> ,
 
758
<A HREF="usermanual_3.html#SEC85">close</A>
 
759
</P><P>
 
760
 
 
761
<A NAME="ERASEFILE"></A>
 
762
<HR SIZE="6">
 
763
<A NAME="SEC88"></A>
 
764
<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
 
765
<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC87"> &lt; </A>]</TD>
 
766
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC89"> &gt; </A>]</TD>
 
767
<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC71"> &lt;&lt; </A>]</TD>
 
768
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC78"> Up </A>]</TD>
 
769
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC101"> &gt;&gt; </A>]</TD>
 
770
<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual.html#SEC_Top">Top</A>]</TD>
 
771
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_toc.html#SEC_Contents">Contents</A>]</TD>
 
772
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_12.html#SEC354">Index</A>]</TD>
 
773
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_abt.html#SEC_About"> ? </A>]</TD>
 
774
</TR></TABLE>
 
775
<H3> erasefile </H3>
 
776
<!--docid::SEC88::-->
 
777
<P>
 
778
 
 
779
<TABLE><tr><td>&nbsp;</td><td class=example><pre>ERASEFILE filename
 
780
ERF filename
 
781
</pre></td></tr></table></P><P>
 
782
 
 
783
command.  Erases (deletes, removes) the named file, which should not
 
784
currently be open.
 
785
</P><P>
 
786
 
 
787
<A NAME="DRIBBLE"></A>
 
788
<HR SIZE="6">
 
789
<A NAME="SEC89"></A>
 
790
<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
 
791
<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC88"> &lt; </A>]</TD>
 
792
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC90"> &gt; </A>]</TD>
 
793
<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC71"> &lt;&lt; </A>]</TD>
 
794
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC78"> Up </A>]</TD>
 
795
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC101"> &gt;&gt; </A>]</TD>
 
796
<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual.html#SEC_Top">Top</A>]</TD>
 
797
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_toc.html#SEC_Contents">Contents</A>]</TD>
 
798
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_12.html#SEC354">Index</A>]</TD>
 
799
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_abt.html#SEC_About"> ? </A>]</TD>
 
800
</TR></TABLE>
 
801
<H3> dribble </H3>
 
802
<!--docid::SEC89::-->
 
803
<P>
 
804
 
 
805
<TABLE><tr><td>&nbsp;</td><td class=example><pre>DRIBBLE filename
 
806
</pre></td></tr></table></P><P>
 
807
 
 
808
command.  Creates a new file whose name is the input, like OPENWRITE,
 
809
and begins recording in that file everything that is read from the
 
810
keyboard or written to the terminal.  That is, this writing is in
 
811
addition to the writing to WRITER.  The intent is to create a transcript
 
812
of a Logo session, including things like prompt characters and
 
813
interactions.
 
814
</P><P>
 
815
 
 
816
See section <A HREF="usermanual_3.html#SEC82">openwrite</A> ,
 
817
<A HREF="usermanual_3.html#SEC94">writer</A>
 
818
</P><P>
 
819
 
 
820
<A NAME="NODRIBBLE"></A>
 
821
<HR SIZE="6">
 
822
<A NAME="SEC90"></A>
 
823
<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
 
824
<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC89"> &lt; </A>]</TD>
 
825
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC91"> &gt; </A>]</TD>
 
826
<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC71"> &lt;&lt; </A>]</TD>
 
827
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC78"> Up </A>]</TD>
 
828
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC101"> &gt;&gt; </A>]</TD>
 
829
<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual.html#SEC_Top">Top</A>]</TD>
 
830
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_toc.html#SEC_Contents">Contents</A>]</TD>
 
831
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_12.html#SEC354">Index</A>]</TD>
 
832
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_abt.html#SEC_About"> ? </A>]</TD>
 
833
</TR></TABLE>
 
834
<H3> nodribble </H3>
 
835
<!--docid::SEC90::-->
 
836
<P>
 
837
 
 
838
<TABLE><tr><td>&nbsp;</td><td class=example><pre>NODRIBBLE
 
839
</pre></td></tr></table></P><P>
 
840
 
 
841
command.  Stops copying information into the dribble file, and closes
 
842
the file.
 
843
</P><P>
 
844
 
 
845
<A NAME="SETREAD"></A>
 
846
<HR SIZE="6">
 
847
<A NAME="SEC91"></A>
 
848
<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
 
849
<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC90"> &lt; </A>]</TD>
 
850
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC92"> &gt; </A>]</TD>
 
851
<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC71"> &lt;&lt; </A>]</TD>
 
852
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC78"> Up </A>]</TD>
 
853
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC101"> &gt;&gt; </A>]</TD>
 
854
<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual.html#SEC_Top">Top</A>]</TD>
 
855
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_toc.html#SEC_Contents">Contents</A>]</TD>
 
856
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_12.html#SEC354">Index</A>]</TD>
 
857
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_abt.html#SEC_About"> ? </A>]</TD>
 
858
</TR></TABLE>
 
859
<H3> setread </H3>
 
860
<!--docid::SEC91::-->
 
861
<P>
 
862
 
 
863
<TABLE><tr><td>&nbsp;</td><td class=example><pre>SETREAD filename
 
864
</pre></td></tr></table></P><P>
 
865
 
 
866
command.  Makes the named file the read stream, used for READLIST, etc.
 
867
The file must already be open with OPENREAD or OPENUPDATE.  If the input
 
868
is the empty list, then the read stream becomes the terminal, as usual.
 
869
Changing the read stream does not close the file that was previously the
 
870
read stream, so it is possible to alternate between files.
 
871
</P><P>
 
872
 
 
873
See section <A HREF="usermanual_3.html#SEC72">readlist</A> ,
 
874
<A HREF="usermanual_3.html#SEC81">openread</A> ,
 
875
<A HREF="usermanual_3.html#SEC84">openupdate</A>
 
876
</P><P>
 
877
 
 
878
<A NAME="SETWRITE"></A>
 
879
<HR SIZE="6">
 
880
<A NAME="SEC92"></A>
 
881
<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
 
882
<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC91"> &lt; </A>]</TD>
 
883
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC93"> &gt; </A>]</TD>
 
884
<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC71"> &lt;&lt; </A>]</TD>
 
885
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC78"> Up </A>]</TD>
 
886
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC101"> &gt;&gt; </A>]</TD>
 
887
<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual.html#SEC_Top">Top</A>]</TD>
 
888
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_toc.html#SEC_Contents">Contents</A>]</TD>
 
889
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_12.html#SEC354">Index</A>]</TD>
 
890
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_abt.html#SEC_About"> ? </A>]</TD>
 
891
</TR></TABLE>
 
892
<H3> setwrite </H3>
 
893
<!--docid::SEC92::-->
 
894
<P>
 
895
 
 
896
<TABLE><tr><td>&nbsp;</td><td class=example><pre>SETWRITE filename
 
897
</pre></td></tr></table></P><P>
 
898
 
 
899
command.  Makes the named file the write stream, used for PRINT, etc.
 
900
The file must already be open with OPENWRITE, OPENAPPEND, or OPENUPDATE.
 
901
If the input is the empty list, then the write stream becomes the
 
902
terminal, as usual.  Changing the write stream does not close the file
 
903
that was previously the write stream, so it is possible to alternate
 
904
between files.
 
905
</P><P>
 
906
 
 
907
See section <A HREF="usermanual_3.html#SEC68">print</A> ,
 
908
<A HREF="usermanual_3.html#SEC82">openwrite</A> ;
 
909
<A HREF="usermanual_3.html#SEC83">openappend</A> ;
 
910
<A HREF="usermanual_3.html#SEC84">openupdate</A>
 
911
</P><P>
 
912
 
 
913
<A NAME="READER"></A>
 
914
<HR SIZE="6">
 
915
<A NAME="SEC93"></A>
 
916
<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
 
917
<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC92"> &lt; </A>]</TD>
 
918
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC94"> &gt; </A>]</TD>
 
919
<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC71"> &lt;&lt; </A>]</TD>
 
920
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC78"> Up </A>]</TD>
 
921
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC101"> &gt;&gt; </A>]</TD>
 
922
<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual.html#SEC_Top">Top</A>]</TD>
 
923
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_toc.html#SEC_Contents">Contents</A>]</TD>
 
924
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_12.html#SEC354">Index</A>]</TD>
 
925
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_abt.html#SEC_About"> ? </A>]</TD>
 
926
</TR></TABLE>
 
927
<H3> reader </H3>
 
928
<!--docid::SEC93::-->
 
929
<P>
 
930
 
 
931
<TABLE><tr><td>&nbsp;</td><td class=example><pre>READER
 
932
</pre></td></tr></table></P><P>
 
933
 
 
934
outputs the name of the current read stream file, or the empty list if
 
935
the read stream is the terminal.
 
936
</P><P>
 
937
 
 
938
<A NAME="WRITER"></A>
 
939
<HR SIZE="6">
 
940
<A NAME="SEC94"></A>
 
941
<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
 
942
<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC93"> &lt; </A>]</TD>
 
943
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC95"> &gt; </A>]</TD>
 
944
<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC71"> &lt;&lt; </A>]</TD>
 
945
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC78"> Up </A>]</TD>
 
946
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC101"> &gt;&gt; </A>]</TD>
 
947
<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual.html#SEC_Top">Top</A>]</TD>
 
948
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_toc.html#SEC_Contents">Contents</A>]</TD>
 
949
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_12.html#SEC354">Index</A>]</TD>
 
950
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_abt.html#SEC_About"> ? </A>]</TD>
 
951
</TR></TABLE>
 
952
<H3> writer </H3>
 
953
<!--docid::SEC94::-->
 
954
<P>
 
955
 
 
956
<TABLE><tr><td>&nbsp;</td><td class=example><pre>WRITER
 
957
</pre></td></tr></table></P><P>
 
958
 
 
959
outputs the name of the current write stream file, or the empty list if
 
960
the write stream is the terminal.
 
961
</P><P>
 
962
 
 
963
<A NAME="SETREADPOS"></A>
 
964
<HR SIZE="6">
 
965
<A NAME="SEC95"></A>
 
966
<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
 
967
<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC94"> &lt; </A>]</TD>
 
968
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC96"> &gt; </A>]</TD>
 
969
<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC71"> &lt;&lt; </A>]</TD>
 
970
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC78"> Up </A>]</TD>
 
971
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC101"> &gt;&gt; </A>]</TD>
 
972
<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual.html#SEC_Top">Top</A>]</TD>
 
973
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_toc.html#SEC_Contents">Contents</A>]</TD>
 
974
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_12.html#SEC354">Index</A>]</TD>
 
975
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_abt.html#SEC_About"> ? </A>]</TD>
 
976
</TR></TABLE>
 
977
<H3> setreadpos </H3>
 
978
<!--docid::SEC95::-->
 
979
<P>
 
980
 
 
981
<TABLE><tr><td>&nbsp;</td><td class=example><pre>SETREADPOS charpos
 
982
</pre></td></tr></table></P><P>
 
983
 
 
984
command.  Sets the file pointer of the read stream file so that the next
 
985
READLIST, etc., will begin reading at the <CODE>charpos</CODE>th character in the
 
986
file, counting from 0.  (That is, <TT>SETREADPOS 0</TT> will start reading from
 
987
the beginning of the file.)  Meaningless if the read stream is the
 
988
terminal.
 
989
</P><P>
 
990
 
 
991
See section <A HREF="usermanual_3.html#SEC72">readlist</A> .
 
992
</P><P>
 
993
 
 
994
<A NAME="SETWRITEPOS"></A>
 
995
<HR SIZE="6">
 
996
<A NAME="SEC96"></A>
 
997
<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
 
998
<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC95"> &lt; </A>]</TD>
 
999
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC97"> &gt; </A>]</TD>
 
1000
<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC71"> &lt;&lt; </A>]</TD>
 
1001
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC78"> Up </A>]</TD>
 
1002
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC101"> &gt;&gt; </A>]</TD>
 
1003
<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual.html#SEC_Top">Top</A>]</TD>
 
1004
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_toc.html#SEC_Contents">Contents</A>]</TD>
 
1005
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_12.html#SEC354">Index</A>]</TD>
 
1006
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_abt.html#SEC_About"> ? </A>]</TD>
 
1007
</TR></TABLE>
 
1008
<H3> setwritepos </H3>
 
1009
<!--docid::SEC96::-->
 
1010
<P>
 
1011
 
 
1012
<TABLE><tr><td>&nbsp;</td><td class=example><pre>SETWRITEPOS charpos
 
1013
</pre></td></tr></table></P><P>
 
1014
 
 
1015
command.  Sets the file pointer of the write stream file so that the
 
1016
next PRINT, etc., will begin writing at the <CODE>charpos</CODE>th character in the
 
1017
file, counting from 0.  (That is, <TT>SETWRITEPOS 0</TT> will start writing from
 
1018
the beginning of the file.)  Meaningless if the write stream is the
 
1019
terminal.
 
1020
</P><P>
 
1021
 
 
1022
See section <A HREF="usermanual_3.html#SEC68">print</A> .
 
1023
</P><P>
 
1024
 
 
1025
<A NAME="READPOS"></A>
 
1026
<HR SIZE="6">
 
1027
<A NAME="SEC97"></A>
 
1028
<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
 
1029
<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC96"> &lt; </A>]</TD>
 
1030
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC98"> &gt; </A>]</TD>
 
1031
<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC71"> &lt;&lt; </A>]</TD>
 
1032
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC78"> Up </A>]</TD>
 
1033
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC101"> &gt;&gt; </A>]</TD>
 
1034
<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual.html#SEC_Top">Top</A>]</TD>
 
1035
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_toc.html#SEC_Contents">Contents</A>]</TD>
 
1036
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_12.html#SEC354">Index</A>]</TD>
 
1037
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_abt.html#SEC_About"> ? </A>]</TD>
 
1038
</TR></TABLE>
 
1039
<H3> readpos </H3>
 
1040
<!--docid::SEC97::-->
 
1041
<P>
 
1042
 
 
1043
<TABLE><tr><td>&nbsp;</td><td class=example><pre>READPOS
 
1044
</pre></td></tr></table></P><P>
 
1045
 
 
1046
outputs the file position of the current read stream file.
 
1047
</P><P>
 
1048
 
 
1049
<A NAME="WRITEPOS"></A>
 
1050
<HR SIZE="6">
 
1051
<A NAME="SEC98"></A>
 
1052
<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
 
1053
<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC97"> &lt; </A>]</TD>
 
1054
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC99"> &gt; </A>]</TD>
 
1055
<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC71"> &lt;&lt; </A>]</TD>
 
1056
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC78"> Up </A>]</TD>
 
1057
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC101"> &gt;&gt; </A>]</TD>
 
1058
<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual.html#SEC_Top">Top</A>]</TD>
 
1059
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_toc.html#SEC_Contents">Contents</A>]</TD>
 
1060
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_12.html#SEC354">Index</A>]</TD>
 
1061
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_abt.html#SEC_About"> ? </A>]</TD>
 
1062
</TR></TABLE>
 
1063
<H3> writepos </H3>
 
1064
<!--docid::SEC98::-->
 
1065
<P>
 
1066
 
 
1067
<TABLE><tr><td>&nbsp;</td><td class=example><pre>WRITEPOS
 
1068
</pre></td></tr></table></P><P>
 
1069
 
 
1070
outputs the file position of the current write stream file.
 
1071
</P><P>
 
1072
 
 
1073
<A NAME="EOFP"></A>
 
1074
<HR SIZE="6">
 
1075
<A NAME="SEC99"></A>
 
1076
<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
 
1077
<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC98"> &lt; </A>]</TD>
 
1078
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC100"> &gt; </A>]</TD>
 
1079
<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC71"> &lt;&lt; </A>]</TD>
 
1080
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC78"> Up </A>]</TD>
 
1081
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC101"> &gt;&gt; </A>]</TD>
 
1082
<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual.html#SEC_Top">Top</A>]</TD>
 
1083
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_toc.html#SEC_Contents">Contents</A>]</TD>
 
1084
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_12.html#SEC354">Index</A>]</TD>
 
1085
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_abt.html#SEC_About"> ? </A>]</TD>
 
1086
</TR></TABLE>
 
1087
<H3> eofp </H3>
 
1088
<!--docid::SEC99::-->
 
1089
<P>
 
1090
 
 
1091
<TABLE><tr><td>&nbsp;</td><td class=example><pre>EOFP
 
1092
EOF?
 
1093
</pre></td></tr></table></P><P>
 
1094
 
 
1095
predicate, outputs TRUE if there are no more characters to be read in
 
1096
the read stream file, FALSE otherwise.
 
1097
</P><P>
 
1098
 
 
1099
<A NAME="FILEP"></A>
 
1100
<HR SIZE="6">
 
1101
<A NAME="SEC100"></A>
 
1102
<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
 
1103
<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC99"> &lt; </A>]</TD>
 
1104
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC101"> &gt; </A>]</TD>
 
1105
<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC71"> &lt;&lt; </A>]</TD>
 
1106
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC78"> Up </A>]</TD>
 
1107
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC101"> &gt;&gt; </A>]</TD>
 
1108
<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual.html#SEC_Top">Top</A>]</TD>
 
1109
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_toc.html#SEC_Contents">Contents</A>]</TD>
 
1110
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_12.html#SEC354">Index</A>]</TD>
 
1111
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_abt.html#SEC_About"> ? </A>]</TD>
 
1112
</TR></TABLE>
 
1113
<H3> filep </H3>
 
1114
<!--docid::SEC100::-->
 
1115
<P>
 
1116
 
 
1117
<TABLE><tr><td>&nbsp;</td><td class=example><pre>FILEP filename
 
1118
FILE? filename                                  (library procedure)
 
1119
</pre></td></tr></table></P><P>
 
1120
 
 
1121
predicate, outputs TRUE if a file of the specified name exists and can
 
1122
be read, FALSE otherwise.
 
1123
</P><P>
 
1124
 
 
1125
<A NAME="TERMINAL ACCESS"></A>
 
1126
<HR SIZE="6">
 
1127
<A NAME="SEC101"></A>
 
1128
<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
 
1129
<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC100"> &lt; </A>]</TD>
 
1130
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC102"> &gt; </A>]</TD>
 
1131
<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC78"> &lt;&lt; </A>]</TD>
 
1132
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC66"> Up </A>]</TD>
 
1133
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_4.html#SEC108"> &gt;&gt; </A>]</TD>
 
1134
<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual.html#SEC_Top">Top</A>]</TD>
 
1135
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_toc.html#SEC_Contents">Contents</A>]</TD>
 
1136
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_12.html#SEC354">Index</A>]</TD>
 
1137
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_abt.html#SEC_About"> ? </A>]</TD>
 
1138
</TR></TABLE>
 
1139
<H2> 3.4 Terminal Access </H2>
 
1140
<!--docid::SEC101::-->
 
1141
<P>
 
1142
 
 
1143
<BLOCKQUOTE><TABLE BORDER=0 CELLSPACING=0> 
 
1144
<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="usermanual_3.html#SEC102">keyp</A></TD><TD>&nbsp;&nbsp;</TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
 
1145
<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="usermanual_3.html#SEC103">cleartext</A></TD><TD>&nbsp;&nbsp;</TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
 
1146
<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="usermanual_3.html#SEC104">setcursor</A></TD><TD>&nbsp;&nbsp;</TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
 
1147
<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="usermanual_3.html#SEC105">cursor</A></TD><TD>&nbsp;&nbsp;</TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
 
1148
<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="usermanual_3.html#SEC106">setmargins</A></TD><TD>&nbsp;&nbsp;</TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
 
1149
<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="usermanual_3.html#SEC107">settextcolor</A></TD><TD>&nbsp;&nbsp;</TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
 
1150
</TABLE></BLOCKQUOTE>
 
1151
<P>
 
1152
 
 
1153
<A NAME="KEYP"></A>
 
1154
<HR SIZE="6">
 
1155
<A NAME="SEC102"></A>
 
1156
<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
 
1157
<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC101"> &lt; </A>]</TD>
 
1158
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC103"> &gt; </A>]</TD>
 
1159
<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC78"> &lt;&lt; </A>]</TD>
 
1160
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC101"> Up </A>]</TD>
 
1161
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_4.html#SEC108"> &gt;&gt; </A>]</TD>
 
1162
<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual.html#SEC_Top">Top</A>]</TD>
 
1163
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_toc.html#SEC_Contents">Contents</A>]</TD>
 
1164
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_12.html#SEC354">Index</A>]</TD>
 
1165
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_abt.html#SEC_About"> ? </A>]</TD>
 
1166
</TR></TABLE>
 
1167
<H3> keyp </H3>
 
1168
<!--docid::SEC102::-->
 
1169
<P>
 
1170
 
 
1171
<TABLE><tr><td>&nbsp;</td><td class=example><pre>KEYP
 
1172
KEY?
 
1173
</pre></td></tr></table></P><P>
 
1174
 
 
1175
predicate, outputs TRUE if there are characters waiting to be read from
 
1176
the read stream.  If the read stream is a file, this is equivalent to
 
1177
<TT>NOT EOFP</TT>.  If the read stream is the terminal, then echoing is turned
 
1178
off and the terminal is set to CBREAK (character at a time instead of
 
1179
line at a time) mode.  It remains in this mode until some line-mode
 
1180
reading is requested (e.g., READLIST).  The Unix operating system
 
1181
forgets about any pending characters when it switches modes, so the
 
1182
first KEYP invocation will always output FALSE.
 
1183
</P><P>
 
1184
 
 
1185
See section <A HREF="usermanual_3.html#SEC99">eofp</A> ,
 
1186
<A HREF="usermanual_3.html#SEC72">readlist</A>
 
1187
</P><P>
 
1188
 
 
1189
<A NAME="CLEARTEXT"></A>
 
1190
<HR SIZE="6">
 
1191
<A NAME="SEC103"></A>
 
1192
<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
 
1193
<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC102"> &lt; </A>]</TD>
 
1194
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC104"> &gt; </A>]</TD>
 
1195
<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC78"> &lt;&lt; </A>]</TD>
 
1196
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC101"> Up </A>]</TD>
 
1197
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_4.html#SEC108"> &gt;&gt; </A>]</TD>
 
1198
<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual.html#SEC_Top">Top</A>]</TD>
 
1199
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_toc.html#SEC_Contents">Contents</A>]</TD>
 
1200
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_12.html#SEC354">Index</A>]</TD>
 
1201
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_abt.html#SEC_About"> ? </A>]</TD>
 
1202
</TR></TABLE>
 
1203
<H3> cleartext </H3>
 
1204
<!--docid::SEC103::-->
 
1205
<P>
 
1206
 
 
1207
<TABLE><tr><td>&nbsp;</td><td class=example><pre>CLEARTEXT
 
1208
CT
 
1209
</pre></td></tr></table></P><P>
 
1210
 
 
1211
command.  Clears the text screen of the terminal.
 
1212
</P><P>
 
1213
 
 
1214
<A NAME="SETCURSOR"></A>
 
1215
<HR SIZE="6">
 
1216
<A NAME="SEC104"></A>
 
1217
<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
 
1218
<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC103"> &lt; </A>]</TD>
 
1219
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC105"> &gt; </A>]</TD>
 
1220
<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC78"> &lt;&lt; </A>]</TD>
 
1221
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC101"> Up </A>]</TD>
 
1222
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_4.html#SEC108"> &gt;&gt; </A>]</TD>
 
1223
<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual.html#SEC_Top">Top</A>]</TD>
 
1224
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_toc.html#SEC_Contents">Contents</A>]</TD>
 
1225
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_12.html#SEC354">Index</A>]</TD>
 
1226
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_abt.html#SEC_About"> ? </A>]</TD>
 
1227
</TR></TABLE>
 
1228
<H3> setcursor </H3>
 
1229
<!--docid::SEC104::-->
 
1230
<P>
 
1231
 
 
1232
<TABLE><tr><td>&nbsp;</td><td class=example><pre>SETCURSOR vector
 
1233
</pre></td></tr></table></P><P>
 
1234
 
 
1235
command.  The input is a list of two numbers, the x and y coordinates of
 
1236
a screen position (origin in the upper left corner, positive direction
 
1237
is southeast).  The screen cursor is moved to the requested position.
 
1238
This command also forces the immediate printing of any buffered
 
1239
characters.
 
1240
</P><P>
 
1241
 
 
1242
<A NAME="CURSOR"></A>
 
1243
<HR SIZE="6">
 
1244
<A NAME="SEC105"></A>
 
1245
<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
 
1246
<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC104"> &lt; </A>]</TD>
 
1247
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC106"> &gt; </A>]</TD>
 
1248
<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC78"> &lt;&lt; </A>]</TD>
 
1249
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC101"> Up </A>]</TD>
 
1250
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_4.html#SEC108"> &gt;&gt; </A>]</TD>
 
1251
<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual.html#SEC_Top">Top</A>]</TD>
 
1252
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_toc.html#SEC_Contents">Contents</A>]</TD>
 
1253
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_12.html#SEC354">Index</A>]</TD>
 
1254
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_abt.html#SEC_About"> ? </A>]</TD>
 
1255
</TR></TABLE>
 
1256
<H3> cursor </H3>
 
1257
<!--docid::SEC105::-->
 
1258
<P>
 
1259
 
 
1260
<TABLE><tr><td>&nbsp;</td><td class=example><pre>CURSOR
 
1261
</pre></td></tr></table></P><P>
 
1262
 
 
1263
outputs a list containing the current x and y coordinates of the screen
 
1264
cursor.  Logo may get confused about the current cursor position if,
 
1265
e.g., you type in a long line that wraps around or your program prints
 
1266
escape codes that affect the terminal strangely.
 
1267
</P><P>
 
1268
 
 
1269
<A NAME="SETMARGINS"></A>
 
1270
<HR SIZE="6">
 
1271
<A NAME="SEC106"></A>
 
1272
<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
 
1273
<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC105"> &lt; </A>]</TD>
 
1274
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC107"> &gt; </A>]</TD>
 
1275
<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC78"> &lt;&lt; </A>]</TD>
 
1276
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC101"> Up </A>]</TD>
 
1277
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_4.html#SEC108"> &gt;&gt; </A>]</TD>
 
1278
<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual.html#SEC_Top">Top</A>]</TD>
 
1279
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_toc.html#SEC_Contents">Contents</A>]</TD>
 
1280
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_12.html#SEC354">Index</A>]</TD>
 
1281
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_abt.html#SEC_About"> ? </A>]</TD>
 
1282
</TR></TABLE>
 
1283
<H3> setmargins </H3>
 
1284
<!--docid::SEC106::-->
 
1285
<P>
 
1286
 
 
1287
<TABLE><tr><td>&nbsp;</td><td class=example><pre>SETMARGINS vector
 
1288
</pre></td></tr></table></P><P>
 
1289
 
 
1290
command.  The input must be a list of two numbers, as for SETCURSOR.
 
1291
The effect is to clear the screen and then arrange for all further
 
1292
printing to be shifted down and to the right according to the indicated
 
1293
margins.  Specifically, every time a newline character is printed
 
1294
(explicitly or implicitly) Logo will type x_margin spaces, and on every
 
1295
invocation of SETCURSOR the margins will be added to the input x and y
 
1296
coordinates.  (CURSOR will report the cursor position relative to the
 
1297
margins, so that this shift will be invisible to Logo programs.)  The
 
1298
purpose of this command is to accommodate the display of terminal
 
1299
screens in lecture halls with inadequate TV monitors that miss the top
 
1300
and left edges of the screen.
 
1301
</P><P>
 
1302
 
 
1303
See section <A HREF="usermanual_3.html#SEC104">setcursor</A> .
 
1304
</P><P>
 
1305
 
 
1306
<A NAME="SETTEXTCOLOR"></A>
 
1307
<HR SIZE="6">
 
1308
<A NAME="SEC107"></A>
 
1309
<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
 
1310
<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC106"> &lt; </A>]</TD>
 
1311
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_4.html#SEC108"> &gt; </A>]</TD>
 
1312
<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC78"> &lt;&lt; </A>]</TD>
 
1313
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC101"> Up </A>]</TD>
 
1314
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_4.html#SEC108"> &gt;&gt; </A>]</TD>
 
1315
<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual.html#SEC_Top">Top</A>]</TD>
 
1316
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_toc.html#SEC_Contents">Contents</A>]</TD>
 
1317
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_12.html#SEC354">Index</A>]</TD>
 
1318
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_abt.html#SEC_About"> ? </A>]</TD>
 
1319
</TR></TABLE>
 
1320
<H3> settextcolor </H3>
 
1321
<!--docid::SEC107::-->
 
1322
<P>
 
1323
 
 
1324
<TABLE><tr><td>&nbsp;</td><td class=example><pre>SETTEXTCOLOR foreground background
 
1325
SETTC foreground background
 
1326
</pre></td></tr></table></P><P>
 
1327
 
 
1328
Command (Windows and DOS extended only).  The inputs are color numbers,
 
1329
as for turtle graphics.  Future printing to the text window will use the
 
1330
specified colors for foreground (the characters printed) and background
 
1331
(the space under those characters).  Using STANDOUT will revert to the
 
1332
default text window colors.  In the DOS extended (ucblogo.exe) version,
 
1333
colors in textscreen mode are limited to numbers 0-7, and the coloring
 
1334
applies only to text printed by the program, not to the echoing of text
 
1335
typed by the user.  Neither limitation applies to the text portion of
 
1336
splitscreen mode, which is actually drawn as graphics internally.
 
1337
</P><P>
 
1338
 
 
1339
See section <A HREF="usermanual_2.html#SEC63">standout</A> .
 
1340
</P><P>
 
1341
 
 
1342
<A NAME="ARITHMETIC"></A>
 
1343
<HR SIZE="6">
 
1344
<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
 
1345
<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_3.html#SEC78"> &lt;&lt; </A>]</TD>
 
1346
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_4.html#SEC108"> &gt;&gt; </A>]</TD>
 
1347
<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual.html#SEC_Top">Top</A>]</TD>
 
1348
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_toc.html#SEC_Contents">Contents</A>]</TD>
 
1349
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_12.html#SEC354">Index</A>]</TD>
 
1350
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="usermanual_abt.html#SEC_About"> ? </A>]</TD>
 
1351
</TR></TABLE>
 
1352
<BR>  
 
1353
<FONT SIZE="-1">
 
1354
This document was generated
 
1355
by <I>Brian Harvey</I> on <I>July, 24  2001</I>
 
1356
using <A HREF="http://www.mathematik.uni-kl.de/~obachman/Texi2html
 
1357
"><I>texi2html</I></A>
 
1358
 
 
1359
</BODY>
 
1360
</HTML>