home *** CD-ROM | disk | FTP | other *** search
/ Language/OS - Multiplatform Resource Library / LANGUAGE OS.iso / prolog / modprolg / mod-prol.lha / Prolog / modlib / src / $retr.P < prev    next >
Encoding:
Text File  |  1992-05-11  |  5.8 KB  |  155 lines
  1. /************************************************************************
  2. *                                    *
  3. * The SB-Prolog System                            *
  4. * Copyright SUNY at Stony Brook, 1986; University of Arizona, 1987    *
  5. *                                    *
  6. ************************************************************************/
  7.  
  8. /*-----------------------------------------------------------------
  9. SB-Prolog is distributed in the hope that it will be useful,
  10. but WITHOUT ANY WARRANTY.  No author or distributor
  11. accepts responsibility to anyone for the consequences of using it
  12. or for whether it serves any particular purpose or works at all,
  13. unless he says so in writing.  Refer to the SB-Prolog General Public
  14. License for full details.
  15.  
  16. Everyone is granted permission to copy, modify and redistribute
  17. SB-Prolog, but only under the conditions described in the
  18. SB-Prolog General Public License.   A copy of this license is
  19. supposed to have been given to you along with SB-Prolog so you
  20. can know your rights and responsibilities.  It should be in a
  21. file named COPYING.  Among other things, the copyright notice
  22. and this notice must be preserved on all copies. 
  23. ------------------------------------------------------------------ */
  24.  
  25. /****************************************************************************
  26.  *                                                                          *
  27.  * This file has been changed by to include Modules Extensions              *
  28.  * Changes by : Brian Paxton 1991/92                                        *
  29.  * Last update : June 1992                                                  *
  30.  *                                                                          *
  31.  * Organisation : University of Edinburgh.                                  *
  32.  * For : Departments of Computer Science and Artificial Intelligence        * 
  33.  *       Fourth Year Project.                                               *
  34.  *                                                                          *
  35.  ****************************************************************************/
  36.  
  37. /* $retr.P */
  38.  
  39. /* retract routines */
  40.  
  41. $retr_export([$retract/1,$retr_abolish/1,$retr_abolish/2,$update/2,
  42.           $retractall/1,$retract/2,$retractall/2]).
  43.  
  44. % $retr_use : $bmeta, $buff, $db, $assert, $modules, $decompile
  45.  
  46. /* this routine $retracts facts. It does so by running the chain of buffers,
  47.    explicitly. When it finds a fact that unifies, it overwrites the first
  48.    instruction in the buffer (after the retrymeelse instruction) to be a 
  49.    fail. This is somewhat of a kludge but is easy. Besides you shouldn't be
  50.    using $retract anyway. */
  51.  
  52. $retract(Clause) :-
  53.     $retract(Clause,perv).
  54.  
  55. % Clauses are now preprocessed to check that they are not functions and are
  56. % then moved to the required structure before the retract is issued.
  57. % (Similar to code for assert).
  58.  
  59. $retract(Clause,Tag) :-
  60.     ( $isa_structuretag(Tag) ->
  61.           ( $retr_chk_clause(Clause) ->
  62.            ( ( Tag = perv -> Clause2 = Clause ;
  63.                  ( $check_destination(Clause,Oldtag),
  64.                    $move_clause(Clause,Oldtag,Tag,Clause1),
  65.                    $fun_rel(Clause1,Clause2,Tag) ) ),
  66.              $check_not_function(Clause2),
  67.              ((Clause2 = (Head :- Body) ->
  68.                   true ;
  69.                   (Clause2 = Head, Body = true)
  70.               ),!,
  71.               $clause(Head,Body,Ref),
  72.               $erase(Ref)
  73.              ) ;
  74.              ($telling(X), $tell(stderr),
  75.               $write('*** Error: illegal argument to retract: '),
  76.               $write(Clause), $nl,
  77.               $told, $tell(X)
  78.              ) ) ) ;
  79.           ( $telling(X), $tell(stderr),
  80.         $writename('*** Error: Second arg to retract/2 must be a structure tag'),
  81.         $nl, $told, $tell(X) ) ).
  82.  
  83. $retr_chk_clause(Cl) :- $atom(Cl).
  84. $retr_chk_clause(Cl) :-
  85.      $structure(Cl),
  86.      (Cl = (Hd :- Body) -> $retr_chk_hd(Hd) ; true).
  87.  
  88. $retr_chk_hd(Hd) :- $atom(Hd).
  89. $retr_chk_hd(Hd) :- $structure(Hd), Hd \= (_ :- _).
  90.  
  91. $retr_abolish(Goal) :- $buff_code(Goal,0,11,0).
  92. $retr_abolish(Pred,Arity) :-
  93.     ($atom(Pred), integer(Arity)) ->
  94.         ($functor(Term,Pred,Arity), $retr_abolish(Term)) ;
  95.         ($writename('*** abolish: illegal argument: '),
  96.          $write(Pred), $writename('/'), $write(Arity), $nl,
  97.          fail
  98.         ).
  99.  
  100. /* the following routines allow a tuple to be updated in a very limited way.
  101. Using these operations, you can change the value of an existing tuple in the
  102. database. The tuple must have been asserted, and only the first field
  103. can be changed and only if it is a constant or an integer. */
  104.  
  105. /* $upda_clref(Newval,Clref): Newval must be bound to a constant or integer, 
  106. and Clref must be bound to a clause reference. The first field of the tuple
  107. in Clref must be a constant or integer. This operation resets that first 
  108. field to Newval. */
  109.  
  110. $upda_clref(Newval,Clref) :- 
  111.     integer(Newval),!,
  112.     $buff_code(Clref,10,6 /*gb*/ ,14 /*getnumcon*/), /* right already */
  113.     $buff_code(Clref,12,2 /*pn*/ ,Newval).
  114.  
  115. $upda_clref(Newval,Clref) :- 
  116.     $atom(Newval),!,
  117.     $buff_code(Clref,10,6 /*gb*/ ,4 /*getcon*/), /*must already be right*/
  118.     $buff_code(Clref,12,1 /*pppsc*/ ,Newval).
  119.  
  120. $update(Fact,Newval) :-
  121.     $assert_get_prref(Fact,Prref),$db_call_prref_s(Fact,Prref,Clref),
  122.     $upda_clref(Newval,Clref).
  123.  
  124. $retractall(Hd) :-
  125.     $retractall(Hd,perv).
  126.  
  127. % Again, extensions here are so references to remote structures can be used.
  128. % See above.
  129.  
  130. $retractall(Hd,Tag) :-
  131.     ( $isa_structuretag(Tag)
  132.          -> ( $retr_chk_hd(Hd) ->
  133.             ( ( Tag == perv -> Hd1 = Hd ;
  134.                       ( $check_destination(Hd,Oldtag),
  135.                     $move_clause(Hd,Oldtag,Tag,Hd1) ) ),
  136.               $check_not_function(Hd1),
  137.               $retractall1(Hd1) ) ;
  138.             ($telling(X), $tell(stderr),
  139.              $write('*** Error: illegal argument to retractall/1: '),
  140.              $write(Hd), $nl,
  141.              $told, $tell(X)));
  142.           ( $telling(X), $tell(stderr),
  143.         $writename('*** Error: Second arg to retractall/2 must be a structure tag'),
  144.         $nl, $told, $tell(X) ) ).
  145.  
  146. $retractall1(Hd) :-
  147.      $clause(Hd,_,Ref),
  148.      $erase(Ref),
  149.      fail.
  150. $retractall1(_).
  151.  
  152.  
  153. /* ------------------------------ $retr.P ------------------------------ */
  154.  
  155.