docsc
parent
56905d86ae
commit
8d1cc35a8a
|
@ -203,3 +203,5 @@ packages/python/yap_kernel/x/__init__.py
|
|||
packages/python/yap_kernel/x/__main__.py
|
||||
|
||||
*.gch
|
||||
mxe
|
||||
build
|
||||
|
|
|
@ -28,10 +28,11 @@ static char SccsId[] = "%W% %G%";
|
|||
#define NULL (void *)0
|
||||
#endif
|
||||
|
||||
/** @{ */
|
||||
/** @file attvars.c
|
||||
@{ */
|
||||
|
||||
/** @defgroup AttributeVariables_Builtins Implementation of Attribute
|
||||
Declarations
|
||||
/**
|
||||
* @defgroup AttributeVariables_Builtins Implementation of Attribute Declarations
|
||||
@ingroup AttributeVariables
|
||||
*/
|
||||
|
||||
|
|
|
@ -1,4 +1,5 @@
|
|||
|
||||
Prolog Commons {#prolog_commons}
|
||||
=============
|
||||
This directory should hold files from the Prolog Commons
|
||||
project. Please see
|
||||
|
||||
|
|
25
README.md
25
README.md
|
@ -3,12 +3,12 @@
|
|||

|
||||
</center>
|
||||
|
||||
README for YAP6
|
||||
User Manual for YAP6 (#main)
|
||||
====================
|
||||
|
||||
NOTE: this version of YAP is stil experimental, documentation may be out of date.
|
||||
NOTE: this version of YAP is still experimental, documentation may be out of date.
|
||||
|
||||
## Introduction
|
||||
## Introduction
|
||||
|
||||
This document provides User information on version 6.3.4 of
|
||||
YAP (<em>Yet Another Prolog</em>). The YAP Prolog System is a
|
||||
|
@ -94,22 +94,3 @@ DTAI group of KULeuven.
|
|||
|
||||
+ The [R](http://stoics.org.uk/~nicos/sware/packs/real/) interface package developed by Nicos Angelopoulos,
|
||||
Vítor Santos Costa, João Azevedo, Jan Wielemaker, and Rui Camacho.
|
||||
|
||||
|
||||
Downloading YAP {#download}
|
||||
==============
|
||||
|
||||
The latest development version of Yap-6 is yap-6.3.4 and can be
|
||||
obtained from the repositories
|
||||
|
||||
<http://sourceforge.net/p/yap/yap-6.3>
|
||||
|
||||
and
|
||||
|
||||
<https://github.com/vscosta/yap-6.3>
|
||||
|
||||
YAP-6.3.4 does not use modules. Please just use `git clone` to obtain the distribution.
|
||||
|
||||
Most of these repositories are basically copies of the original
|
||||
repositories at the SWI-Prolog site. YAP-6 will work either with or
|
||||
without these packages.
|
||||
|
|
|
@ -785,9 +785,8 @@ INPUT = /Users/vsc/git/yap-6.3/pl \
|
|||
/Users/vsc/git/yap-6.3/library \
|
||||
/Users/vsc/git/yap-6.3/packages \
|
||||
/Users/vsc/git/yap-6.3/swi/library \
|
||||
/Users/vsc/git/yap-6.3/docs/yap.md \
|
||||
/Users/vsc/git/yap-6.3/docs/chr.md \
|
||||
/Users/vsc/git/yap-6.3/docs/clpqr.md \
|
||||
/Users/vsc/git/yap-6.3/docs/*.md \
|
||||
/Users/vsc/git/yap-6.3/*.md \
|
||||
|
||||
|
||||
# This tag can be used to specify the character encoding of the source files
|
||||
|
@ -937,7 +936,7 @@ FILTER_SOURCE_PATTERNS =
|
|||
# (index.html). This can be useful if you have a project on for instance GitHub
|
||||
# and want to reuse the introduction page also for the doxygen output.
|
||||
|
||||
USE_MDFILE_AS_MAINPAGE =
|
||||
USE_MDFILE_AS_MAINPAGE =
|
||||
|
||||
#---------------------------------------------------------------------------
|
||||
# Configuration options related to source browsing
|
||||
|
|
|
@ -785,9 +785,8 @@ INPUT = @PROJECT_SOURCE_DIR@/pl \
|
|||
@PROJECT_SOURCE_DIR@/library \
|
||||
@PROJECT_SOURCE_DIR@/packages \
|
||||
@PROJECT_SOURCE_DIR@/swi/library \
|
||||
@PROJECT_SOURCE_DIR@/docs/yap.md \
|
||||
@PROJECT_SOURCE_DIR@/docs/chr.md \
|
||||
@PROJECT_SOURCE_DIR@/docs/clpqr.md \
|
||||
@PROJECT_SOURCE_DIR@/docs/*.md \
|
||||
@PROJECT_SOURCE_DIR@/*.md
|
||||
|
||||
|
||||
# This tag can be used to specify the character encoding of the source files
|
||||
|
|
|
@ -0,0 +1,31 @@
|
|||
YAP Built-ins {#builtins}
|
||||
=================
|
||||
|
||||
This chapter describes the core predicates that control the execution of
|
||||
Prolog programs, provide fundamental functionality such as termm manipulation or arithmetic, and support interaction with external
|
||||
resources, Many of the predicates described here have been standardised by the ISO. The standartised subset of Proloh also known as ISO-Prolog.
|
||||
|
||||
In the description of the arguments of functors the following notation
|
||||
will be used:
|
||||
|
||||
+ a preceding plus sign will denote an argument as an "input
|
||||
argument" - it cannot be a free variable at the time of the call;
|
||||
+ a preceding minus sign will denote an "output argument";
|
||||
+ an argument with no preceding symbol can be used in both ways.
|
||||
+ @ref YAPControl
|
||||
|
||||
+ @ref Arithmetic
|
||||
|
||||
+ @ref YAPChars
|
||||
|
||||
+ @ref YAP_Terms
|
||||
|
||||
+ @ref InputOutput
|
||||
|
||||
+ @ref AbsoluteFileName
|
||||
|
||||
+ @ref YAPOS
|
||||
|
||||
+ @ref Internal_Database
|
||||
|
||||
+ @ref Sets
|
|
@ -0,0 +1,17 @@
|
|||
Downloading YAP {#download}
|
||||
==============
|
||||
|
||||
The latest development version of Yap-6 is yap-6.3.4 and can be
|
||||
obtained from the repositories
|
||||
|
||||
<http://sourceforge.net/p/yap/yap-6.3>
|
||||
|
||||
and
|
||||
|
||||
<https://github.com/vscosta/yap-6.3>
|
||||
|
||||
YAP-6.3.4 does not use modules. Please just use `git clone` to obtain the distribution.
|
||||
|
||||
Most of these repositories are basically copies of the original
|
||||
repositories at the SWI-Prolog site. YAP-6 will work either with or
|
||||
without these packages.
|
|
@ -0,0 +1,21 @@
|
|||
Extensions to core Prolog. {#extensions}
|
||||
=========================
|
||||
|
||||
YAP includes a number of extensions over the original Prolog
|
||||
language. Next, we discuss how to use the most important ones.
|
||||
|
||||
+ @ref Rational_Trees
|
||||
|
||||
+ @ref AttributedVariables
|
||||
|
||||
+ @ref DepthLimited
|
||||
|
||||
+ @ref Tabling
|
||||
|
||||
+ @ref Threads
|
||||
|
||||
+ @ref Profiling
|
||||
|
||||
+ @ref YAPArrays
|
||||
|
||||
+ @ref Parallelism
|
16
docs/fli.md
16
docs/fli.md
|
@ -0,0 +1,16 @@
|
|||
The Foreign Code Interface {#fli}
|
||||
===========================
|
||||
|
||||
YAP provides the user with three facilities for writing
|
||||
predicates in a language other than Prolog. Under Unix systems,
|
||||
most language implementations were linkable to `C`, and the first interface exported the YAP machinery to the C language. YAP also implements most of the SWI-Prolog foreign language interface.
|
||||
This gives portability with a number of SWI-Prolog packages and avoids garnage collection by using @ref slotInterface. Last, a new C++ based interface is
|
||||
being designed to work with the swig (www.swig.orgv) interface compiler.
|
||||
|
||||
+ The @ref c-interface exports the YAP engine.
|
||||
|
||||
+ The @ref swi-c-interface emulates Jan Wielemaker's SWI foreign language interface.
|
||||
|
||||
+ The @ref yap-cplus-interface is desiged to interface with the SWIG package by using Object-Oriented concepts
|
||||
|
||||
+ The @ref LoadInterface handles the setup of foreign files
|
|
@ -0,0 +1,58 @@
|
|||
The YAP Library (#library)
|
||||
==============
|
||||
|
||||
Library files reside in the library_directory path (set by the
|
||||
`LIBDIR` variable in the Makefile for YAP). Several files in the
|
||||
library are originally from the public-domain Edinburgh Prolog library.
|
||||
|
||||
- @ref apply
|
||||
- @ref apply_macros
|
||||
- @ref arg
|
||||
- @ref Association_Lists
|
||||
- @ref avl
|
||||
- @ref bhash
|
||||
- @ref block_diagram
|
||||
- @ref c_alarms
|
||||
- @ref charsio
|
||||
- @ref clauses
|
||||
- @ref cleanup
|
||||
- @ref dbqueues
|
||||
- @ref dbusage
|
||||
- @ref dgraphs
|
||||
- @ref exo_interval
|
||||
- @ref flags
|
||||
- @ref gensym
|
||||
- @ref yap_hacks
|
||||
- @ref heaps
|
||||
- @ref lam_mpi
|
||||
- @ref line_utils
|
||||
- @ref swi_listing
|
||||
- @ref lists
|
||||
- @ref mapargs
|
||||
- @ref maplist
|
||||
- @ref matlab
|
||||
- @ref matrix
|
||||
- @ref nb
|
||||
- @ref Ordered_Sets
|
||||
- @ref parameters
|
||||
- @ref queues
|
||||
- @ref random
|
||||
- @ref Pseudo_Random
|
||||
- @ref rbtrees
|
||||
- @ref regexp
|
||||
- @ref rltrees
|
||||
- @ref Splay_Trees
|
||||
- @ref operating_system_support,
|
||||
- @ref Terms
|
||||
- @ref timeout
|
||||
- @ref trees
|
||||
- @ref tries
|
||||
- @ref ugraphs
|
||||
- @ref undgraphs
|
||||
- @ref varnumbers
|
||||
- @ref wdgraphs
|
||||
- @ref wdgraphs
|
||||
- @ref wdgraphs
|
||||
- @ref wgraphs
|
||||
- @ref wundgraphs
|
||||
- @ref ypp
|
|
@ -0,0 +1,11 @@
|
|||
Loading and Oganising YAP Programs {#consult}
|
||||
===================================
|
||||
|
||||
Next, we present the main predicates and directives available to load
|
||||
files and to control the Prolog environment.
|
||||
|
||||
+ @ref YAPConsulting
|
||||
|
||||
+ @subpage YAPModules
|
||||
|
||||
+ @ref YAPSaving
|
|
@ -0,0 +1,28 @@
|
|||
YAP packages files {#packages}
|
||||
===================
|
||||
|
||||
+ @subpage real
|
||||
|
||||
+ @ref BDDs
|
||||
|
||||
+ @subpage ecode
|
||||
|
||||
+ @subpage myddas
|
||||
|
||||
+ @ref PFL/CLP(BN)
|
||||
|
||||
+ @ref ProbLog1
|
||||
|
||||
+ @ref Python
|
||||
|
||||
+ @subpage YAPRaptor
|
||||
|
||||
+ @ref YAP-LBFGS
|
||||
|
||||
+ @subpage yap-udi-indexers
|
||||
|
||||
Leuven packages ported from SWI-Prolog:
|
||||
|
||||
+ @subpage chr
|
||||
|
||||
+ @subpage clpqr
|
19
docs/run.md
19
docs/run.md
|
@ -1,4 +1,4 @@
|
|||
Running YAP
|
||||
Running YAP {#run}
|
||||
===========
|
||||
|
||||
We next describe how to invoke YAP in Unix systems.
|
||||
|
@ -24,7 +24,7 @@ specify <tt>M</tt> bytes.
|
|||
allocate _Size_ KBytes for heap and auxiliary stacks
|
||||
+ -t _Size_
|
||||
allocate _Size_ KBytes for the trail stack
|
||||
+ -L _Size_
|
||||
+ -L _Size_
|
||||
SWI-compatible option to allocate _Size_ K bytes for local and global stacks, the local stack
|
||||
cannot be expanded. To avoid confusion with the load option, _Size_
|
||||
must immediately follow the letter `L`.
|
||||
|
@ -62,34 +62,34 @@ through the unix/1 built-in predicate.
|
|||
|
||||
Note that YAP will output an error message on the following conditions:
|
||||
|
||||
+
|
||||
+
|
||||
a file name was given but the file does not exist or is not a saved
|
||||
YAP state;
|
||||
|
||||
+
|
||||
+
|
||||
the necessary amount of memory could not be allocated;
|
||||
|
||||
+
|
||||
+
|
||||
the allocated memory is not enough to restore the state.
|
||||
|
||||
|
||||
|
||||
When restoring a saved state, YAP will allocate the
|
||||
same amount of memory as that in use when the state was saved, unless a
|
||||
different amount is specified by flags in the command line. By default,
|
||||
YAP restores the file startup.yss from the current directory or from
|
||||
the YAP library.
|
||||
|
||||
+
|
||||
+
|
||||
YAP usually boots from a saved state. The saved state will use the default
|
||||
installation directory to search for the YAP binary unless you define
|
||||
the environment variable YAPBINDIR.
|
||||
|
||||
+
|
||||
+
|
||||
YAP always tries to find saved states from the current directory
|
||||
first. If it cannot it will use the environment variable YAPLIBDIR, if
|
||||
defined, or search the default library directory.
|
||||
|
||||
+
|
||||
+
|
||||
YAP will try to find library files from the YAPSHAREDIR/library
|
||||
directory.
|
||||
|
||||
|
@ -188,4 +188,3 @@ they must be sent directly to the argv built-in. Hence, running
|
|||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
will write `test` on the standard output.
|
||||
|
||||
|
|
182
docs/swi.md
182
docs/swi.md
|
@ -0,0 +1,182 @@
|
|||
Compatibility with other Prolog systems {#swi}
|
||||
=======================================
|
||||
|
||||
YAP has been designed to be as compatible as possible with other
|
||||
Prolog systems, originally with C-Prolog\cite x and SICStus
|
||||
Prolog~\cite x . More recent work on YAP has striven at making YAP
|
||||
compatible with the ISO-Prolog standard\cite x , and with Jan
|
||||
Wielemaker's SWI-Prolog\cite x .
|
||||
|
||||
SWI-Prolog and YAP have collaborated at improved compatibility \cite x . This
|
||||
resulted in Prolog extensions such as the `dialect` feature. YAP
|
||||
currently supports most of the SWI-Prolog foreign interface. The following SWI
|
||||
libraries have been adapted to YAP:
|
||||
|
||||
+ @ref aggregate
|
||||
+ @ref base64
|
||||
+ @ref broadcast
|
||||
+ @ref ctypes
|
||||
+ @ref date
|
||||
+ @ref prolog_debug
|
||||
+ @ref prolog_edit
|
||||
+ @ref error
|
||||
+ @ref nb_set
|
||||
+ @ref prolog_operator
|
||||
+ @ref swi_option
|
||||
+ @ref pairs
|
||||
+ @ref pio
|
||||
+ @ref predicate_options,
|
||||
+ @ref predopts
|
||||
+ @ref prolog_clause
|
||||
+ @ref prolog_colour
|
||||
+ @ref prolog_source
|
||||
+ @ref prolog_xref
|
||||
+ @ref pure_input
|
||||
+ @ref quasi_quotations
|
||||
+ @ref read_util
|
||||
+ @ref record
|
||||
+ @ref settings
|
||||
+ @ref shlib
|
||||
+ @ref thread_pool
|
||||
+ @ref url
|
||||
+ @ref utf8
|
||||
+ @ref win_menu
|
||||
+ @ref www_browser
|
||||
|
||||
|
||||
Note that in general SWI code may be from an earlier version than the
|
||||
one available with SWI-Prolog. SWI-Prolog are obviously not
|
||||
responsible for any incompatibilities and/or bugs in the YAP port.
|
||||
|
||||
Please do refer to the SWI-Prolog home page:
|
||||
|
||||
<http://www.swi-prolog.org>
|
||||
|
||||
for more information on SWI-Prolog and the SWI packages.
|
||||
|
||||
Compatibility with the C-Prolog interpreter {#ChYProlog}
|
||||
-------------------------------------------
|
||||
|
||||
YAP was designed so that most C-Prolog programs should run under YAP
|
||||
without changes.
|
||||
The most important difference between YAP and C-Prolog is that, being
|
||||
YAP a compiler, some changes should be made if predicates such as
|
||||
assert/1, clause/1 and retract/1 are used. First
|
||||
predicates which will change during execution should be declared as
|
||||
`dynamic` by using commands like:
|
||||
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
:- dynamic f/n.
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
where `f` is the predicate name and n is the arity of the
|
||||
predicate. Note that several such predicates can be declared in a
|
||||
single command:
|
||||
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
:- dynamic f/2, ..., g/1.
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
Primitive predicates such as `retract` apply only to dynamic
|
||||
predicates. Finally note that not all the C-Prolog primitive predicates
|
||||
are implemented in YAP. They can easily be detected using the
|
||||
`unknown` system predicate provided by YAP.
|
||||
|
||||
Last, by default YAP enables character escapes in strings. You can
|
||||
disable the special interpretation for the escape character by using:
|
||||
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
:- yap_flag(character_escapes,off).
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
or by using:
|
||||
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
:- yap_flag(language,cprolog).
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
|
||||
Compatibility with the Quintus and SICStus Prolog systems
|
||||
---------------------------------------------------------
|
||||
|
||||
The Quintus Prolog system was the first Prolog compiler to use Warren's
|
||||
Abstract Machine. This system was very influential in the Prolog
|
||||
community. Quintus Prolog implemented compilation into an abstract
|
||||
machine code, which was then emulated. Quintus Prolog also included
|
||||
several new built-ins, an extensive library, and in later releases a
|
||||
garbage collector. The SICStus Prolog system, developed at SICS (Swedish
|
||||
Institute of Computer Science), is an emulator based Prolog system
|
||||
largely compatible with Quintus Prolog. SICStus Prolog has evolved
|
||||
through several versions. The current version includes several
|
||||
extensions, such as an object implementation, co-routining, and
|
||||
constraints.
|
||||
|
||||
Both YAP and SICStus Prolog obey the Edinburgh Syntax and are based on
|
||||
the WAM. Even so, there are major important differences:
|
||||
|
||||
+ Differently from SICStus Prolog, both consulted and dynamic code in YAP
|
||||
are compiled, not interpreted. All code in YAP is compiled.
|
||||
|
||||
+ The following SICStus Prolog v3 built-ins are not (currently)
|
||||
implemented in YAP (note that this is only a partial list):
|
||||
stream_interrupt/3, reinitialize/0, help/0, help/1,
|
||||
trimcore/0, and require/1.
|
||||
|
||||
+ The consult/1 predicate in YAP follows C-Prolog
|
||||
semantics. That is, it adds clauses to the data base, even for
|
||||
preexisting procedures. This is different from consult/1 in
|
||||
SICStus Prolog or SWI-Prolog.
|
||||
|
||||
+ This list is incomplete.
|
||||
|
||||
Compatibility with the ISO Prolog standard
|
||||
------------------------------------------
|
||||
|
||||
The Prolog standard was developed by ISO/IEC JTC1/SC22/WG17, the
|
||||
international standardization working group for the programming language
|
||||
Prolog. The book "Prolog: The Standard" by Deransart, Ed-Dbali and
|
||||
Cervoni gives a complete description of this standard. Development in
|
||||
YAP from YAP4.1.6 onwards have striven at making YAP
|
||||
compatible with ISO Prolog. As such:
|
||||
|
||||
+ YAP now supports all of the built-ins required by the
|
||||
ISO-standard, and,
|
||||
+ Error-handling is as required by the standard.
|
||||
|
||||
|
||||
YAP by default is not fully ISO standard compliant. You can set the
|
||||
language flag to `iso` to obtain better
|
||||
compatibility. Setting this flag changes the following:
|
||||
|
||||
|
||||
+ By default, YAP implements the
|
||||
atom_chars/2 (see Testing Terms), and
|
||||
number_chars/2, (see Testing Terms),
|
||||
built-ins as per the original Quintus Prolog definition, and
|
||||
not as per the ISO definition.
|
||||
|
||||
Calling `set_prolog_flag(to_chars_mode,iso)` will switch
|
||||
YAP to use the ISO definition for
|
||||
atom_chars/2 and number_chars/2.
|
||||
|
||||
+ By default, YAP allows executable goals in directives. In ISO mode
|
||||
most directives can only be called from top level (the exceptions are
|
||||
set_prolog_flag/2 and op/3).
|
||||
|
||||
+ Error checking for meta-calls under ISO Prolog mode is stricter
|
||||
than by default.
|
||||
|
||||
+ The strict_iso flag automatically enables the ISO Prolog
|
||||
standard. This feature should disable all features not present in the
|
||||
standard.
|
||||
|
||||
The following incompatibilities between YAP and the ISO standard are
|
||||
known to still exist (please check Ulrich Neumerkel's page for more details):
|
||||
|
||||
<ul>
|
||||
|
||||
<li>Currently, YAP does not handle overflow errors in integer
|
||||
operations, and handles floating-point errors only in some
|
||||
architectures. Otherwise, YAP follows IEEE arithmetic.
|
||||
|
||||
Please inform the authors on other incompatibilities that may still
|
||||
exist.
|
|
@ -1,6 +1,5 @@
|
|||
|
||||
|
||||
@file syntax.md
|
||||
YAP Syntax (#YAPSyntax)
|
||||
============
|
||||
|
||||
@defgroup YAPSyntax YAP Syntax
|
||||
@ingroup mainpage
|
||||
|
@ -198,11 +197,11 @@ YAP supports four different textual elements:
|
|||
data-base. They are stored either in ISO-LATIN-1 (first 256 code points), or as UTF-32.
|
||||
|
||||
+ Strings are atomic representations of text. The back-quote character is used to identify these objects in the program. Strings exist as stack objects, in the same way as other Prolog terms. As Prolog unification cannot be used to manipulate strings, YAP includes built-ins such as string_arg/3, sub_string/5, or string_concat to manipulate them efficiently. Strings are stored as opaque objects containing a
|
||||
|
||||
|
||||
+ Lists of codes represent text as a list of numbers, where each number is a character code. A string of _N_ bytes requires _N_ pairs, that is _2N_ cells, leading to a total of 16 bytes per character on 64 byte machines. Thus, they are a very expensive, but very flexible representation, as one can use unification to construct and access string elements.
|
||||
|
||||
|
||||
+ Lists of atoms represent text as a list of atoms, where each number has a single character code. A string of _N_ bytes also requires _2N_ pairs. They have similar properties to lists of codes.
|
||||
|
||||
|
||||
The flags `double_quotes` and `backquoted_string` change the interpretation of text strings, they can take the
|
||||
values `atom`, `string`, `codes`, and `chars`.
|
||||
|
||||
|
@ -213,7 +212,7 @@ Examples:
|
|||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
The first string is an empty string, the last string shows the use of
|
||||
double-quoting.
|
||||
double-quoting.
|
||||
|
||||
Escape sequences can be used to include the non-printable characters
|
||||
`a` (alert), `b` (backspace), `r` (carriage return),
|
||||
|
@ -346,7 +345,7 @@ atoms. If the text fits in ISO Latin-1, it is represented as an array
|
|||
of 8-bit characters. Otherwise the text is represented as an array of
|
||||
wide chars, which may take 16 or 32 bits. This representational issue
|
||||
is completely transparent to the Prolog user. Users of the foreign
|
||||
language interface sometimes need to be aware of these issues though. Notice that this will likely
|
||||
language interface sometimes need to be aware of these issues though. Notice that this will likely
|
||||
change in the future, we probably will use an UTF-8 based representation.
|
||||
|
||||
Character coding comes into view when characters of strings need to be
|
||||
|
@ -359,7 +358,7 @@ as well as I/O through network sockets.
|
|||
@ingroup WideChars
|
||||
|
||||
The UCS standard describes all possible characters (or code points, as they include
|
||||
ideograms, ligatures, and other symbols). The current version, Unicode 8.0, allows
|
||||
ideograms, ligatures, and other symbols). The current version, Unicode 8.0, allows
|
||||
code points up to 0x10FFFF, and thus allows for 1,114,112 code points. See [Unicode Charts](http://unicode.org/charts/) for the supported languages.
|
||||
|
||||
Notice that most symbols are rarely used. Encodings represent the Unicode characters in a way
|
||||
|
@ -367,23 +366,23 @@ that is more suited for communication. The most popular encoding, especially in
|
|||
UTF-8. UTF-8 is compact and as it uses bytes, does not have different endianesses.
|
||||
Bytes 0...127 represent simply the corresponding US-ASCII
|
||||
character, while bytes 128...255 are used for multi-byte
|
||||
encoding of characters placed higher in the UCS space.
|
||||
encoding of characters placed higher in the UCS space.
|
||||
|
||||
Especially on
|
||||
MS-Windows and Java the 16-bit Unicode standard, represented by pairs of bytes is
|
||||
also popular. Originally, Microsoft supported a UCS-2 with 16 bits that
|
||||
also popular. Originally, Microsoft supported a UCS-2 with 16 bits that
|
||||
could represent only up to 64k characters. This was later extended to support the full
|
||||
Unicode, we will call the latter version UTF-16. The extension uses a hole in the first 64K code points. Characters above 0xFFFF are divided into two 2-byte words, each one in that hole. There are two versions of UTF-16: big and low
|
||||
endian. By default, UTF-16 is big endian, in practice most often it is used on Intel
|
||||
hardware that is naturally little endian.
|
||||
|
||||
UTF-32, often called UCS-4, provides a natural interface where a code point is coded as
|
||||
|
||||
UTF-32, often called UCS-4, provides a natural interface where a code point is coded as
|
||||
four octets. Unfortunately, it is also more expensive, so it is not as widely used.
|
||||
|
||||
|
||||
Last, other encodings are also commonly used. One such legacy encoding is ISO-LATIN-1, that
|
||||
supported latin based languages in western europe. YAP currently uses either ISO-LATIN-1 or UTF-32
|
||||
internally.
|
||||
|
||||
|
||||
Prolog supports the default encoding used by the Operating System,
|
||||
Namely, YAP checks the variables LANG, LC_ALL and LC_TYPE. Say, if at boot YAP detects that the
|
||||
environment variable `LANG` ends in "UTF-8", this encoding is
|
||||
|
@ -419,7 +418,7 @@ but generates errors and warnings on encountering values above
|
|||
8-bit encoding supporting many western languages. This causes
|
||||
the stream to be read and written fully untranslated.
|
||||
|
||||
+ `text`
|
||||
+ `text`
|
||||
C-library default locale encoding for text files. Files are read and
|
||||
written using the C-library functions `mbrtowc()` and
|
||||
`wcrtomb()`. This may be the same as one of the other locales,
|
||||
|
@ -484,7 +483,7 @@ writing, writing a BOM can be requested using the option
|
|||
`bom(true)` with `open/4`. YAP will parse an UTF-8 file for a BOM only if explicitly required to do so. Do notice that YAP will write a BOM by default on UTF-16 (including UCS-2) and
|
||||
UTF-32; otherwise the default is not to write a BOM. BOMs are not avaliable for ASCII and
|
||||
ISO-LATIN-1.
|
||||
|
||||
|
||||
= @addgroup Operators Summary of YAP Predefined Operators
|
||||
@ingroup YapSyntax
|
||||
|
||||
|
|
601
docs/yap.md
601
docs/yap.md
|
@ -1,31 +1,31 @@
|
|||
YAP 6-3.4 Manual {#mainpage}
|
||||
====================
|
||||
|
||||
This file documents the YAP Prolog System version 6.3.4, a high-performance Prolog compiler developed at LIACC, Universidade do Porto. YAP is based on David H. D. Warren's WAM (Warren Abstract Machine), with several optimizations for better performance. YAP follows the Edinburgh tradition, and is largely compatible with DEC-10 Prolog, Quintus Prolog, and especially with C-Prolog.
|
||||
This file documents the YAP Prolog System version 6.3.4, a high-performance Prolog compiler developed at LIACC, Universidade do Porto. YAP is based on David H. D. Warren's WAM (Warren Abstract Machine), with several optimizations for better performance. YAP follows the Edinburgh tradition, and is largely compatible with DEC-10 Prolog, Quintus Prolog, and originally with C-Prolog.
|
||||
|
||||
+ @ref download
|
||||
The manual is organised as follows:
|
||||
|
||||
+ @ref install
|
||||
|
||||
+ @ref run
|
||||
+ @subpage download
|
||||
|
||||
+ @ref YAPSyntax
|
||||
+ @subpage install
|
||||
|
||||
+ @ref consult
|
||||
+ @subpage run
|
||||
|
||||
+ @ref builtins
|
||||
+ @subpage builtins
|
||||
|
||||
+ @ref extensions
|
||||
+ @subpage extensions
|
||||
|
||||
+ @ref library
|
||||
+ @subpage library
|
||||
|
||||
+ @ref packages
|
||||
+ @subpage swi
|
||||
|
||||
+ @ref swi
|
||||
+ @subpage packages
|
||||
|
||||
+ @ref YAPProgramming
|
||||
+ @subpage YAPProgramming
|
||||
|
||||
+ @subpage Fli
|
||||
|
||||
+ @ref fli
|
||||
|
||||
|
||||
|
||||
|
@ -51,578 +51,3 @@ originally from the SWI-Prolog manual, with the gracious authorization
|
|||
from
|
||||
Jan Wielemaker. We would also like to gratefully
|
||||
acknowledge the contributions from Ashwin Srinivasian.
|
||||
|
||||
|
||||
|
||||
Loading and Organising YAP Programs {#consult}
|
||||
===================================
|
||||
|
||||
@ingroup main
|
||||
|
||||
Next, we present the main predicates and directives available to load
|
||||
files and to control the Prolog environment.
|
||||
|
||||
+ @ref YAPConsulting
|
||||
|
||||
+ @ref YAPModules
|
||||
|
||||
+@ref YAPSaving
|
||||
|
||||
|
||||
This chapter describes the predicates controlling the execution of
|
||||
Prolog programs.
|
||||
|
||||
In the description of the arguments of functors the following notation
|
||||
will be used:
|
||||
|
||||
+ a preceding plus sign will denote an argument as an "input
|
||||
argument" - it cannot be a free variable at the time of the call;
|
||||
+ a preceding minus sign will denote an "output argument";
|
||||
+ an argument with no preceding symbol can be used in both ways.
|
||||
|
||||
Running YAP {#run}
|
||||
===========
|
||||
|
||||
We next describe how to invoke YAP in Unix systems.
|
||||
|
||||
Running YAP Interactively
|
||||
-------------------------
|
||||
|
||||
Most often you will want to use YAP in interactive mode. Assuming that
|
||||
YAP is in the user's search path, the top-level can be invoked under
|
||||
Unix with the following command:
|
||||
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
yap [-s n] [-h n] [-a n] [-c IP_HOST port ] [filename]
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
All the arguments and flags are optional and have the following meaning:
|
||||
|
||||
+ -?
|
||||
print a short error message.
|
||||
+ -s _Size_
|
||||
allocate _Size_ KBytes for local and global stacks. The user may
|
||||
specify <tt>M</tt> bytes.
|
||||
+ -h _Size_
|
||||
allocate _Size_ KBytes for heap and auxiliary stacks
|
||||
+ -t _Size_
|
||||
allocate _Size_ KBytes for the trail stack
|
||||
+ -L _Size_
|
||||
SWI-compatible option to allocate _Size_ K bytes for local and global stacks, the local stack
|
||||
cannot be expanded. To avoid confusion with the load option, _Size_
|
||||
must immediately follow the letter `L`.
|
||||
+ -G _Size_
|
||||
SWI-compatible option to allocate _Size_ K bytes for local and global stacks; the global
|
||||
stack cannot be expanded
|
||||
+ -T _Size_
|
||||
SWI-compatible option to allocate _Size_ K bytes for the trail stack; the trail cannot be expanded.
|
||||
+ -l _YAP_FILE_
|
||||
compile the Prolog file _YAP_FILE_ before entering the top-level.
|
||||
+ -L _YAP_FILE_
|
||||
compile the Prolog file _YAP_FILE_ and then halt. This option is
|
||||
useful for implementing scripts.
|
||||
+ -g _Goal_
|
||||
run the goal _Goal_ before top-level. The goal is converted from
|
||||
an atom to a Prolog term.
|
||||
+ -z _Goal_
|
||||
run the goal _Goal_ as top-level. The goal is converted from
|
||||
an atom to a Prolog term.
|
||||
+ -b _BOOT_FILE_
|
||||
boot code is in Prolog file _BOOT_FILE_. The filename must define
|
||||
the predicate `'$live'/0`.
|
||||
+ -c <tt>IP_HOST</tt> <tt>port</tt>
|
||||
connect standard streams to host <tt>IP_HOST</tt> at port <tt>port</tt>
|
||||
+ filename
|
||||
restore state saved in the given file
|
||||
+ -f
|
||||
do not consult initial files
|
||||
+ -q
|
||||
do not print informational messages
|
||||
+ --
|
||||
separator for arguments to Prolog code. These arguments are visible
|
||||
through the unix/1 built-in predicate.
|
||||
|
||||
|
||||
Note that YAP will output an error message on the following conditions:
|
||||
|
||||
+
|
||||
a file name was given but the file does not exist or is not a saved
|
||||
YAP state;
|
||||
|
||||
+
|
||||
the necessary amount of memory could not be allocated;
|
||||
|
||||
+
|
||||
the allocated memory is not enough to restore the state.
|
||||
|
||||
|
||||
When restoring a saved state, YAP will allocate the
|
||||
same amount of memory as that in use when the state was saved, unless a
|
||||
different amount is specified by flags in the command line. By default,
|
||||
YAP restores the file startup.yss from the current directory or from
|
||||
the YAP library.
|
||||
|
||||
+
|
||||
YAP usually boots from a saved state. The saved state will use the default
|
||||
installation directory to search for the YAP binary unless you define
|
||||
the environment variable YAPBINDIR.
|
||||
|
||||
+
|
||||
YAP always tries to find saved states from the current directory
|
||||
first. If it cannot it will use the environment variable YAPLIBDIR, if
|
||||
defined, or search the default library directory.
|
||||
|
||||
+
|
||||
YAP will try to find library files from the YAPSHAREDIR/library
|
||||
directory.
|
||||
|
||||
|
||||
Prolog Scripts
|
||||
--------------
|
||||
|
||||
YAP can also be used to run Prolog files as scripts, at least in
|
||||
Unix-like environments. A simple example is shown next (do not forget
|
||||
that the shell comments are very important):
|
||||
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
#!/usr/local/bin/yap -L --
|
||||
#
|
||||
# Hello World script file using YAP
|
||||
#
|
||||
# put a dot because of syntax errors .
|
||||
|
||||
:- write('Hello World'), nl.
|
||||
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
The `#!` characters specify that the script should call the binary
|
||||
file YAP. Notice that many systems will require the complete path to the
|
||||
YAP binary. The `-L` flag indicates that YAP should consult the
|
||||
current file when booting and then halt. The remaining arguments are
|
||||
then passed to YAP. Note that YAP will skip the first lines if they
|
||||
start with `#` (the comment sign for Unix's shell). YAP will
|
||||
consult the file and execute any commands.
|
||||
|
||||
A slightly more sophisticated example is:
|
||||
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
#!/usr/bin/yap -L --
|
||||
#
|
||||
# Hello World script file using YAP
|
||||
# .
|
||||
|
||||
:- initialization(main).
|
||||
|
||||
main :- write('Hello World'), nl.
|
||||
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
The `initialization` directive tells YAP to execute the goal main
|
||||
after consulting the file. Source code is thus compiled and `main`
|
||||
executed at the end. The `.` is useful while debugging the script
|
||||
as a Prolog program: it guarantees that the syntax error will not
|
||||
propagate to the Prolog code.
|
||||
|
||||
Notice that the `--` is required so that the shell passes the extra
|
||||
arguments to YAP. As an example, consider the following script
|
||||
`dump_args`:
|
||||
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
#!/usr/bin/yap -L --
|
||||
#.
|
||||
|
||||
main( [] ).
|
||||
main( [H|T] ) :-
|
||||
write( H ), nl,
|
||||
main( T ).
|
||||
|
||||
:- unix( argv(AllArgs) ), main( AllArgs ).
|
||||
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
If you this run this script with the arguments:
|
||||
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
./dump_args -s 10000
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
the script will start an YAP process with stack size `10MB`, and
|
||||
the list of arguments to the process will be empty.
|
||||
|
||||
Often one wants to run the script as any other program, and for this it
|
||||
is convenient to ignore arguments to YAP. This is possible by using
|
||||
`L --` as in the next version of `dump_args`:
|
||||
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
#!/usr/bin/yap -L --
|
||||
|
||||
main( [] ).
|
||||
main( [H|T] ) :-
|
||||
write( H ), nl,
|
||||
main( T ).
|
||||
|
||||
:- unix( argv(AllArgs) ), main( AllArgs ).
|
||||
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
The `--` indicates the next arguments are not for YAP. Instead,
|
||||
they must be sent directly to the argv built-in. Hence, running
|
||||
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
./dump_args test
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
will write `test` on the standard output.
|
||||
|
||||
YAP Built-ins {#builtins}
|
||||
=============
|
||||
|
||||
+ @ref YAPControl
|
||||
|
||||
+ @ref arithmetic
|
||||
|
||||
+ @ref YAPChars
|
||||
|
||||
+ @ref YAP_Terms
|
||||
|
||||
+ @ref InputOutput
|
||||
|
||||
+ @ref AbsoluteFileName
|
||||
|
||||
+ @ref YAPOS
|
||||
|
||||
+ @ref Internal_Database
|
||||
|
||||
+ @ref Sets
|
||||
|
||||
Extensions to core Prolog. {#extensions}
|
||||
==========================
|
||||
|
||||
YAP includes a number of extensions over the original Prolog
|
||||
language. Next, we discuss how to use the most important ones.
|
||||
|
||||
+ @ref Rational_Trees
|
||||
|
||||
+ @ref AttributedVariables
|
||||
|
||||
+ @ref DepthLimited
|
||||
|
||||
+ @ref Tabling
|
||||
|
||||
+ @ref Threads
|
||||
|
||||
+ @ref Profiling
|
||||
|
||||
+ @ref YAPArrays
|
||||
|
||||
+ @ref Parallelism
|
||||
|
||||
The YAP Library {#library}
|
||||
===============
|
||||
|
||||
@defgroup library YAP library files
|
||||
@{
|
||||
|
||||
Library files reside in the library_directory path (set by the
|
||||
`LIBDIR` variable in the Makefile for YAP). Several files in the
|
||||
library are originally from the public-domain Edinburgh Prolog library.
|
||||
|
||||
- @ref apply
|
||||
- @ref apply_macros
|
||||
- @ref arg
|
||||
- @ref Association_Lists
|
||||
- @ref avl
|
||||
- @ref bhash
|
||||
- @ref block_diagram
|
||||
- @ref c_alarms
|
||||
- @ref charsio
|
||||
- @ref clauses
|
||||
- @ref cleanup
|
||||
- @ref dbqueues
|
||||
- @ref dbusage
|
||||
- @ref dgraphs
|
||||
- @ref exo_interval
|
||||
- @ref flags
|
||||
- @ref gensym
|
||||
- @ref yap_hacks
|
||||
- @ref heaps
|
||||
- @ref lam_mpi
|
||||
- @ref line_utils
|
||||
- @ref swi_listing
|
||||
- @ref lists
|
||||
- @ref mapargs
|
||||
- @ref maplist
|
||||
- @ref matlab
|
||||
- @ref matrix
|
||||
- @ref nb
|
||||
- @ref Ordered_Sets
|
||||
- @ref parameters
|
||||
- @ref queues
|
||||
- @ref random
|
||||
- @ref Pseudo_Random
|
||||
- @ref rbtrees
|
||||
- @ref regexp
|
||||
- @ref rltrees
|
||||
- @ref Splay_Trees
|
||||
- @ref operating_system_support,
|
||||
- @ref Terms
|
||||
- @ref timeout
|
||||
- @ref trees
|
||||
- @ref tries
|
||||
- @ref ugraphs
|
||||
- @ref undgraphs
|
||||
- @ref varnumbers
|
||||
- @ref wdgraphs
|
||||
- @ref wdgraphs
|
||||
- @ref wdgraphs
|
||||
- @ref wgraphs
|
||||
- @ref wundgraphs
|
||||
- @ref ypp
|
||||
@}
|
||||
|
||||
The YAP Packages {#packages}
|
||||
================
|
||||
|
||||
@defgroup packages YAP packages files
|
||||
@{
|
||||
|
||||
+ @ref real
|
||||
|
||||
+ @ref BDDs
|
||||
|
||||
+ @ref Gecode
|
||||
|
||||
+ @ref MYDDAS
|
||||
|
||||
+ @ref PFL
|
||||
|
||||
+ @ref ProbLog1
|
||||
|
||||
+ @ref python
|
||||
|
||||
+ @ref YAPRaptor
|
||||
|
||||
+ @ref YAP-LBFGS
|
||||
|
||||
+ @subpage yap-udi-indexers
|
||||
|
||||
Leuven packages ported from SWI-Prolog:
|
||||
|
||||
+ @subpage chr
|
||||
|
||||
+ @subpage clpqr
|
||||
|
||||
@}
|
||||
|
||||
Compatibility {#swi}
|
||||
=============
|
||||
|
||||
|
||||
@defgroup swi Compatibility
|
||||
@{
|
||||
|
||||
|
||||
YAP has been designed to be as compatible as possible with other
|
||||
Prolog systems, originally with C-Prolog\cite x and SICStus
|
||||
Prolog~\cite x . More recent work on YAP has striven at making YAP
|
||||
compatible with the ISO-Prolog standard\cite x , and with Jan
|
||||
Wielemaker's SWI-Prolog\cite x .
|
||||
|
||||
SWI-Prolog and YAP have collaborated at improved compatibility \cite x . This
|
||||
resulted in Prolog extensions such as the `dialect` feature. YAP
|
||||
currently supports most of the SWI-Prolog foreign interface. The following SWI
|
||||
libraries have worked on YAP:
|
||||
|
||||
+ @ref aggregate
|
||||
+ @ref base64
|
||||
+ @ref broadcast
|
||||
+ @ref ctypes
|
||||
+ @ref date
|
||||
+ @ref prolog_debug
|
||||
+ @ref prolog_edit
|
||||
+ @ref error
|
||||
+ @ref nb_set
|
||||
+ @ref prolog_operator
|
||||
+ @ref swi_option
|
||||
+ @ref pairs
|
||||
+ @ref pio
|
||||
+ @ref predicate_options,
|
||||
+ @ref predopts
|
||||
+ @ref prolog_clause
|
||||
+ @ref prolog_colour
|
||||
+ @ref prolog_source
|
||||
+ @ref prolog_xref
|
||||
+ @ref pure_input
|
||||
+ @ref quasi_quotations
|
||||
+ @ref read_util
|
||||
+ @ref record
|
||||
+ @ref settings
|
||||
+ @ref shlib
|
||||
+ @ref thread_pool
|
||||
+ @ref url
|
||||
+ @ref utf8
|
||||
+ @ref win_menu
|
||||
+ @ref www_browser
|
||||
|
||||
|
||||
Note that in general SWI code may be from an earlier version than the
|
||||
one available with SWI-Prolog. SWI-Prolog are obviously not
|
||||
responsible for any incompatibilities and/or bugs in the YAP port.
|
||||
|
||||
Please do refer to the SWI-Prolog home page:
|
||||
|
||||
<http://www.swi-prolog.org>
|
||||
|
||||
for more information on SWI-Prolog and the SWI packages.
|
||||
|
||||
Compatibility with the C-Prolog interpreter {#ChYProlog}
|
||||
-------------------------------------------
|
||||
|
||||
YAP was designed so that most C-Prolog programs should run under YAP
|
||||
without changes.
|
||||
The most important difference between YAP and C-Prolog is that, being
|
||||
YAP a compiler, some changes should be made if predicates such as
|
||||
assert/1, clause/1 and retract/1 are used. First
|
||||
predicates which will change during execution should be declared as
|
||||
`dynamic` by using commands like:
|
||||
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
:- dynamic f/n.
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
where `f` is the predicate name and n is the arity of the
|
||||
predicate. Note that several such predicates can be declared in a
|
||||
single command:
|
||||
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
:- dynamic f/2, ..., g/1.
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
Primitive predicates such as `retract` apply only to dynamic
|
||||
predicates. Finally note that not all the C-Prolog primitive predicates
|
||||
are implemented in YAP. They can easily be detected using the
|
||||
`unknown` system predicate provided by YAP.
|
||||
|
||||
Last, by default YAP enables character escapes in strings. You can
|
||||
disable the special interpretation for the escape character by using:
|
||||
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
:- yap_flag(character_escapes,off).
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
or by using:
|
||||
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
:- yap_flag(language,cprolog).
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
|
||||
Compatibility with the Quintus and SICStus Prolog systems
|
||||
---------------------------------------------------------
|
||||
|
||||
The Quintus Prolog system was the first Prolog compiler to use Warren's
|
||||
Abstract Machine. This system was very influential in the Prolog
|
||||
community. Quintus Prolog implemented compilation into an abstract
|
||||
machine code, which was then emulated. Quintus Prolog also included
|
||||
several new built-ins, an extensive library, and in later releases a
|
||||
garbage collector. The SICStus Prolog system, developed at SICS (Swedish
|
||||
Institute of Computer Science), is an emulator based Prolog system
|
||||
largely compatible with Quintus Prolog. SICStus Prolog has evolved
|
||||
through several versions. The current version includes several
|
||||
extensions, such as an object implementation, co-routining, and
|
||||
constraints.
|
||||
|
||||
Both YAP and SICStus Prolog obey the Edinburgh Syntax and are based on
|
||||
the WAM. Even so, there are major important differences:
|
||||
|
||||
+ Differently from SICStus Prolog, both consulted and dynamic code in YAP
|
||||
are compiled, not interpreted. All code in YAP is compiled.
|
||||
|
||||
+ The following SICStus Prolog v3 built-ins are not (currently)
|
||||
implemented in YAP (note that this is only a partial list):
|
||||
stream_interrupt/3, reinitialize/0, help/0, help/1,
|
||||
trimcore/0, and require/1.
|
||||
|
||||
+ The consult/1 predicate in YAP follows C-Prolog
|
||||
semantics. That is, it adds clauses to the data base, even for
|
||||
preexisting procedures. This is different from consult/1 in
|
||||
SICStus Prolog or SWI-Prolog.
|
||||
|
||||
+ This list is incomplete.
|
||||
|
||||
Compatibility with the ISO Prolog standard
|
||||
------------------------------------------
|
||||
|
||||
The Prolog standard was developed by ISO/IEC JTC1/SC22/WG17, the
|
||||
international standardization working group for the programming language
|
||||
Prolog. The book "Prolog: The Standard" by Deransart, Ed-Dbali and
|
||||
Cervoni gives a complete description of this standard. Development in
|
||||
YAP from YAP4.1.6 onwards have striven at making YAP
|
||||
compatible with ISO Prolog. As such:
|
||||
|
||||
+ YAP now supports all of the built-ins required by the
|
||||
ISO-standard, and,
|
||||
+ Error-handling is as required by the standard.
|
||||
|
||||
|
||||
YAP by default is not fully ISO standard compliant. You can set the
|
||||
language flag to `iso` to obtain better
|
||||
compatibility. Setting this flag changes the following:
|
||||
|
||||
|
||||
+ By default, YAP implements the
|
||||
atom_chars/2 (see Testing Terms), and
|
||||
number_chars/2, (see Testing Terms),
|
||||
built-ins as per the original Quintus Prolog definition, and
|
||||
not as per the ISO definition.
|
||||
|
||||
Calling `set_prolog_flag(to_chars_mode,iso)` will switch
|
||||
YAP to use the ISO definition for
|
||||
atom_chars/2 and number_chars/2.
|
||||
|
||||
+ By default, YAP allows executable goals in directives. In ISO mode
|
||||
most directives can only be called from top level (the exceptions are
|
||||
set_prolog_flag/2 and op/3).
|
||||
|
||||
+ Error checking for meta-calls under ISO Prolog mode is stricter
|
||||
than by default.
|
||||
|
||||
+ The strict_iso flag automatically enables the ISO Prolog
|
||||
standard. This feature should disable all features not present in the
|
||||
standard.
|
||||
|
||||
The following incompatibilities between YAP and the ISO standard are
|
||||
known to still exist (please check Ulrich Neumerkel's page for more details):
|
||||
|
||||
<ul>
|
||||
|
||||
<li>Currently, YAP does not handle overflow errors in integer
|
||||
operations, and handles floating-point errors only in some
|
||||
architectures. Otherwise, YAP follows IEEE arithmetic.
|
||||
|
||||
Please inform the authors on other incompatibilities that may still
|
||||
exist.
|
||||
|
||||
@}
|
||||
|
||||
Foreign Language interface for YAP {#fli}
|
||||
==================================
|
||||
|
||||
@defgroup fli Foreigd Code Interfacing
|
||||
|
||||
@{
|
||||
|
||||
YAP provides the user with three facilities for writing
|
||||
predicates in a language other than Prolog. Under Unix systems,
|
||||
most language implementations were linkable to `C`, and the first interface exported the YAP machinery to the C language. YAP also implements most of the SWI-Prolog foreign language interface.
|
||||
This gives portability with a number of SWI-Prolog packages and avoids garnage collection by using @ref slotInterface. Last, a new C++ based interface is
|
||||
being designed to work with the swig (www.swig.orgv) interface compiler.
|
||||
|
||||
+ The @ref c-interface exports the YAP engine.
|
||||
|
||||
+ The @ref swi-c-interface emulates Jan Wielemaker's SWI foreign language interface.
|
||||
|
||||
+ The @ref yap-cplus-interface is desiged to interface with the SWIG package by using Object-Oriented concepts
|
||||
|
||||
+ The @ref LoadInterface handles the setup of foreign files
|
||||
|
||||
@}
|
||||
|
||||
|
|
|
@ -17,13 +17,13 @@
|
|||
|
||||
:- module(attributes, [op(1150, fx, attribute)]).
|
||||
|
||||
%% @{
|
||||
|
||||
/**
|
||||
@addtogroup attributes
|
||||
|
||||
|
||||
SICStus style attribute declarations are activated through loading the
|
||||
%% @{
|
||||
|
||||
SICStus style attribute declarations are activated through loading the
|
||||
library <tt>atts</tt>. The command
|
||||
|
||||
~~~~~
|
||||
|
|
|
@ -1,3 +1,5 @@
|
|||
Prolog Commons {#prolog_comons}
|
||||
=============
|
||||
|
||||
This directory should hold files from the Prolog Commons
|
||||
project. Please see
|
||||
|
|
|
@ -219,15 +219,15 @@ static Term syntax_error(TokEntry *errtok, int sno, Term cmod) {
|
|||
CACHE_REGS
|
||||
Term startline, errline, endline;
|
||||
Term tf[3];
|
||||
Term tm;
|
||||
Term tm;
|
||||
Term *tailp = tf + 2;
|
||||
CELL *Hi = HR;
|
||||
TokEntry *tok = LOCAL_tokptr;
|
||||
Int cline = tok->TokPos;
|
||||
|
||||
startline = MkIntegerTerm(cline);
|
||||
endline = MkIntegerTerm(cline);
|
||||
if (errtok != LOCAL_toktide) {
|
||||
endline = MkIntegerTerm(cline);
|
||||
if (errtok != LOCAL_toktide) {
|
||||
errtok = LOCAL_toktide;
|
||||
}
|
||||
LOCAL_Error_TYPE = YAP_NO_ERROR;
|
||||
|
@ -254,7 +254,7 @@ static Term syntax_error(TokEntry *errtok, int sno, Term cmod) {
|
|||
*tailp = MkPairTerm(MkAtomTerm(AtomError), TermNil);
|
||||
tailp = RepPair(*tailp) + 1;
|
||||
}
|
||||
Term rep = Yap_tokRep(tok );
|
||||
Term rep = Yap_tokRep(tok);
|
||||
if (tok->TokNext) {
|
||||
tok = tok->TokNext;
|
||||
} else {
|
||||
|
@ -262,7 +262,7 @@ static Term syntax_error(TokEntry *errtok, int sno, Term cmod) {
|
|||
tok = NULL;
|
||||
break;
|
||||
}
|
||||
*tailp = MkPairTerm(rep , TermNil);
|
||||
*tailp = MkPairTerm(rep, TermNil);
|
||||
tailp = RepPair(*tailp) + 1;
|
||||
}
|
||||
{
|
||||
|
@ -280,8 +280,8 @@ static Term syntax_error(TokEntry *errtok, int sno, Term cmod) {
|
|||
clean_vars(LOCAL_AnonVarTable);
|
||||
Term terr = Yap_MkApplTerm(FunctorInfo3, 3, tf);
|
||||
Term tn[2];
|
||||
tn[0] = Yap_MkApplTerm(FunctorShortSyntaxError, 1, &tm);
|
||||
tn[1] = terr;
|
||||
tn[0] = Yap_MkApplTerm(FunctorShortSyntaxError, 1, &tm);
|
||||
tn[1] = terr;
|
||||
terr = Yap_MkApplTerm(FunctorError, 2, tn);
|
||||
#if DEBUG
|
||||
if (Yap_ExecutionMode == YAP_BOOT_MODE) {
|
||||
|
@ -643,7 +643,7 @@ static parser_state_t scan(REnv *re, FEnv *fe, int inp_stream);
|
|||
static parser_state_t scanEOF(FEnv *fe, int inp_stream) {
|
||||
CACHE_REGS
|
||||
// bool store_comments = false;
|
||||
TokEntry *tokstart = LOCAL_tokptr;
|
||||
TokEntry *tokstart = LOCAL_tokptr;
|
||||
// check for an user abort
|
||||
if (tokstart != NULL && tokstart->Tok != Ord(eot_tok)) {
|
||||
/* we got the end of file from an abort */
|
||||
|
@ -730,24 +730,23 @@ static parser_state_t scan(REnv *re, FEnv *fe, int inp_stream) {
|
|||
TokEntry *t = LOCAL_tokptr;
|
||||
int n = 0;
|
||||
while (t) {
|
||||
fprintf(stderr, "[Token %d %s %d]",
|
||||
Ord(t->Tok),Yap_tokText(t), n++);
|
||||
fprintf(stderr, "[Token %d %s %d]", Ord(t->Tok), Yap_tokText(t), n++);
|
||||
t = t->TokNext;
|
||||
}
|
||||
fprintf(stderr, "\n");
|
||||
}
|
||||
#endif
|
||||
if (LOCAL_ErrorMessage)
|
||||
return YAP_SCANNING_ERROR;
|
||||
if (LOCAL_tokptr->Tok != Ord(eot_tok)) {
|
||||
// next step
|
||||
return YAP_PARSING;
|
||||
}
|
||||
if (LOCAL_tokptr->Tok == eot_tok && LOCAL_tokptr->TokInfo == TermNl) {
|
||||
LOCAL_Error_TYPE = SYNTAX_ERROR;
|
||||
return YAP_PARSING_ERROR;
|
||||
}
|
||||
return scanEOF(fe, inp_stream);
|
||||
if (LOCAL_ErrorMessage)
|
||||
return YAP_SCANNING_ERROR;
|
||||
if (LOCAL_tokptr->Tok != Ord(eot_tok)) {
|
||||
// next step
|
||||
return YAP_PARSING;
|
||||
}
|
||||
if (LOCAL_tokptr->Tok == eot_tok && LOCAL_tokptr->TokInfo == TermNl) {
|
||||
LOCAL_Error_TYPE = SYNTAX_ERROR;
|
||||
return YAP_PARSING_ERROR;
|
||||
}
|
||||
return scanEOF(fe, inp_stream);
|
||||
}
|
||||
|
||||
static parser_state_t scanError(REnv *re, FEnv *fe, int inp_stream) {
|
||||
|
@ -807,7 +806,7 @@ static parser_state_t parseError(REnv *re, FEnv *fe, int inp_stream) {
|
|||
} else {
|
||||
Term t = syntax_error(fe->toklast, inp_stream, fe->cmod);
|
||||
if (ParserErrorStyle == TermError) {
|
||||
LOCAL_ActiveError->errorTerm = Yap_StoreTermInDB( t, 4);
|
||||
LOCAL_ActiveError->errorTerm = Yap_StoreTermInDB(t, 4);
|
||||
LOCAL_Error_TYPE = SYNTAX_ERROR;
|
||||
// dec-10
|
||||
} else if (Yap_PrintWarning(t)) {
|
||||
|
@ -1081,6 +1080,47 @@ static Int read_clause(
|
|||
return out && Yap_unify(tf, out);
|
||||
}
|
||||
|
||||
/**
|
||||
* start input for a meta-clause. Should obtain:
|
||||
* - predicate name
|
||||
* - predicate arity
|
||||
* - address for 256 cluses.
|
||||
*
|
||||
* @param ARG1 input stream
|
||||
* @param ARG2 Adress of predicate.
|
||||
* @param ARG3 Term read.
|
||||
* @return [description]
|
||||
*/
|
||||
#if 0
|
||||
static Int start_mega(USES_REGS1) {
|
||||
int inp_stream;
|
||||
Term out;
|
||||
Term t3 = Deref(ARG3);
|
||||
yhandle_t h = Yap_InitSlot(ARG2);
|
||||
TokENtry *tok;
|
||||
arity_t srity = 0;
|
||||
/* needs to change LOCAL_output_stream for write */
|
||||
inp_stream = Yap_CheckTextStream(ARG1, Input_Stream_f, "read_exo/3");
|
||||
if (inp_stream < 0)
|
||||
return false;
|
||||
/* preserve value of H after scanning: otherwise we may lose strings
|
||||
and floats */
|
||||
LOCAL_tokptr = LOCAL_toktide =
|
||||
x Yap_tokenizer(GLOBAL_Stream + inp_stream, false, &tpos);
|
||||
if (tokptr->Tok == Name_tok && (next = tokptr->TokNext) != NULL &&
|
||||
next->Tok == Ponctuation_tok && next->TokInfo == TermOpenBracket) {
|
||||
bool start = true;
|
||||
while((tokptr = next->TokNext)) {
|
||||
|
||||
if (IsAtomOrIntTerm(t=*tp)) {
|
||||
ip->opc = Yap_opcode(get_atom);
|
||||
ip->y_u.x_c.c = t.
|
||||
ip->y_u.x_c.x = tp++; /() c */
|
||||
} else if (IsAtomOrIntTerm(t=*tp)) {
|
||||
(IsAtom(tok->Tokt)||IsIntTerm(XREGS+(i+1)))extra[arity]
|
||||
]
|
||||
}
|
||||
#endif
|
||||
/**
|
||||
* @pred source_location( - _File_ , _Line_ )
|
||||
*
|
||||
|
@ -1094,6 +1134,8 @@ static Int read_clause(
|
|||
* @param - _File_
|
||||
* @param - _Line_
|
||||
*
|
||||
*
|
||||
*
|
||||
* @note SWI-Prolog built-in.
|
||||
*/
|
||||
static Int source_location(USES_REGS1) {
|
||||
|
@ -1215,15 +1257,15 @@ X_API Term Yap_StringToTerm(const char *s, size_t len, encoding_t *encp,
|
|||
CACHE_REGS
|
||||
Term bvar = MkVarTerm(), ctl;
|
||||
yhandle_t sl;
|
||||
int lvl = push_text_stack();
|
||||
int lvl = push_text_stack();
|
||||
|
||||
if (len == 0) {
|
||||
Term rval = TermEof;
|
||||
if (rval && bindings) {
|
||||
*bindings = TermNil;
|
||||
}
|
||||
pop_text_stack(lvl);
|
||||
return rval;
|
||||
pop_text_stack(lvl);
|
||||
return rval;
|
||||
}
|
||||
if (bindings) {
|
||||
ctl = Yap_MkApplTerm(Yap_MkFunctor(AtomVariableNames, 1), 1, &bvar);
|
||||
|
@ -1242,7 +1284,7 @@ X_API Term Yap_StringToTerm(const char *s, size_t len, encoding_t *encp,
|
|||
if (rval && bindings) {
|
||||
*bindings = Yap_PopHandle(sl);
|
||||
}
|
||||
pop_text_stack(lvl);
|
||||
pop_text_stack(lvl);
|
||||
return rval;
|
||||
}
|
||||
|
||||
|
|
|
@ -1,5 +1,7 @@
|
|||
Boolean Decision Making in YAP (#BDDs)
|
||||
==============================
|
||||
|
||||
This is an experimental interface to BDD libraries. It is not as
|
||||
This is an experimental interface to BDD libraries. It is not as
|
||||
sophisticated as simplecudd, but it should be fun to play around with bdds.
|
||||
|
||||
It currently works with cudd only, although it should be possible to
|
||||
|
@ -9,10 +11,7 @@ with cudd binaries. This works:
|
|||
- in fedora with standard package
|
||||
- in osx with hand-compiled and ports package
|
||||
|
||||
In ubuntu, you may want to install the fedora rpm, or just contact me
|
||||
for instructions.
|
||||
|
||||
Good Luck!
|
||||
|
||||
Vitor
|
||||
In ubuntu, you may want to install the fedora rpm, or just download the package from the original
|
||||
and compile it.
|
||||
|
||||
.
|
|
@ -1,8 +1,6 @@
|
|||
|
||||
CHR: Constraint Handling Rules {#chr}
|
||||
==============================
|
||||
|
||||
@ingroup packages
|
||||
|
||||
This chapter is written by Tom Schrijvers, K.U. Leuven for the hProlog
|
||||
system. Adjusted by Jan Wielemaker to fit the SWI-Prolog documentation
|
||||
|
@ -528,5 +526,3 @@ share one or more variables.
|
|||
Provide mode and type declarations to get more efficient program execution.
|
||||
Make sure to disable debug (`-nodebug`) and enable optimization
|
||||
(`-O`).
|
||||
|
||||
|
|
@ -1,538 +1,2 @@
|
|||
%
|
||||
% chr.pl is generated automatically.
|
||||
% This package is just here to work as a stub for YAP analysis.
|
||||
%
|
||||
|
||||
/**
|
||||
|
||||
@defgroup CHR CHR: Constraint Handling Rules
|
||||
|
||||
@ingroup swi
|
||||
|
||||
This chapter is written by Tom Schrijvers, K.U. Leuven for the hProlog
|
||||
system. Adjusted by Jan Wielemaker to fit the SWI-Prolog documentation
|
||||
infrastructure and remove hProlog specific references.
|
||||
|
||||
The CHR system of SWI-Prolog is the K.U.Leuven CHR system. The runtime
|
||||
environment is written by Christian Holzbaur and Tom Schrijvers while the
|
||||
compiler is written by Tom Schrijvers. Both are integrated with SWI-Prolog
|
||||
and licenced under compatible conditions with permission from the authors.
|
||||
|
||||
The main reference for SWI-Prolog's CHR system is:
|
||||
|
||||
+ T. Schrijvers, and B. Demoen, <em>The K.U.Leuven CHR System: Implementation and Application</em>, First Workshop on Constraint Handling Rules: Selected
|
||||
Contributions (Fruwirth, T. and Meister, M., eds.), pp. 1--5, 2004.
|
||||
|
||||
# Introduction
|
||||
|
||||
Constraint Handling Rules (CHR) is a committed-choice bottom-up language
|
||||
embedded in Prolog. It is designed for writing constraint solvers and is
|
||||
particularily useful for providing application-specific constraints.
|
||||
It has been used in many kinds of applications, like scheduling,
|
||||
model checking, abduction, type checking among many others.
|
||||
|
||||
CHR has previously been implemented in other Prolog systems (SICStus,
|
||||
Eclipse, Yap), Haskell and Java. This CHR system is based on the
|
||||
compilation scheme and runtime environment of CHR in SICStus.
|
||||
|
||||
In this documentation we restrict ourselves to giving a short overview
|
||||
of CHR in general and mainly focus on elements specific to this
|
||||
implementation. For a more thorough review of CHR we refer the reader to
|
||||
[Freuhwirth:98]. More background on CHR can be found at the CHR web site.
|
||||
|
||||
### Syntax and Semantics
|
||||