Diff for /gforth/environ.fs between versions 1.1 and 1.29

version 1.1, 1994/02/11 16:30:46 version 1.29, 2003/01/19 23:35:29
Line 1 Line 1
 \ ENVIRON.FS   Answer environmental queries            20may93jaw  \ environmental queries
   
 \ May be cross-compiled  \ Copyright (C) 1995-2003 Free Software Foundation, Inc.
   
 decimal  \ This file is part of Gforth.
   
 AVARIABLE EnvLink 0 EnvLink !  \ Gforth is free software; you can redistribute it and/or
   \ modify it under the terms of the GNU General Public License
   \ as published by the Free Software Foundation; either version 2
   \ of the License, or (at your option) any later version.
   
 : (env)  \ This program is distributed in the hope that it will be useful,
        EnvLink linked  \ but WITHOUT ANY WARRANTY; without even the implied warranty of
        dup c, here over chars allot swap move align  \ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
        , ;  \ GNU General Public License for more details.
   
 : (2env)  \ You should have received a copy of the GNU General Public License
        EnvLink linked  \ along with this program; if not, write to the Free Software
        dup $80 or  \ Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111, USA.
        c, here over chars allot swap move align  
        , , ;   \ wordlist constant environment-wordlist
   
 : env" ( n -- )  vocabulary environment ( -- ) \ gforth
        State @  \ for win32forth compatibility
        IF   postpone S" postpone (env)  
        ELSE [char] " parse (env) THEN ; immediate  ' environment >body constant environment-wordlist ( -- wid ) \ gforth
     \G @i{wid} identifies the word list that is searched by environmental
 : 2env" ( d -- )    \G queries.
        State @  
        IF   postpone S" postpone (2env)  
        ELSE [char] " parse (2env) THEN ; immediate  : environment? ( c-addr u -- false / ... true ) \ core environment-query
       \G @i{c-addr, u} specify a counted string. If the string is not
       \G recognised, return a @code{false} flag. Otherwise return a
 : environment?  EnvLink      \G @code{true} flag and some (string-specific) information about
                 BEGIN   @ dup      \G the queried string.
                 WHILE   dup cell+ count $1f and      environment-wordlist search-wordlist if
                         4 pick 4 pick compare 0=          execute true
                         IF      nip nip cell+ count dup -rot      else
                                 $1f and + aligned          false
                                 swap $80 and IF 2@ ELSE @ THEN      endif ;
                                 EXIT  
                         THEN  : e? name environment? 0= ABORT" environmental dependency not existing" ;
                 REPEAT  
                 drop 2drop false ;  : $has? environment? 0= IF false THEN ;
   
   : has? name $has? ;
   
   environment-wordlist set-current
   get-order environment-wordlist swap 1+ set-order
   
   \ assumes that chars, cells and doubles use an integral number of aus
   
   \ this should be computed in C as CHAR_BITS/sizeof(char),
   \ but I don't know any machine with gcc where an au does not have 8 bits.
   8 constant ADDRESS-UNIT-BITS ( -- n ) \ environment
   \G Size of one address unit, in bits.
   
   1 ADDRESS-UNIT-BITS chars lshift 1- constant MAX-CHAR ( -- u ) \ environment
   \G Maximum value of any character in the character set
   
   MAX-CHAR constant /COUNTED-STRING ( -- n ) \ environment
   \G Maximum size of a counted string, in characters.
   
   ADDRESS-UNIT-BITS cells 2* 2 + constant /HOLD ( -- n ) \ environment
   \G Size of the pictured numeric string output buffer, in characters.
   
   &84 constant /PAD ( -- n ) \ environment
   \G Size of the scratch area pointed to by @code{PAD}, in characters.
   
   true constant CORE ( -- f ) \ environment
   \G True if the complete core word set is present. Always true for Gforth.
   
   true constant CORE-EXT ( -- f ) \ environment
   \G True if the complete core extension word set is present. Always true for Gforth.
   
   1 -3 mod 0< constant FLOORED ( -- f ) \ environment
   \G True if @code{/} etc. perform floored division
   
   1 ADDRESS-UNIT-BITS cells 1- lshift 1- constant MAX-N ( -- n ) \ environment
   \G Largest usable signed integer.
   
   -1 constant MAX-U ( -- u ) \ environment
   \G Largest usable unsigned integer.
   
   -1 MAX-N 2constant MAX-D ( -- d ) \ environment
   \G Largest usable signed double.
   
   -1. 2constant MAX-UD ( -- ud ) \ environment
   \G Largest usable unsigned double.
   
   version-string 2constant gforth ( -- c-addr u ) \ gforth-environment
   \G Counted string representing a version string for this version of
   \G Gforth (for versions>0.3.0).  The version strings of the various
   \G versions are guaranteed to be ordered lexicographically.
   
   : return-stack-cells ( -- n ) \ environment
       \G Maximum size of the return stack, in cells.
       [ forthstart 6 cells + ] literal @ cell / ;
   
   : stack-cells ( -- n ) \ environment
       \G Maximum size of the data stack, in cells.
       [ forthstart 4 cells + ] literal @ cell / ;
   
   : floating-stack ( -- n ) \ environment
       \G @var{n} is non-zero, showing that Gforth maintains a separate
       \G floating-point stack of depth @var{n}.
       [ forthstart 5 cells + ] literal @
       [IFDEF] float  float  [ELSE]  [ 1 floats ] Literal [THEN] / ;
   
   15 constant #locals \ 1000 64 /
       \ One local can take up to 64 bytes, the size of locals-buffer is 1000
   maxvp constant wordlists
   
   forth definitions
   previous
   

Removed from v.1.1  
changed lines
  Added in v.1.29


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