568 lines
14 KiB
Prolog
568 lines
14 KiB
Prolog
/*************************************************************************
|
|
* *
|
|
* YAP Prolog *
|
|
* *
|
|
* Yap Prolog was developed at NCCUP - Universidade do Porto *
|
|
* *
|
|
* Copyright L.Damas, V.S.Costa and Universidade do Porto 1985-1997 *
|
|
* *
|
|
**************************************************************************
|
|
* *
|
|
* File: yio.yap *
|
|
* Last rev: *
|
|
* mods: *
|
|
* comments: Input output predicates *
|
|
* *
|
|
*************************************************************************/
|
|
|
|
|
|
/** @defgroup InputOutput Input/Output Predicates
|
|
@ingroup YAPBuiltins
|
|
@{
|
|
|
|
Some of the Input/Output predicates described below will in certain conditions
|
|
provide error messages and abort only if the file_errors flag is set.
|
|
If this flag is cleared the same predicates will just fail. Details on
|
|
setting and clearing this flag are given under 7.7.
|
|
|
|
|
|
*/
|
|
|
|
|
|
:- system_module( '$_yio', [at_end_of_line/0,
|
|
at_end_of_line/1,
|
|
consult_depth/1,
|
|
current_char_conversion/2,
|
|
current_line_number/1,
|
|
current_line_number/2,
|
|
current_stream/3,
|
|
display/1,
|
|
display/2,
|
|
exists/1,
|
|
fileerrors/0,
|
|
format/1,
|
|
nofileerrors/0,
|
|
open_pipe_streams/2,
|
|
prolog_file_name/2,
|
|
read/1,
|
|
read/2,
|
|
sformat/3,
|
|
socket/2,
|
|
socket/4,
|
|
socket_connect/3,
|
|
stream_position/2,
|
|
stream_position/3,
|
|
stream_position_data/3,
|
|
ttyget/1,
|
|
ttyget0/1,
|
|
ttynl/0,
|
|
ttyput/1,
|
|
ttyskip/1,
|
|
write_depth/2,
|
|
writeln/1], ['$default_expand'/1,
|
|
'$extend_file_search_path'/1,
|
|
'$set_default_expand'/1]).
|
|
|
|
:- use_system_module( '$_boot', ['$system_catch'/4]).
|
|
|
|
:- use_system_module( '$_errors', ['$do_error'/2]).
|
|
|
|
/* stream predicates */
|
|
|
|
/* check whether a list of options is valid */
|
|
'$check_io_opts'(V,G) :- var(V), !,
|
|
'$do_error'(instantiation_error,G).
|
|
'$check_io_opts'([],_) :- !.
|
|
'$check_io_opts'([H|_],G) :- var(H), !,
|
|
'$do_error'(instantiation_error,G).
|
|
'$check_io_opts'([Opt|T],G) :- !,
|
|
'$check_opt'(G,Opt,G),
|
|
'$check_io_opts'(T,G).
|
|
'$check_io_opts'(T,G) :-
|
|
'$do_error'(type_error(list,T),G).
|
|
|
|
'$check_opt'(read_term(_,_),Opt,G) :-
|
|
'$check_opt_read'(Opt, G).
|
|
'$check_opt'(stream_property(_,_),Opt,G) :-
|
|
'$check_opt_sp'(Opt, G).
|
|
|
|
'$check_opt_read'(variables(_), _) :- !.
|
|
'$check_opt_read'(variable_names(_), _) :- !.
|
|
'$check_opt_read'(singletons(_), _) :- !.
|
|
'$check_opt_read'(syntax_errors(T), G) :- !,
|
|
'$check_read_syntax_errors_arg'(T, G).
|
|
'$check_opt_read'(term_position(_), _) :- !.
|
|
'$check_opt_read'(term_position(_), _) :- !.
|
|
'$check_opt_read'(comments(_), _) :- !.
|
|
'$check_opt_read'(module(_), _) :- !.
|
|
'$check_opt_read'(A, G) :-
|
|
'$do_error'(domain_error(read_option,A),G).
|
|
|
|
'$check_opt_sp'(file_name(_), _) :- !.
|
|
'$check_opt_sp'(mode(_), _) :- !.
|
|
'$check_opt_sp'(input, _) :- !.
|
|
'$check_opt_sp'(output, _) :- !.
|
|
'$check_opt_sp'(alias(_), _) :- !.
|
|
'$check_opt_sp'(position(_), _) :- !.
|
|
'$check_opt_sp'(end_of_stream(_), _) :- !.
|
|
'$check_opt_sp'(eof_action(_), _) :- !.
|
|
'$check_opt_sp'(reposition(_), _) :- !.
|
|
'$check_opt_sp'(type(_), _) :- !.
|
|
'$check_opt_sp'(bom(_), _) :- !.
|
|
'$check_opt_sp'(encoding(_), _) :- !.
|
|
'$check_opt_sp'(representation_errors(_), _) :- !.
|
|
'$check_opt_sp'(A, G) :-
|
|
'$do_error'(domain_error(stream_property,A),G).
|
|
|
|
'$check_read_syntax_errors_arg'(X, G) :- var(X), !,
|
|
'$do_error'(instantiation_error,G).
|
|
'$check_read_syntax_errors_arg'(dec10,_) :- !.
|
|
'$check_read_syntax_errors_arg'(fail,_) :- !.
|
|
'$check_read_syntax_errors_arg'(error,_) :- !.
|
|
'$check_read_syntax_errors_arg'(quiet,_) :- !.
|
|
'$check_read_syntax_errors_arg'(X,G) :-
|
|
'$do_error'(domain_error(read_option,syntax_errors(X)),G).
|
|
|
|
'$check_boolean'(X, _, _, G) :- var(X), !,
|
|
'$do_error'(instantiation_error,G).
|
|
'$check_boolean'(true,_,_,_) :- !.
|
|
'$check_boolean'(false,_,_,_) :- !.
|
|
'$check_boolean'(X,B,T,G) :-
|
|
'$do_error'(domain_error(B,T),G).
|
|
|
|
/** @pred socket(+ _DOMAIN_,- _SOCKET_)
|
|
|
|
|
|
Call socket/4 with _TYPE_ bound to `SOCK_STREAM'` and
|
|
_PROTOCOL_ bound to `0`.
|
|
|
|
|
|
*/
|
|
socket(Domain, Sock) :-
|
|
(
|
|
'$undefined'(ip_socket(_,_),yap_sockets)
|
|
->
|
|
load_files(library(sockets), [silent(true),if(not_loaded)])
|
|
;
|
|
true
|
|
),
|
|
yap_sockets:ip_socket(Domain, Sock).
|
|
|
|
/** @pred socket(+ _DOMAIN_,+ _TYPE_,+ _PROTOCOL_,- _SOCKET_)
|
|
|
|
|
|
Corresponds to the BSD system call `socket`. Create a socket for
|
|
domain _DOMAIN_ of type _TYPE_ and protocol
|
|
_PROTOCOL_. Both _DOMAIN_ and _TYPE_ should be atoms,
|
|
whereas _PROTOCOL_ must be an integer.
|
|
The new socket object is
|
|
accessible through a descriptor bound to the variable _SOCKET_.
|
|
|
|
The current implementation of YAP accepts socket
|
|
domains `AF_INET` and `AF_UNIX`.
|
|
Socket types depend on the
|
|
underlying operating system, but at least the following types are
|
|
supported: `SOCK_STREAM'` and `SOCK_DGRAM'` (untested in 6.3).
|
|
|
|
|
|
*/
|
|
socket(Domain, Type, Protocol, Sock) :-
|
|
(
|
|
'$undefined'(ip_socket(_,_),yap_sockets)
|
|
->
|
|
load_files(library(sockets), [silent(true),if(not_loaded)])
|
|
;
|
|
true
|
|
),
|
|
yap_sockets:ip_socket(Domain, Type, Protocol, Sock).
|
|
|
|
/** @pred socket_connect(+ _SOCKET_, + _PORT_, - _STREAM_)
|
|
|
|
|
|
|
|
Interface to system call `connect`, used for clients: connect
|
|
socket _SOCKET_ to _PORT_. The connection results in the
|
|
read/write stream _STREAM_.
|
|
|
|
Port information depends on the domain:
|
|
|
|
+ 'AF_UNIX'(+ _FILENAME_)
|
|
+ 'AF_FILE'(+ _FILENAME_)
|
|
connect to socket at file _FILENAME_.
|
|
|
|
+ 'AF_INET'(+ _HOST_,+ _PORT_)
|
|
Connect to socket at host _HOST_ and port _PORT_.
|
|
|
|
|
|
|
|
*/
|
|
socket_connect(Sock, Host, Read) :-
|
|
(
|
|
'$undefined'(ip_socket(_,_),yap_sockets)
|
|
->
|
|
load_files(library(sockets), [silent(true),if(not_loaded)])
|
|
;
|
|
true
|
|
),
|
|
yap_sockets:ip_socket(Domain, Type, Protocol, Sock).
|
|
|
|
open_pipe_streams(Read, Write) :-
|
|
(
|
|
'$undefined'(pipe(_,_),unix)
|
|
->
|
|
load_files(library(unix), [silent(true),if(not_loaded)])
|
|
;
|
|
true
|
|
),
|
|
unix:pipe(Read, Write),
|
|
yap_flag(encoding, X),
|
|
set_stream(Read, encoding(X) ),
|
|
set_stream(Write, encoding(X) ).
|
|
|
|
/** @pred fileerrors
|
|
|
|
|
|
Switches on the file_errors flag so that in certain error conditions
|
|
Input/Output predicates will produce an appropriated message and abort.
|
|
|
|
*/
|
|
fileerrors :- '$swi_set_prolog_flag'(fileerrors, true).
|
|
|
|
/** @pred nofileerrors
|
|
|
|
|
|
Switches off the file_errors flag, so that the predicates see/1,
|
|
tell/1, open/3 and close/1 just fail, instead of producing
|
|
an error message and aborting whenever the specified file cannot be
|
|
opened or closed.
|
|
|
|
*/
|
|
nofileerrors :- '$swi_set_prolog_flag'(fileerrors, false).
|
|
|
|
/** @pred exists(+ _F_)
|
|
|
|
|
|
Checks if file _F_ exists in the current directory.
|
|
|
|
*/
|
|
exists(F) :-
|
|
absolute_file_name(F, _, [file_errors(fail),access(exist),expand(true)]).
|
|
|
|
/* Term IO */
|
|
|
|
/** @pred read(- _T_) is iso
|
|
|
|
|
|
Reads the next term from the current input stream, and unifies it with
|
|
_T_. The term must be followed by a dot (`.`) and any blank-character
|
|
as previously defined. The syntax of the term must match the current
|
|
declarations for operators (see op). If the end-of-stream is reached,
|
|
_T_ is unified with the atom `end_of_file`. Further reads from of
|
|
the same stream may cause an error failure (see open/3).
|
|
|
|
*/
|
|
read(T) :-
|
|
read_term(T, []).
|
|
|
|
/** @pred read(+ _S_,- _T_) is iso
|
|
|
|
Reads term _T_ from the stream _S_ instead of from the current input
|
|
stream.
|
|
|
|
|
|
*/
|
|
read(Stream,T) :-
|
|
read_term(Stream, T, []).
|
|
|
|
|
|
/* meaning of flags for '$write' is
|
|
1 quote illegal atoms
|
|
2 ignore operator declarations
|
|
4 output '$VAR'(N) terms as A, B, C, ...
|
|
8 use portray(_)
|
|
|
|
flags are defined in yapio.h
|
|
*/
|
|
|
|
/** @pred display(+ _T_)
|
|
|
|
|
|
Displays term _T_ on the current output stream. All Prolog terms are
|
|
written in standard parenthesized prefix notation.
|
|
|
|
|
|
*/
|
|
display(T) :-
|
|
current_output(Out),
|
|
write_term(Out, T, [ignore_ops(true)]).
|
|
|
|
/** @pred display(+ _S_, _T_)
|
|
|
|
Like display/1, but using stream _S_ to display the term.
|
|
|
|
|
|
*/
|
|
display(Stream, T) :-
|
|
write_term(Term, T, [ignore_ops(true)]).
|
|
|
|
/** @pred format(+ _T_)
|
|
|
|
Print formatted output to the current output stream.
|
|
|
|
|
|
*/
|
|
format(T) :-
|
|
format(T, []).
|
|
|
|
/** @pred writeln( _T_) is iso
|
|
|
|
|
|
Same as write/1 followed by nl/0.
|
|
|
|
|
|
*/
|
|
writeln(T) :-
|
|
write(T),
|
|
nl.
|
|
|
|
/* interface to user portray */
|
|
'$portray'(T) :-
|
|
\+ '$undefined'(portray(_),user),
|
|
'$system_catch'(call(portray(T)),user,Error,user:'$Error'(Error)), !,
|
|
set_value('$portray',true), fail.
|
|
'$portray'(_) :- set_value('$portray',false), fail.
|
|
|
|
/* character I/O */
|
|
|
|
/** @pred ttyget(- _C_)
|
|
|
|
|
|
The same as `get(C)`, but from stream user_input.
|
|
|
|
|
|
*/
|
|
ttyget(N) :- get(user_input,N).
|
|
|
|
/** @pred ttyget0(- _C_)
|
|
|
|
|
|
The same as `get0(C)`, but from stream user_input.
|
|
|
|
|
|
*/
|
|
ttyget0(N) :- get0(user_input,N).
|
|
|
|
/** @pred ttyskip(- _C_)
|
|
|
|
|
|
Like skip/1, but always using stream user_input.
|
|
stream.
|
|
|
|
|
|
*/
|
|
ttyskip(N) :- N1 is N, '$skip'(user_input,N1).
|
|
|
|
/** @pred ttyput(+ _N_)
|
|
|
|
|
|
As `put(N)` but always to user_output.
|
|
|
|
|
|
*/
|
|
ttyput(N) :- N1 is N, put(user_output,N1).
|
|
|
|
/** @pred ttynl
|
|
|
|
|
|
Outputs a new line to stream user_output.
|
|
|
|
|
|
|
|
|
|
*/
|
|
ttynl :- nl(user_output).
|
|
|
|
current_line_number(N) :-
|
|
current_input(Stream),
|
|
line_count(Stream, N).
|
|
|
|
/** @pred current_line_number(+ _Stream_,- _LineNumber_)
|
|
|
|
Unify _LineNumber_ with the line number for the _Stream_.
|
|
|
|
|
|
*/
|
|
current_line_number(Stream,N) :-
|
|
line_count(Stream, N).
|
|
|
|
/** @pred stream_position(+ _Stream_,- _StreamPosition_)
|
|
|
|
|
|
Unify _StreamPosition_ with the packaged information of position on
|
|
current stream _Stream_. Use stream_position_data/3 to
|
|
retrieve information on character or line count.
|
|
|
|
|
|
*/
|
|
stream_position(Stream, Position) :-
|
|
stream_property(Stream, position(Position)).
|
|
|
|
stream_position(Stream, Position, NewPosition) :-
|
|
stream_property(Stream, position(Position)),
|
|
set_stream_position(Stream, NewPosition).
|
|
|
|
at_end_of_line :-
|
|
current_input(S),
|
|
at_end_of_line(S).
|
|
|
|
at_end_of_line(S) :-
|
|
stream_property(S, end_of_stream(past)), !.
|
|
at_end_of_line(S) :-
|
|
peek_code(S,N), ( N = 10 -> true ; N = -1).
|
|
|
|
|
|
consult_depth(LV) :- '$show_consult_level'(LV).
|
|
|
|
/** @pred current_char_conversion(? _IN_,? _OUT_) is iso
|
|
|
|
|
|
If _IN_ is unbound give all current character
|
|
translations. Otherwise, give the translation for _IN_, if one
|
|
exists.
|
|
|
|
|
|
*/
|
|
current_char_conversion(X,Y) :-
|
|
var(X), !,
|
|
'$all_char_conversions'(List),
|
|
'$fetch_char_conversion'(List,X,Y).
|
|
current_char_conversion(X,Y) :-
|
|
'$current_char_conversion'(X,Y).
|
|
|
|
|
|
'$fetch_char_conversion'([X,Y|_],X,Y).
|
|
'$fetch_char_conversion'([_,_|List],X,Y) :-
|
|
'$fetch_char_conversion'(List,X,Y).
|
|
|
|
|
|
/** @pred current_stream( _F_, _M_, _S_)
|
|
|
|
|
|
Defines the relation: The stream _S_ is opened on the file _F_
|
|
in mode _M_. It might be used to obtain all open streams (by
|
|
backtracking) or to access the stream for a file _F_ in mode
|
|
_M_, or to find properties for a stream _S_. Notice that some
|
|
streams might not be associated to a file: in this case YAP tries to
|
|
return the file number. If that is not available, YAP unifies _F_
|
|
with _S_.
|
|
|
|
|
|
*/
|
|
current_stream(File, Mode, Stream) :-
|
|
stream_property(Stream, mode(Mode)),
|
|
'$stream_name'(Stream, File).
|
|
|
|
'$stream_name'(Stream, File) :-
|
|
stream_property(Stream, file_name(File)), !.
|
|
'$stream_name'(Stream, file_no(File)) :-
|
|
stream_property(Stream, file_no(File)), !.
|
|
'$stream_name'(Stream, Stream).
|
|
|
|
'$extend_file_search_path'(P) :-
|
|
atom_codes(P,S),
|
|
'$env_separator'(ES),
|
|
'$split_for_path'(S,0'=,ES,Paths), %'
|
|
'$add_file_search_paths'(Paths).
|
|
|
|
'$split_for_path'([], _, _, []).
|
|
'$split_for_path'(S, S1, S2, [A1=A2|R]) :-
|
|
'$fetch_first_path'(S, S1, A1, SR1),
|
|
'$fetch_second_path'(SR1, S2, A2, SR),
|
|
'$split_for_path'(SR, S1, S2, R) .
|
|
|
|
'$fetch_first_path'([S1|SR],S1,[],SR) :- !.
|
|
'$fetch_first_path'([C|S],S1,[C|F],SR) :-
|
|
'$fetch_first_path'(S,S1,F,SR).
|
|
|
|
'$fetch_second_path'([],_,[],[]).
|
|
'$fetch_second_path'([S1|SR],S1,[],SR) :- !.
|
|
'$fetch_second_path'([C|S],S1,[C|A2],SR) :-
|
|
'$fetch_second_path'(S,S1,A2,SR).
|
|
|
|
'$add_file_search_paths'([]).
|
|
'$add_file_search_paths'([NS=DS|Paths]) :-
|
|
atom_codes(N,NS),
|
|
atom_codes(D,DS),
|
|
assert(user:file_search_path(N,D)),
|
|
'$add_file_search_paths'(Paths).
|
|
|
|
|
|
'$format@'(Goal,Out) :-
|
|
with_output_to(codes(Out), Goal).
|
|
|
|
sformat(String, Form, Args) :-
|
|
format(codes(String, []), Form, Args).
|
|
|
|
%% stream_position_data(?Field, +Pos, ?Date)
|
|
%
|
|
% Extract values from stream position objects. '$stream_position' is
|
|
% of the format '$stream_position'(Byte, Char, Line, LinePos)
|
|
|
|
/** @pred stream_position_data(+ _Field_,+ _StreamPosition_,- _Info_)
|
|
|
|
|
|
Given the packaged stream position term _StreamPosition_, unify
|
|
_Info_ with _Field_ `line_count`, `byte_count`, or
|
|
`char_count`.
|
|
|
|
|
|
|
|
|
|
*/
|
|
stream_position_data(Prop, Term, Value) :-
|
|
nonvar(Prop), !,
|
|
( '$stream_position_field'(Prop, Pos)
|
|
-> arg(Pos, Term, Value)
|
|
; throw(error(domain_error(stream_position_data, Prop)))
|
|
).
|
|
stream_position_data(Prop, Term, Value) :-
|
|
'$stream_position_field'(Prop, Pos),
|
|
arg(Pos, Term, Value).
|
|
|
|
'$stream_position_field'(char_count, 1).
|
|
'$stream_position_field'(line_count, 2).
|
|
'$stream_position_field'(line_position, 3).
|
|
'$stream_position_field'(byte_count, 4).
|
|
|
|
|
|
'$default_expand'(Expand) :-
|
|
get_value('$open_expands_filename',Expand).
|
|
|
|
'$set_default_expand'(true) :- !,
|
|
set_value('$open_expands_filename',true).
|
|
'$set_default_expand'(false) :- !,
|
|
set_value('$open_expands_filename',false).
|
|
'$set_default_expand'(V) :- !,
|
|
'$do_error'(domain_error(flag_value,V),yap_flag(open_expands_file_name,X)).
|
|
|
|
prolog_file_name(File, PrologFileName) :-
|
|
var(File), !,
|
|
'$do_error'(instantiation_error, prolog_file_name(File, PrologFileName)).
|
|
prolog_file_name(user, Out) :- !, Out = user.
|
|
prolog_file_name(File, PrologFileName) :-
|
|
atom(File), !,
|
|
operating_system_support:true_file_name(File, PrologFileName).
|
|
prolog_file_name(File, PrologFileName) :-
|
|
'$do_error'(type_error(atom,T), prolog_file_name(File, PrologFileName)).
|
|
|
|
|
|
'$codes_to_chars'(String0, String, String0) :- String0 == String, !.
|
|
'$codes_to_chars'(String0, [Code|String], [Char|Chars]) :-
|
|
atom_codes(Char, [Code]),
|
|
'$codes_to_chars'(String0, String, Chars).
|
|
|
|
|
|
/**
|
|
@}
|
|
*/
|