include-file i*x fid -- j*x file ``include-file''
interpret (process using the text interpreter) the contents of the file fid.
included i*x addr u -- j*x file ``included''
include-file the file whose name is given by the string
addr u.
include ... "file" -- ... gforth ``include''
includes file
Usually you want to include a file only if it is not included already (by, say, another source file):
required i*x addr u -- j*x gforth ``required''
include the file with the name given by addr u, if it is not
included (or required) already. Currently this
works by comparing the name of the file (with path) against the
names of earlier included files.
require ... "file" -- ... gforth ``require''
includes file only if it is not included already
needs ... "name" -- ... gforth ``needs''
an alias for require; exists on other systems (e.g., Win32Forth).
I recommend that you write your source files such that interpreting them
does not change the stack. This allows using these files with
required and friends without complications. E.g.,
1 require foo.fs drop
Go to the first, previous, next, last section, table of contents.