This repository has been archived on 2023-08-20. You can view files and clone it, but cannot push or open issues or pull requests.
yap-6.3/H/clause.h

478 lines
14 KiB
C
Raw Normal View History

/*************************************************************************
* *
* YAP Prolog %W% %G% *
* *
* Yap Prolog was developed at NCCUP - Universidade do Porto *
* *
* Copyright L.Damas, V.S.Costa and Universidade do Porto 1985-1997 *
* *
**************************************************************************
* *
* File: clause.h *
* Last rev: *
* mods: *
* comments: clause info *
* *
*************************************************************************/
2015-07-06 12:01:55 +01:00
#ifndef CLAUSE_H
#define CLAUSE_H 1
#include "Yatom.h"
#include "YapHeap.h"
/* consulting files */
typedef union CONSULT_OBJ {
2018-07-03 10:45:22 +01:00
Atom f_name;
int mode;
2016-01-03 02:06:09 +00:00
Prop p;
UInt c;
2016-05-16 09:35:29 +01:00
Term r;
} consult_obj;
/* Either we are assembling clauses or indexing code */
2016-01-03 02:06:09 +00:00
#define ASSEMBLING_CLAUSE 0
#define ASSEMBLING_INDEX 1
#define ASSEMBLING_EINDEX 2
2016-01-03 02:06:09 +00:00
#define NextDynamicClause(X) (((yamop *)X)->y_u.Otapl.d)
2016-01-03 02:06:09 +00:00
#define PredFirstClause 0
#define PredMiddleClause 1
#define PredLastClause 2
typedef struct logic_upd_index {
2016-01-03 02:06:09 +00:00
CELL ClFlags;
UInt ClRefCount;
#if defined(YAPOR) || defined(THREADS)
2016-01-03 02:06:09 +00:00
/* A lock for manipulating the clause */
// lockvar ClLock;
#endif
2016-01-03 02:06:09 +00:00
UInt ClSize;
struct logic_upd_index *ParentIndex;
struct logic_upd_index *SiblingIndex;
struct logic_upd_index *PrevSiblingIndex;
struct logic_upd_index *ChildIndex;
/* The instructions, at least one of the form sl */
PredEntry *ClPred;
2016-01-03 02:06:09 +00:00
yamop ClCode[MIN_ARRAY];
} LogUpdIndex;
/* The ordering of the first 3 fields should be compatible with dbrefs */
typedef struct logic_upd_clause {
2016-01-03 02:06:09 +00:00
Functor Id; /* allow pointers to this struct to id */
/* as dbref */
/* A set of flags describing info on the clause */
/* A set of flags describing info on the clause */
2016-01-03 02:06:09 +00:00
CELL ClFlags;
#if defined(YAPOR) || defined(THREADS)
2016-01-03 02:06:09 +00:00
/* A lock for manipulating the clause */
// lockvar ClLock;
#endif
2016-01-03 02:06:09 +00:00
UInt ClSize;
/* extra clause information for logical update indices and facts */
/* indices that may still backtrack to this clause */
2016-01-03 02:06:09 +00:00
UInt ClRefCount;
/* data for clauses with environments */
2016-01-03 02:06:09 +00:00
yamop *ClExt;
union {
2016-01-03 02:06:09 +00:00
DBTerm *ClSource;
Int ClLine;
} lusl;
/* doubly linked list of clauses */
2016-01-03 02:06:09 +00:00
struct logic_upd_clause *ClPrev, *ClNext;
/* parent pointer */
2016-01-03 02:06:09 +00:00
PredEntry *ClPred;
UInt ClTimeStart, ClTimeEnd;
/* The instructions, at least one of the form sl */
2016-01-03 02:06:09 +00:00
yamop ClCode[MIN_ARRAY];
} LogUpdClause;
2012-06-29 22:44:08 +01:00
#include "inline-only.h"
2018-06-18 12:16:36 +01:00
INLINE_ONLY int VALID_TIMESTAMP(UInt, struct logic_upd_clause *);
2018-06-18 12:16:36 +01:00
INLINE_ONLY int VALID_TIMESTAMP(UInt timestamp,
2016-01-03 02:06:09 +00:00
struct logic_upd_clause *cl) {
2019-03-06 10:49:55 +00:00
// printf("%lu %lu %lu\n",cl->ClTimeStart, timestamp, cl->ClTimeEnd);
return IN_BETWEEN(cl->ClTimeStart, timestamp, cl->ClTimeEnd);
2019-03-06 10:49:55 +00:00
}
typedef struct dynamic_clause {
/* A set of flags describing info on the clause */
2016-01-03 02:06:09 +00:00
CELL ClFlags;
#if defined(YAPOR) || defined(THREADS)
/* A lock for manipulating the clause */
2016-01-03 02:06:09 +00:00
lockvar ClLock;
#endif
2016-01-03 02:06:09 +00:00
UInt ClSize;
Int ClLine;
UInt ClRefCount;
yamop *ClPrevious; /* immediate update clause */
/* The instructions, at least one of the form sl */
2016-01-03 02:06:09 +00:00
yamop ClCode[MIN_ARRAY];
} DynamicClause;
typedef struct static_index {
/* A set of flags describing info on the clause */
2016-01-03 02:06:09 +00:00
CELL ClFlags;
UInt ClSize;
struct static_index *SiblingIndex;
struct static_index *ChildIndex;
/* The instructions, at least one of the form sl */
PredEntry *ClPred;
2016-01-03 02:06:09 +00:00
yamop ClCode[MIN_ARRAY];
} StaticIndex;
typedef struct static_clause {
/* A set of flags describing info on the clause */
2016-01-03 02:06:09 +00:00
CELL ClFlags;
UInt ClSize;
union {
2016-01-03 02:06:09 +00:00
DBTerm *ClSource;
Int ClLine;
} usc;
2016-01-03 02:06:09 +00:00
struct static_clause *ClNext;
/* The instructions, at least one of the form sl */
2016-01-03 02:06:09 +00:00
yamop ClCode[MIN_ARRAY];
} StaticClause;
typedef struct static_mega_clause {
/* A set of flags describing info on the clause */
2016-01-03 02:06:09 +00:00
CELL ClFlags;
UInt ClSize;
PredEntry *ClPred;
UInt ClItemSize;
Int ClLine;
struct static_mega_clause *ClNext;
/* The instructions, at least one of the form sl */
2016-01-03 02:06:09 +00:00
yamop ClCode[MIN_ARRAY];
} MegaClause;
typedef union clause_obj {
struct logic_upd_clause luc;
struct logic_upd_index lui;
struct dynamic_clause ic;
struct static_clause sc;
struct static_mega_clause mc;
struct static_index si;
} ClauseUnion;
typedef union clause_ptr {
struct logic_upd_clause *luc;
struct logic_upd_index *lui;
struct dynamic_clause *ic;
struct static_clause *sc;
struct static_mega_clause *mc;
struct static_index *si;
} ClausePointer;
2013-01-07 09:47:14 +00:00
typedef struct index_t {
struct index_t *next, *prev;
UInt nels;
UInt arity;
PredEntry *ap;
CELL bmap;
int is_key;
2013-04-17 02:04:53 +01:00
int is_udi;
2013-01-09 16:38:39 +00:00
UInt ncollisions;
2013-08-05 21:07:51 +01:00
UInt max_col_count;
2013-01-09 16:38:39 +00:00
UInt ntrys;
UInt nentries;
2013-01-07 09:47:14 +00:00
UInt hsize;
BITS32 *key;
2013-06-23 02:09:20 +01:00
CELL *cls, *bcls;
BITS32 *links;
2013-01-23 10:43:32 +00:00
size_t size;
2013-01-07 09:47:14 +00:00
yamop *code;
2013-04-29 22:19:43 +01:00
BITS32 *udi_data;
void *udi_first, *udi_next;
2013-06-26 04:53:23 +01:00
UInt udi_free_args;
2013-04-21 02:29:08 +01:00
UInt udi_arg;
2013-01-07 09:47:14 +00:00
} Index_t;
2018-06-18 12:16:36 +01:00
INLINE_ONLY BITS32 EXO_ADDRESS_TO_OFFSET(struct index_t *it,
2016-01-03 02:06:09 +00:00
CELL *ptr);
2013-01-08 12:35:18 +00:00
2018-06-18 12:16:36 +01:00
INLINE_ONLY BITS32 EXO_ADDRESS_TO_OFFSET(struct index_t *it,
2016-01-03 02:06:09 +00:00
CELL *ptr) {
return (ptr - it->cls) / it->arity + 1;
2013-01-08 12:35:18 +00:00
}
2018-06-18 12:16:36 +01:00
INLINE_ONLY CELL *EXO_OFFSET_TO_ADDRESS(struct index_t *it,
2016-01-03 02:06:09 +00:00
BITS32 off);
2013-01-08 12:35:18 +00:00
2018-06-18 12:16:36 +01:00
INLINE_ONLY CELL *EXO_OFFSET_TO_ADDRESS(struct index_t *it,
2016-01-03 02:06:09 +00:00
BITS32 off) {
2015-04-13 13:28:17 +01:00
if (off == 0L)
2014-06-12 01:25:50 +01:00
return (CELL *)NULL;
2016-01-03 02:06:09 +00:00
return (it->cls) + (off - 1) * it->arity;
}
2018-06-18 12:16:36 +01:00
INLINE_ONLY BITS32 ADDRESS_TO_LINK(struct index_t *it,
2016-01-03 02:06:09 +00:00
BITS32 *ptr);
2018-06-18 12:16:36 +01:00
INLINE_ONLY BITS32 ADDRESS_TO_LINK(struct index_t *it,
2016-01-03 02:06:09 +00:00
BITS32 *ptr) {
return ptr - it->links;
}
2018-06-18 12:16:36 +01:00
INLINE_ONLY BITS32 *LINK_TO_ADDRESS(struct index_t *it,
2016-01-03 02:06:09 +00:00
BITS32 off);
2018-06-18 12:16:36 +01:00
INLINE_ONLY BITS32 *LINK_TO_ADDRESS(struct index_t *it,
2016-01-03 02:06:09 +00:00
BITS32 off) {
return it->links + off;
2013-01-08 12:35:18 +00:00
}
2013-04-17 03:49:37 +01:00
typedef void (*CRefitExoIndex)(struct index_t **ip, UInt b[] USES_REGS);
2016-01-03 02:06:09 +00:00
typedef yamop *(*CEnterExoIndex)(struct index_t *it USES_REGS);
typedef int (*CRetryExoIndex)(struct index_t *it USES_REGS);
2013-01-07 09:47:14 +00:00
typedef struct dbterm_list {
/* a list of dbterms associated with a clause */
DBTerm *dbterms;
yamop *clause_code;
PredEntry *p;
struct dbterm_list *next_dbl;
} DBTermList;
2016-01-03 02:06:09 +00:00
#define ClauseCodeToDynamicClause(p) \
((DynamicClause *)((CODEADDR)(p) - (CELL)(((DynamicClause *)NULL)->ClCode)))
#define ClauseCodeToStaticClause(p) \
((StaticClause *)((CODEADDR)(p) - (CELL)(((StaticClause *)NULL)->ClCode)))
#define ClauseCodeToLogUpdClause(p) \
((LogUpdClause *)((CODEADDR)(p) - (CELL)(((LogUpdClause *)NULL)->ClCode)))
#define ClauseCodeToMegaClause(p) \
((MegaClause *)((CODEADDR)(p) - (CELL)(((MegaClause *)NULL)->ClCode)))
#define ClauseCodeToLogUpdIndex(p) \
((LogUpdIndex *)((CODEADDR)(p) - (CELL)(((LogUpdIndex *)NULL)->ClCode)))
#define ClauseCodeToStaticIndex(p) \
((StaticIndex *)((CODEADDR)(p) - (CELL)(((StaticIndex *)NULL)->ClCode)))
#define ClauseFlagsToDynamicClause(p) ((DynamicClause *)(p))
#define ClauseFlagsToLogUpdClause(p) \
((LogUpdClause *)((CODEADDR)(p) - (CELL)(&(((LogUpdClause *)NULL)->ClFlags))))
#define ClauseFlagsToLogUpdIndex(p) \
((LogUpdIndex *)((CODEADDR)(p) - (CELL)(&(((LogUpdIndex *)NULL)->ClFlags))))
#define ClauseFlagsToStaticClause(p) ((StaticClause *)(p))
#define DynamicFlags(X) (ClauseCodeToDynamicClause(X)->ClFlags)
#define DynamicLock(X) (ClauseCodeToDynamicClause(X)->ClLock)
#if MULTIPLE_STACKS
#define INIT_CLREF_COUNT(X) (X)->ClRefCount = 0
2016-01-03 02:06:09 +00:00
#define INC_CLREF_COUNT(X) (X)->ClRefCount++
#define DEC_CLREF_COUNT(X) (X)->ClRefCount--
2016-01-03 02:06:09 +00:00
#define CL_IN_USE(X) ((X)->ClRefCount)
#else
#define INIT_CLREF_COUNT(X)
2016-01-03 02:06:09 +00:00
#define INC_CLREF_COUNT(X)
#define DEC_CLREF_COUNT(X)
#define CL_IN_USE(X) ((X)->ClFlags & InUseMask || (X)->ClRefCount)
#endif
/* amasm.c */
2016-01-03 02:06:09 +00:00
wamreg Yap_emit_x(CELL);
COUNT Yap_compile_cmp_flags(PredEntry *);
void Yap_InitComma(void);
2016-09-21 20:59:30 +01:00
yamop *Yap_InitCommaContinuation(PredEntry *);
/* cdmgr.c */
2016-01-03 02:06:09 +00:00
void Yap_IPred(PredEntry *, UInt, yamop *);
bool Yap_addclause(Term, yamop *, Term, Term, Term *);
2016-01-03 02:06:09 +00:00
void Yap_add_logupd_clause(PredEntry *, LogUpdClause *, int);
void Yap_kill_iblock(ClauseUnion *, ClauseUnion *, PredEntry *);
void Yap_EraseStaticClause(StaticClause *, PredEntry *, Term);
2013-04-25 23:15:04 +01:00
ClauseUnion *Yap_find_owner_index(yamop *, PredEntry *);
/* dbase.c */
2016-01-03 02:06:09 +00:00
void Yap_ErCl(DynamicClause *);
void Yap_ErLogUpdCl(LogUpdClause *);
void Yap_ErLogUpdIndex(LogUpdIndex *);
Int Yap_Recordz(Atom, Term);
Int Yap_db_nth_recorded(PredEntry *, Int USES_REGS);
Int Yap_unify_immediate_ref(DBRef ref USES_REGS);
/* exec.c */
2016-01-03 02:06:09 +00:00
Term Yap_cp_as_integer(choiceptr);
/* index.c */
2016-01-03 02:06:09 +00:00
yamop *Yap_PredIsIndexable(PredEntry *, UInt, yamop *);
yamop *Yap_ExpandIndex(PredEntry *, UInt);
void Yap_CleanUpIndex(struct logic_upd_index *);
void Yap_CleanKids(struct logic_upd_index *);
void Yap_AddClauseToIndex(PredEntry *, yamop *, int);
void Yap_RemoveClauseFromIndex(PredEntry *, yamop *);
LogUpdClause *Yap_NthClause(PredEntry *, Int);
LogUpdClause *Yap_FollowIndexingCode(PredEntry *, yamop *, Term *, yamop *,
yamop *);
2013-01-07 09:47:14 +00:00
/* exo.c */
2016-01-03 02:06:09 +00:00
yamop *Yap_ExoLookup(PredEntry *ap USES_REGS);
CELL Yap_NextExo(choiceptr cpt, struct index_t *it);
2013-01-07 09:47:14 +00:00
2015-04-13 13:28:17 +01:00
#
#if USE_THREADED_CODE
#define OP_HASH_SIZE 2048
2018-06-18 12:16:36 +01:00
INLINE_ONLY int rtable_hash_op(OPCODE opc, int hash_mask);
2018-06-18 12:16:36 +01:00
INLINE_ONLY int rtable_hash_op(OPCODE opc, int hash_mask) {
2016-01-03 02:06:09 +00:00
return ((((CELL)opc) >> 3) & hash_mask);
}
2018-06-18 12:16:36 +01:00
INLINE_ONLY op_numbers Yap_op_from_opcode(OPCODE opc);
/* given an opcode find the corresponding opnumber. This should make
switches on ops a much easier operation */
2018-06-18 12:16:36 +01:00
INLINE_ONLY op_numbers Yap_op_from_opcode(OPCODE opc) {
2016-01-03 02:06:09 +00:00
int j = rtable_hash_op(opc, OP_HASH_SIZE - 1);
while (OP_RTABLE[j].opc != opc) {
if (!OP_RTABLE[j].opc)
return _Nstop;
2016-01-03 02:06:09 +00:00
if (j == OP_HASH_SIZE - 1) {
j = 0;
} else {
j++;
}
}
return OP_RTABLE[j].opnum;
}
#else
2016-01-03 02:06:09 +00:00
static inline op_numbers Yap_op_from_opcode(OPCODE opc) {
return ((op_numbers)opc);
}
#endif /* USE_THREADED_CODE */
#if defined(YAPOR) || defined(THREADS)
static inline int same_lu_block(yamop **, yamop *);
2016-01-03 02:06:09 +00:00
static inline int same_lu_block(yamop **paddr, yamop *p) {
yamop *np = *paddr;
if (np != p) {
OPCODE jmp_op = Yap_opcode(_jump_if_nonvar);
while (np->opc == jmp_op) {
np = NEXTOP(np, xll);
2016-01-03 02:06:09 +00:00
if (np == p)
return TRUE;
}
return FALSE;
} else {
return TRUE;
}
}
#endif
2016-01-03 02:06:09 +00:00
#define Yap_MkStaticRefTerm(cp, ap) __Yap_MkStaticRefTerm((cp), (ap)PASS_REGS)
2016-01-03 02:06:09 +00:00
static inline Term __Yap_MkStaticRefTerm(StaticClause *cp,
PredEntry *ap USES_REGS) {
Term t[2];
t[0] = MkIntegerTerm((Int)cp);
t[1] = MkIntegerTerm((Int)ap);
2016-01-03 02:06:09 +00:00
return Yap_MkApplTerm(FunctorStaticClause, 2, t);
}
2016-01-03 02:06:09 +00:00
static inline StaticClause *Yap_ClauseFromTerm(Term t) {
return (StaticClause *)IntegerOfTerm(ArgOfTerm(1, t));
}
2016-01-03 02:06:09 +00:00
#define Yap_MkMegaRefTerm(ap, ipc) __Yap_MkMegaRefTerm((ap), (ipc)PASS_REGS)
2016-01-03 02:06:09 +00:00
static inline Term __Yap_MkMegaRefTerm(PredEntry *ap, yamop *ipc USES_REGS) {
Term t[2];
t[0] = MkIntegerTerm((Int)ap);
t[1] = MkIntegerTerm((Int)ipc);
2016-01-03 02:06:09 +00:00
return Yap_MkApplTerm(FunctorMegaClause, 2, t);
}
2016-01-03 02:06:09 +00:00
static inline yamop *Yap_MegaClauseFromTerm(Term t) {
return (yamop *)IntegerOfTerm(ArgOfTerm(2, t));
}
2016-01-03 02:06:09 +00:00
static inline PredEntry *Yap_MegaClausePredicateFromTerm(Term t) {
return (PredEntry *)IntegerOfTerm(ArgOfTerm(1, t));
}
2016-01-03 02:06:09 +00:00
#define Yap_MkExoRefTerm(ap, i) __Yap_MkExoRefTerm((ap), (i)PASS_REGS)
2016-01-03 02:06:09 +00:00
static inline Term __Yap_MkExoRefTerm(PredEntry *ap, Int i USES_REGS) {
Term t[2];
t[0] = MkIntegerTerm((Int)ap);
t[1] = MkIntegerTerm((Int)i);
2016-01-03 02:06:09 +00:00
return Yap_MkApplTerm(FunctorExoClause, 2, t);
}
2016-01-03 02:06:09 +00:00
static inline Int Yap_ExoClauseFromTerm(Term t) {
return IntegerOfTerm(ArgOfTerm(2, t));
}
2016-01-03 02:06:09 +00:00
static inline PredEntry *Yap_ExoClausePredicateFromTerm(Term t) {
return (PredEntry *)IntegerOfTerm(ArgOfTerm(1, t));
}
2015-09-21 23:05:36 +01:00
/******************************************************************
2016-01-03 02:06:09 +00:00
EXECUTING PROLOG CLAUSES
2015-09-21 23:05:36 +01:00
******************************************************************/
2016-01-03 02:06:09 +00:00
bool Yap_search_for_static_predicate_in_use(PredEntry *p,
bool check_everything);
2016-01-03 02:06:09 +00:00
static inline bool Yap_static_in_use(PredEntry *p, bool check_everything) {
2015-09-21 23:05:36 +01:00
#if defined(YAPOR) || defined(THREADS)
return TRUE;
#else
pred_flags_t pflags = p->PredFlags;
2016-01-03 02:06:09 +00:00
if (pflags & (DynamicPredFlag | LogUpdatePredFlag)) {
2015-09-21 23:05:36 +01:00
return FALSE;
}
if (STATIC_PREDICATES_MARKED) {
return (p->PredFlags & InUsePredFlag);
} else {
/* This code does not work for YAPOR or THREADS!!!!!!!! */
return Yap_search_for_static_predicate_in_use(p, check_everything);
}
#endif
#define DEAD_REF(ref) FALSE
}
typedef enum {
FIND_PRED_FROM_ANYWHERE,
FIND_PRED_FROM_CP,
FIND_PRED_FROM_ENV
} find_pred_type;
2016-01-03 02:06:09 +00:00
Int Yap_PredForCode(yamop *, find_pred_type, Atom *, UInt *, Term *);
PredEntry *Yap_PredEntryForCode(yamop *, find_pred_type, void **, void **);
LogUpdClause *Yap_new_ludbe(Term, PredEntry *, UInt);
Term Yap_LUInstance(LogUpdClause *, UInt);
/* udi.c */
2018-04-02 14:49:45 +01:00
extern int Yap_new_udi_clause(PredEntry *, yamop *, Term);
extern yamop *Yap_udi_search(PredEntry *);
2018-04-02 14:49:45 +01:00
extern yap_error_descriptor_t *Yap_bug_location(yap_error_descriptor_t *t, yamop *p, yamop *cp, choiceptr b_ptr, void *env);
extern yap_error_descriptor_t *Yap_pc_add_location(yap_error_descriptor_t *t, void *p, void *b_ptr, void *env);
extern yap_error_descriptor_t * Yap_env_add_location(yap_error_descriptor_t *t, void *p, void *b_ptr, void *env, YAP_Int ignore_first);
2019-04-20 12:48:33 +01:00
void Yap_split_megaclause(PredEntry *ap);
2016-01-03 02:06:09 +00:00
#if LOW_PROF
void Yap_InformOfRemoval(void *);
void Yap_dump_code_area_for_profiler(void);
#else
2016-01-03 02:06:09 +00:00
#define Yap_InformOfRemoval(X)
#endif
2015-07-06 12:01:55 +01:00
#endif