All loading of source files is achieved by load_files/2.
The hook
prolog_load_file/2
can be used to load Prolog code from non-files or even load entirely
different information, such as foreign files.
- prolog_load_file(+Spec,
+Options)
- Load a single object. If this call succeeds, load_files/2
assumes the action has been taken care of. This hook is only called if Options
does not contain the
stream(Input) option. The hook must be
defined in the module user.
This can be used to load from unusual places as well as dealing with
Prolog code that is not represented as a Prolog source text (for example
some binary representation). For example, library library(http/http_load)
loads Prolog directly from an HTTP server. See also
prolog:open_source_hook/3,
which merely allows for changing how a physical file is opened.
- prolog:open_source_hook(+Path,
-Stream, +Options)
- This hooks is called by the compiler to overrule the default open/3
call
open(Path, read, Stream). Options provide the
options as provided to load_files/2.
If the hook succeeds compilation continues by loading from the returned
(input) stream. This hook is particularly suited to support running the
code to a preprocessor. See also
prolog_load_file/2.
- This hook allows for processing comments encountered by the compiler. If
this hook is defined, the compiler calls read_term/2
with the option
comments(Comments). If the list of comments returned by
read_term/2
is not empty it calls this comment hook with the following arguments.
- Comments is the non-empty list of comments. Each comment
is a pair Position-String, where
String is a string object (see section
5.2) that contains the comment including delimiters.
Consecutive line comments are returned as a single comment.
- Pos is a stream-position term that describes the starting
position of Term
- Term is the term read.
This hook is exploited by the documentation system. See
stream_position_data/3.
See also read_term/3.
