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

3
\ Authors: Anton Ertl, Bernd Paysan, Jens Wilke, Neal Crook
Anton Ertl's avatar
Anton Ertl committed
4
\ Copyright (C) 1995,1996,1997,1998,2000,2003,2007,2012,2015,2016,2017 Free Software Foundation, Inc.
anton's avatar
anton committed
5 6 7 8 9

\ 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
10
\ as published by the Free Software Foundation, either version 3
anton's avatar
anton committed
11 12 13 14 15 16 17 18
\ 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
19
\ along with this program. If not, see http://www.gnu.org/licenses/.
anton's avatar
anton committed
20

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

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

26 27 28 29 30 31 32 33 34
: (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
35 36 37 38
vocabulary environment ( -- ) \ gforth
\ for win32forth compatibility

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

42

43
: environment? ( c-addr u -- false / ... true ) \ core environment-query
44 45 46 47
    \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.
48 49 50 51 52 53
    environment-wordlist search-wordlist if
	execute true
    else
	false
    endif ;

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

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

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

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

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

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

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

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.

103 104
here version-string>internal here over -
2constant gforth ( -- c-addr u ) \ gforth-environment
anton's avatar
anton committed
105 106
\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
107
\G versions are guaranteed to be ordered lexicographically.
pazsan's avatar
pazsan committed
108

109 110
: return-stack-cells ( -- n ) \ environment
    \G Maximum size of the return stack, in cells.
111
    [ forthstart 7 cells + ] literal @ cell/ ;
112

113 114
: stack-cells ( -- n ) \ environment
    \G Maximum size of the data stack, in cells.
115
    [ forthstart 5 cells + ] literal @ cell/ ;
116

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

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

forth definitions
previous
anton's avatar
anton committed
129