Annotation of gforth/kernel/io.fs, revision 1.31
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.31 ! pazsan 25: 0 Value infile-id ( -- file-id ) \ gforth
1.2 jwilke 26: 0 Value outfile-id ( -- file-id ) \ gforth
1.31 ! pazsan 27: 0 Value errfile-id ( -- file-id ) \ gforth
1.7 pazsan 28:
1.2 jwilke 29: : (type) ( c-addr u -- ) \ gforth
30: outfile-id write-file drop \ !! use ?DUP-IF THROW ENDIF instead of DROP ?
31: ;
32:
33: : (emit) ( c -- ) \ gforth
34: outfile-id emit-file drop \ !! use ?DUP-IF THROW ENDIF instead of DROP ?
35: ;
1.5 pazsan 36:
37: : (key) ( -- c ) \ gforth
38: infile-id key-file ;
39:
40: : (key?) ( -- flag ) \ gforth
41: infile-id key?-file ;
1.2 jwilke 42: [THEN]
43:
1.7 pazsan 44: undef-words
1.13 pazsan 45:
1.7 pazsan 46: Defer type ( c-addr u -- ) \ core
1.9 crook 47: \G If @var{u}>0, display @var{u} characters from a string starting
48: \G with the character stored at @var{c-addr}.
1.13 pazsan 49: [IFDEF] write-file
50: : (type) 0 write-file drop ;
51: [ELSE]
1.9 crook 52: : (type) BEGIN dup WHILE
53: >r dup c@ (emit) 1+ r> 1- REPEAT 2drop ;
1.13 pazsan 54: [THEN]
1.4 pazsan 55:
1.7 pazsan 56: [IFDEF] (type) ' (type) IS Type [THEN]
1.2 jwilke 57:
58: Defer emit ( c -- ) \ core
1.8 crook 59: \G Display the character associated with character value c.
1.7 pazsan 60: : (emit) ( c -- ) \ gforth
61: 0 emit-file drop \ !! use ?DUP-IF THROW ENDIF instead of DROP ?
62: ;
63:
64: [IFDEF] (emit) ' (emit) IS emit [THEN]
1.2 jwilke 65:
1.10 crook 66: Defer key ( -- char ) \ core
67: \G Receive (but do not display) one character, @var{char}.
1.28 pazsan 68: : (key) ( -- c ) \ gforth
69: infile-id key-file ;
70: : infile-id stdin ;
1.7 pazsan 71:
72: [IFDEF] (key) ' (key) IS key [THEN]
1.5 pazsan 73:
1.14 crook 74: Defer key? ( -- flag ) \ facility key-question
1.10 crook 75: \G Determine whether a character is available. If a character is
76: \G available, @var{flag} is true; the next call to @code{key} will
77: \G yield the character. Once @code{key?} returns true, subsequent
1.19 anton 78: \G calls to @code{key?} before calling @code{key} or @code{ekey} will
1.10 crook 79: \G also return true.
1.28 pazsan 80: : (key?) ( -- flag ) \ gforth
81: infile-id key?-file ;
82: : infile-id stdin ;
1.7 pazsan 83:
84: [IFDEF] (key?) ' (key?) IS key? [THEN]
85:
86: all-words
1.2 jwilke 87:
88: : (.") "lit count type ;
89: : (S") "lit count ;
90:
1.1 anton 91: \ Input 13feb93py
92:
1.25 pazsan 93: 04 constant #eof ( -- c ) \ gforth
1.1 anton 94: 07 constant #bell ( -- c ) \ gforth
95: 08 constant #bs ( -- c ) \ gforth
96: 09 constant #tab ( -- c ) \ gforth
97: 7F constant #del ( -- c ) \ gforth
98: 0D constant #cr ( -- c ) \ gforth
99: \ the newline key code
100: 0C constant #ff ( -- c ) \ gforth
101: 0A constant #lf ( -- c ) \ gforth
102:
1.3 jwilke 103: : bell #bell emit [ has? os [IF] ] outfile-id flush-file drop [ [THEN] ] ;
1.31 ! pazsan 104: Defer cr ( -- ) \ core c-r
1.17 anton 105: \G Output a newline (of the favourite kind of the host OS). Note
106: \G that due to the way the Forth command line interpreter inserts
107: \G newlines, the preferred way to use @code{cr} is at the start
108: \G of a piece of text; e.g., @code{cr ." hello, world"}.
1.31 ! pazsan 109: : (cr) ( -- )
1.17 anton 110: newline type ;
1.31 ! pazsan 111: ' (cr) IS cr
1.1 anton 112:
1.8 crook 113: : space ( -- ) \ core
114: \G Display one space.
115: bl emit ;
116:
1.27 pazsan 117: has? os 0= [IF]
1.8 crook 118: : spaces ( n -- ) \ core
119: \G If n > 0, display n spaces.
120: 0 max 0 ?DO space LOOP ;
1.7 pazsan 121: : backspaces 0 max 0 ?DO #bs emit LOOP ;
122: [ELSE]
1.1 anton 123: \ space spaces 21mar93py
124: decimal
125: Create spaces ( u -- ) \ core
1.18 anton 126: \G Display @var{n} spaces.
1.8 crook 127: bl 80 times \ times from target compiler! 11may93jaw
1.1 anton 128: DOES> ( u -- )
1.8 crook 129: swap
130: 0 max 0 ?DO I' I - &80 min 2dup type +LOOP drop ;
1.1 anton 131: Create backspaces
1.8 crook 132: 08 80 times \ times from target compiler! 11may93jaw
1.1 anton 133: DOES> ( u -- )
1.8 crook 134: swap
135: 0 max 0 ?DO I' I - &80 min 2dup type +LOOP drop ;
1.1 anton 136: hex
137: [THEN]
138:
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>