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>