Annotation of gforth/kernel/io.fs, revision 1.33
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.32 pazsan 27: 0 Value debug-fid ( -- 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:
1.33 ! pazsan 86: [IFDEF] (form) Defer form ' (form) IS form [THEN]
! 87:
1.7 pazsan 88: all-words
1.2 jwilke 89:
90: : (.") "lit count type ;
91: : (S") "lit count ;
92:
1.1 anton 93: \ Input 13feb93py
94:
1.25 pazsan 95: 04 constant #eof ( -- c ) \ gforth
1.1 anton 96: 07 constant #bell ( -- c ) \ gforth
97: 08 constant #bs ( -- c ) \ gforth
98: 09 constant #tab ( -- c ) \ gforth
99: 7F constant #del ( -- c ) \ gforth
100: 0D constant #cr ( -- c ) \ gforth
101: \ the newline key code
102: 0C constant #ff ( -- c ) \ gforth
103: 0A constant #lf ( -- c ) \ gforth
104:
1.3 jwilke 105: : bell #bell emit [ has? os [IF] ] outfile-id flush-file drop [ [THEN] ] ;
1.31 pazsan 106: Defer cr ( -- ) \ core c-r
1.17 anton 107: \G Output a newline (of the favourite kind of the host OS). Note
108: \G that due to the way the Forth command line interpreter inserts
109: \G newlines, the preferred way to use @code{cr} is at the start
110: \G of a piece of text; e.g., @code{cr ." hello, world"}.
1.31 pazsan 111: : (cr) ( -- )
1.17 anton 112: newline type ;
1.31 pazsan 113: ' (cr) IS cr
1.1 anton 114:
1.8 crook 115: : space ( -- ) \ core
116: \G Display one space.
117: bl emit ;
118:
1.27 pazsan 119: has? os 0= [IF]
1.8 crook 120: : spaces ( n -- ) \ core
121: \G If n > 0, display n spaces.
122: 0 max 0 ?DO space LOOP ;
1.7 pazsan 123: : backspaces 0 max 0 ?DO #bs emit LOOP ;
124: [ELSE]
1.1 anton 125: \ space spaces 21mar93py
126: decimal
127: Create spaces ( u -- ) \ core
1.18 anton 128: \G Display @var{n} spaces.
1.8 crook 129: bl 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: Create backspaces
1.8 crook 134: 08 80 times \ times from target compiler! 11may93jaw
1.1 anton 135: DOES> ( u -- )
1.8 crook 136: swap
137: 0 max 0 ?DO I' I - &80 min 2dup type +LOOP drop ;
1.1 anton 138: hex
139: [THEN]
140:
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>