environ.fs 4.44 KB
Newer Older
1 2
\ environmental queries

Anton Ertl's avatar
Anton Ertl committed
3
\ Copyright (C) 1995,1996,1997,1998,2000,2003,2007,2012,2015,2016,2017 Free Software Foundation, Inc.
anton's avatar
anton committed
4 5 6 7 8

\ This file is part of Gforth.

\ Gforth is free software; you can redistribute it and/or
\ modify it under the terms of the GNU General Public License
9
\ as published by the Free Software Foundation, either version 3
anton's avatar
anton committed
10 11 12 13 14 15 16 17
\ of the License, or (at your option) any later version.

\ This program is distributed in the hope that it will be useful,
\ but WITHOUT ANY WARRANTY; without even the implied warranty of
\ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
\ GNU General Public License for more details.

\ You should have received a copy of the GNU General Public License
18
\ along with this program. If not, see http://www.gnu.org/licenses/.
anton's avatar
anton committed
19

pazsan's avatar
pazsan committed
20 21 22
[IFUNDEF] cell/ : cell/ 1 cells / ; [THEN]
[IFUNDEF] float/ : float/ 1 floats / ; [THEN]

pazsan's avatar
pazsan committed
23 24
\ wordlist constant environment-wordlist

25 26 27 28 29 30 31 32 33
: (0s) ( n -- ) 0 +do '0' c, loop ;
: type, ( addr u -- ) here over allot swap move ;
: version-string>internal ( -- )
    version-string
    '.' $split 2swap 3 over - (0s) type, '.' c,
    '.' $split 2swap 3 over - (0s) type, '.' c,
    '_' $split 2swap 3 over - (0s) type, dup
    IF '_' c, type, ELSE 2drop THEN ;

anton's avatar
anton committed
34 35 36 37
vocabulary environment ( -- ) \ gforth
\ for win32forth compatibility

' environment >body constant environment-wordlist ( -- wid ) \ gforth
38
  \G @i{wid} identifies the word list that is searched by environmental
39
  \G queries.
anton's avatar
anton committed
40

41

42
: environment? ( c-addr u -- false / ... true ) \ core environment-query
43 44 45 46
    \G @i{c-addr, u} specify a counted string. If the string is not
    \G recognised, return a @code{false} flag. Otherwise return a
    \G @code{true} flag and some (string-specific) information about
    \G the queried string.
47 48 49 50 51 52
    environment-wordlist search-wordlist if
	execute true
    else
	false
    endif ;

jwilke's avatar
jwilke committed
53
: e? name environment? 0= ABORT" environmental dependency not existing" ;
jwilke's avatar
jwilke committed
54

55
: $has? environment? 0= IF false THEN ;
jwilke's avatar
jwilke committed
56

jwilke's avatar
jwilke committed
57 58
: has? name $has? ;

59 60 61 62 63 64 65
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.
66
8 constant ADDRESS-UNIT-BITS ( -- n ) \ environment
crook's avatar
crook committed
67
\G Size of one address unit, in bits.
68

69 70
1 ADDRESS-UNIT-BITS chars lshift 1- constant MAX-CHAR ( -- u ) \ environment
\G Maximum value of any character in the character set
71

72 73
MAX-CHAR constant /COUNTED-STRING ( -- n ) \ environment
\G Maximum size of a counted string, in characters.
74

75 76 77 78 79 80 81 82 83 84 85 86 87
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
anton's avatar
anton committed
88
\G True if @code{/} etc. perform floored division
89 90 91 92 93 94 95 96 97 98 99 100 101

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.

102 103
here version-string>internal here over -
2constant gforth ( -- c-addr u ) \ gforth-environment
anton's avatar
anton committed
104 105
\G Counted string representing a version string for this version of
\G Gforth (for versions>0.3.0).  The version strings of the various
anton's avatar
anton committed
106
\G versions are guaranteed to be ordered lexicographically.
pazsan's avatar
pazsan committed
107

108 109
: return-stack-cells ( -- n ) \ environment
    \G Maximum size of the return stack, in cells.
pazsan's avatar
pazsan committed
110
    [ forthstart 6 cells + ] literal @ cell/ ;
111

112 113
: stack-cells ( -- n ) \ environment
    \G Maximum size of the data stack, in cells.
pazsan's avatar
pazsan committed
114
    [ forthstart 4 cells + ] literal @ cell/ ;
115

116
: floating-stack ( -- n ) \ environment
crook's avatar
crook committed
117 118
    \G @var{n} is non-zero, showing that Gforth maintains a separate
    \G floating-point stack of depth @var{n}.
119
    [ forthstart 5 cells + ] literal @
pazsan's avatar
pazsan committed
120
    [IFDEF] float/  float/  [ELSE]  [ 1 floats ] Literal / [THEN] ;
121

122
16 constant #locals
123
    \ One local can take up to 64 bytes, the size of locals-buffer is 1000
Bernd Paysan's avatar
Bernd Paysan committed
124
$400 constant wordlists
125 126 127

forth definitions
previous
anton's avatar
anton committed
128