Annotation of gforth/kernel/nio.fs, revision 1.15

1.1       anton       1: \ Number IO
                      2: 
1.14      anton       3: \ Copyright (C) 1995,1996,1997,1998,2000 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
                      9: \ as published by the Free Software Foundation; either version 2
                     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
                     18: \ along with this program; if not, write to the Free Software
1.15    ! anton      19: \ Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111, USA.
1.1       anton      20: 
1.11      jwilke     21: require ./io.fs
                     22: 
1.10      crook      23: : pad    ( -- c-addr ) \ core-ext
                     24:     \G @var{c-addr} is the address of a transient region that can be
                     25:     \G used as temporary data storage. At least 84 characters of space
                     26:     \G is available.
1.3       pazsan     27:     here word-pno-size + aligned ;
1.1       anton      28: 
                     29: \ hold <# #> sign # #s                                 25jan92py
                     30: 
                     31: : hold    ( char -- ) \ core
1.10      crook      32:     \G Used within @code{<#} and @code{#>}. Append the character
                     33:     \G @var{char} to the pictured numeric output string.
1.6       anton      34:     -1 chars holdptr +!
                     35:     holdptr @ dup holdbuf u< -&17 and throw
                     36:     c! ;
1.1       anton      37: 
                     38: : <# ( -- ) \ core     less-number-sign
1.5       crook      39:     \G Initialise/clear the pictured numeric output string.
1.7       anton      40:     holdbuf-end dup holdptr ! holdend ! ;
1.1       anton      41: 
                     42: : #>      ( xd -- addr u ) \ core      number-sign-greater
1.13      crook      43:     \G Complete the pictured numeric output string by discarding
                     44:     \G @var{xd} and returning @var{addr u}; the address and length of
                     45:     \G the formatted string. A Standard program may modify characters
1.5       crook      46:     \G within the string.
1.7       anton      47:     2drop holdptr @ holdend @ over - ;
1.6       anton      48: 
1.7       anton      49: : <<# ( -- ) \ gforth  less-less-number-sign
1.9       crook      50:     \G Start a hold area that ends with @code{#>>}. Can be nested in
1.6       anton      51:     \G each other and in @code{<#}.  Note: if you do not match up the
                     52:     \G @code{<<#}s with @code{#>>}s, you will eventually run out of
                     53:     \G hold area; you can reset the hold area to empty with @code{<#}.
1.7       anton      54:     holdend @ holdptr @ - hold
                     55:     holdptr @ holdend ! ;
1.6       anton      56: 
1.7       anton      57: : #>> ( -- ) \ gforth  number-sign-greater-greater
1.9       crook      58:     \G Release the hold area started with @code{<<#}.
1.8       anton      59:     holdend @ dup holdbuf-end u>= -&11 and throw
                     60:     count chars bounds holdptr ! holdend ! ;
1.1       anton      61: 
                     62: : sign    ( n -- ) \ core
1.13      crook      63:     \G Used within @code{<#} and @code{#>}. If @var{n} (a @var{single}
                     64:     \G number) is negative, append the display code for a minus sign
                     65:     \G to the pictured numeric output string. Since the string is
                     66:     \G built up ``backwards'' this is usually used immediately prior
                     67:     \G to @code{#>}, as shown in the examples below.
1.1       anton      68:     0< IF  [char] - hold  THEN ;
                     69: 
                     70: : #       ( ud1 -- ud2 ) \ core                number-sign
1.13      crook      71:     \G Used within @code{<#} and @code{#>}. Add the next
                     72:     \G least-significant digit to the pictured numeric output
                     73:     \G string. This is achieved by dividing @var{ud1} by the number in
                     74:     \G @code{base} to leave quotient @var{ud2} and remainder @var{n};
                     75:     \G @var{n} is converted to the appropriate display code (eg ASCII
                     76:     \G code) and appended to the string. If the number has been fully
                     77:     \G converted, @var{ud1} will be 0 and @code{#} will append a ``0''
                     78:     \G to the string.
1.12      anton      79:     base @ ud/mod rot 9 over <
1.1       anton      80:     IF
                     81:        [ char A char 9 - 1- ] Literal +
                     82:     THEN
                     83:     [char] 0 + hold ;
                     84: 
1.5       crook      85: : #s      ( ud -- 0 0 ) \ core number-sign-s
                     86:     \G Used within @code{<#} and @code{#>}. Convert all remaining digits
                     87:     \G using the same algorithm as for @code{#}. @code{#s} will convert
1.13      crook      88:     \G at least one digit. Therefore, if @var{ud} is 0, @code{#s} will append
                     89:     \G a ``0'' to the pictured numeric output string.
1.1       anton      90:     BEGIN
                     91:        # 2dup or 0=
                     92:     UNTIL ;
                     93: 
                     94: \ print numbers                                        07jun92py
                     95: 
                     96: : d.r ( d n -- ) \ double      d-dot-r
1.9       crook      97:     \G Display @var{d} right-aligned in a field @var{n} characters wide. If more than
                     98:     \G @var{n} characters are needed to display the number, all digits are displayed.
1.13      crook      99:     \G If appropriate, @var{n} must include a character for a leading ``-''.
1.7       anton     100:     >r tuck  dabs  <<# #s  rot sign #>
                    101:     r> over - spaces  type #>> ;
1.1       anton     102: 
                    103: : ud.r ( ud n -- ) \ gforth    u-d-dot-r
1.9       crook     104:     \G Display @var{ud} right-aligned in a field @var{n} characters wide. If more than
                    105:     \G @var{n} characters are needed to display the number, all digits are displayed.
1.7       anton     106:     >r <<# #s #> r> over - spaces type #>> ;
1.1       anton     107: 
                    108: : .r ( n1 n2 -- ) \ core-ext   dot-r
1.9       crook     109:     \G Display @var{n1} right-aligned in a field @var{n2} characters wide. If more than
                    110:     \G @var{n2} characters are needed to display the number, all digits are displayed.
1.13      crook     111:     \G If appropriate, @var{n2} must include a character for a leading ``-''.
1.1       anton     112:     >r s>d r> d.r ;
1.5       crook     113: 
1.1       anton     114: : u.r ( u n -- )  \ core-ext   u-dot-r
1.9       crook     115:     \G Display @var{u} right-aligned in a field @var{n} characters wide. If more than
                    116:     \G @var{n} characters are needed to display the number, all digits are displayed.
1.1       anton     117:     0 swap ud.r ;
                    118: 
                    119: : d. ( d -- ) \ double d-dot
1.9       crook     120:     \G Display (the signed double number) @var{d} in free-format. followed by a space.
1.1       anton     121:     0 d.r space ;
1.5       crook     122: 
1.1       anton     123: : ud. ( ud -- ) \ gforth       u-d-dot
1.9       crook     124:     \G Display (the signed double number) @var{ud} in free-format, followed by a space.
1.1       anton     125:     0 ud.r space ;
                    126: 
                    127: : . ( n -- ) \ core    dot
1.9       crook     128:     \G Display (the signed single number) @var{n} in free-format, followed by a space.
1.1       anton     129:     s>d d. ;
1.5       crook     130: 
1.1       anton     131: : u. ( u -- ) \ core   u-dot
1.9       crook     132:     \G Display (the unsigned single number) @var{u} in free-format, followed by a space.
1.1       anton     133:     0 ud. ;
                    134: 

FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>