On Windows, SP_PATH is a shorthand for the SICStus Prolog installation directory, whose default location for SICStus 4.2.3 is C:\Program Files\SICStus Prolog 4.2.3\.
On UNIX, the default installation directory for SICStus 4.2.3 is /usr/local/sicstus4.2.3/ and SP_PATH is a shorthand for the subdirectory lib/sicstus-4.2.3/ of the installation directory, i.e.: /usr/local/sicstus4.2.3/lib/sicstus-4.2.3/.
See System Properties and Environment Variables for more information.
The value of many support functions is a return code, namely:
SP_SUCCESS
for success, SP_FAILURE
for failure,
SP_ERROR
if an error condition occurred, or if an uncaught
exception was raised during a call from C to Prolog.
If the value is SP_ERROR
, the macro SP_errno
will return a
value describing the error condition:
int SP_errno
The function SP_error_message()
returns a pointer to the diagnostic
message corresponding to a specified error number.
If a foreign function is specified to return an encoded string, an
exception will be raised if, on return to Prolog, the actual string is
malformed (is not a valid sequence of UTF-8 encoded characters). The
exception raised is
representation_error(...,...,mis_encoded_string)
.