Annotation of gforth/kernel/io.fs, revision 1.30
1.1 anton 1: \ input output basics (extra since) 02mar97jaw
2:
1.29 anton 3: \ Copyright (C) 1995,1996,1997,1998,2000,2003,2006,2007 Free Software Foundation, Inc.
1.1 anton 4:
5: \ This file is part of Gforth.
6:
7: \ Gforth is free software; you can redistribute it and/or
8: \ modify it under the terms of the GNU General Public License
1.30 ! anton 9: \ as published by the Free Software Foundation, either version 3
1.1 anton 10: \ of the License, or (at your option) any later version.
11:
12: \ This program is distributed in the hope that it will be useful,
13: \ but WITHOUT ANY WARRANTY; without even the implied warranty of
14: \ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15: \ GNU General Public License for more details.
16:
17: \ You should have received a copy of the GNU General Public License
1.30 ! anton 18: \ along with this program. If not, see http://www.gnu.org/licenses/.
1.1 anton 19:
1.12 jwilke 20: require ./basics.fs
21:
1.2 jwilke 22: \ Output 13feb93py
23:
1.3 jwilke 24: has? os [IF]
1.2 jwilke 25: 0 Value outfile-id ( -- file-id ) \ gforth
1.5 pazsan 26: 0 Value infile-id ( -- file-id ) \ gforth
1.7 pazsan 27:
1.2 jwilke 28: : (type) ( c-addr u -- ) \ gforth
29: outfile-id write-file drop \ !! use ?DUP-IF THROW ENDIF instead of DROP ?
30: ;
31:
32: : (emit) ( c -- ) \ gforth
33: outfile-id emit-file drop \ !! use ?DUP-IF THROW ENDIF instead of DROP ?
34: ;
1.5 pazsan 35:
36: : (key) ( -- c ) \ gforth
37: infile-id key-file ;
38:
39: : (key?) ( -- flag ) \ gforth
40: infile-id key?-file ;
1.2 jwilke 41: [THEN]
42:
1.7 pazsan 43: undef-words
1.13 pazsan 44:
1.7 pazsan 45: Defer type ( c-addr u -- ) \ core
1.9 crook 46: \G If @var{u}>0, display @var{u} characters from a string starting
47: \G with the character stored at @var{c-addr}.
1.13 pazsan 48: [IFDEF] write-file
49: : (type) 0 write-file drop ;
50: [ELSE]
1.9 crook 51: : (type) BEGIN dup WHILE
52: >r dup c@ (emit) 1+ r> 1- REPEAT 2drop ;
1.13 pazsan 53: [THEN]
1.4 pazsan 54:
1.7 pazsan 55: [IFDEF] (type) ' (type) IS Type [THEN]
1.2 jwilke 56:
57: Defer emit ( c -- ) \ core
1.8 crook 58: \G Display the character associated with character value c.
1.7 pazsan 59: : (emit) ( c -- ) \ gforth
60: 0 emit-file drop \ !! use ?DUP-IF THROW ENDIF instead of DROP ?
61: ;
62:
63: [IFDEF] (emit) ' (emit) IS emit [THEN]
1.2 jwilke 64:
1.10 crook 65: Defer key ( -- char ) \ core
66: \G Receive (but do not display) one character, @var{char}.
1.28 pazsan 67: : (key) ( -- c ) \ gforth
68: infile-id key-file ;
69: : infile-id stdin ;
1.7 pazsan 70:
71: [IFDEF] (key) ' (key) IS key [THEN]
1.5 pazsan 72:
1.14 crook 73: Defer key? ( -- flag ) \ facility key-question
1.10 crook 74: \G Determine whether a character is available. If a character is
75: \G available, @var{flag} is true; the next call to @code{key} will
76: \G yield the character. Once @code{key?} returns true, subsequent
1.19 anton 77: \G calls to @code{key?} before calling @code{key} or @code{ekey} will
1.10 crook 78: \G also return true.
1.28 pazsan 79: : (key?) ( -- flag ) \ gforth
80: infile-id key?-file ;
81: : infile-id stdin ;
1.7 pazsan 82:
83: [IFDEF] (key?) ' (key?) IS key? [THEN]
84:
85: all-words
1.2 jwilke 86:
87: : (.") "lit count type ;
88: : (S") "lit count ;
89:
1.1 anton 90: \ Input 13feb93py
91:
1.25 pazsan 92: 04 constant #eof ( -- c ) \ gforth
1.1 anton 93: 07 constant #bell ( -- c ) \ gforth
94: 08 constant #bs ( -- c ) \ gforth
95: 09 constant #tab ( -- c ) \ gforth
96: 7F constant #del ( -- c ) \ gforth
97: 0D constant #cr ( -- c ) \ gforth
98: \ the newline key code
99: 0C constant #ff ( -- c ) \ gforth
100: 0A constant #lf ( -- c ) \ gforth
101:
1.3 jwilke 102: : bell #bell emit [ has? os [IF] ] outfile-id flush-file drop [ [THEN] ] ;
1.14 crook 103: : cr ( -- ) \ core c-r
1.17 anton 104: \G Output a newline (of the favourite kind of the host OS). Note
105: \G that due to the way the Forth command line interpreter inserts
106: \G newlines, the preferred way to use @code{cr} is at the start
107: \G of a piece of text; e.g., @code{cr ." hello, world"}.
108: newline type ;
1.1 anton 109:
1.8 crook 110: : space ( -- ) \ core
111: \G Display one space.
112: bl emit ;
113:
1.27 pazsan 114: has? os 0= [IF]
1.8 crook 115: : spaces ( n -- ) \ core
116: \G If n > 0, display n spaces.
117: 0 max 0 ?DO space LOOP ;
1.7 pazsan 118: : backspaces 0 max 0 ?DO #bs emit LOOP ;
119: [ELSE]
1.1 anton 120: \ space spaces 21mar93py
121: decimal
122: Create spaces ( u -- ) \ core
1.18 anton 123: \G Display @var{n} spaces.
1.8 crook 124: bl 80 times \ times from target compiler! 11may93jaw
1.1 anton 125: DOES> ( u -- )
1.8 crook 126: swap
127: 0 max 0 ?DO I' I - &80 min 2dup type +LOOP drop ;
1.1 anton 128: Create backspaces
1.8 crook 129: 08 80 times \ times from target compiler! 11may93jaw
1.1 anton 130: DOES> ( u -- )
1.8 crook 131: swap
132: 0 max 0 ?DO I' I - &80 min 2dup type +LOOP drop ;
1.1 anton 133: hex
134: [THEN]
135:
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>