1 /********************* */
4 ** Top contributors (to current version):
5 ** Morgan Deters, Dejan Jovanovic, Andrew Reynolds
6 ** This file is part of the CVC4 project.
7 ** Copyright (c) 2009-2017 by the authors listed in the file AUTHORS
8 ** in the top-level source directory) and their institutional affiliations.
9 ** All rights reserved. See the file COPYING in the top-level source
10 ** directory for licensing information.\endverbatim
12 ** \brief A "valuation" proxy for TheoryEngine
14 ** A "valuation" proxy for TheoryEngine. This class breaks the dependence
15 ** of theories' getValue() implementations on TheoryEngine. getValue()
16 ** takes a Valuation, which delegates to TheoryEngine.
19 #include "cvc4_private.h"
21 #ifndef __CVC4__THEORY__VALUATION_H
22 #define __CVC4__THEORY__VALUATION_H
24 #include "expr/node.h"
25 #include "options/theoryof_mode.h"
33 class EntailmentCheckParameters
;
34 class EntailmentCheckSideEffects
;
38 * The status of an equality in the current context.
41 /** The equality is known to be true and has been propagated */
42 EQUALITY_TRUE_AND_PROPAGATED
,
43 /** The equality is known to be false and has been propagated */
44 EQUALITY_FALSE_AND_PROPAGATED
,
45 /** The equality is known to be true */
47 /** The equality is known to be false */
49 /** The equality is not known, but is true in the current model */
50 EQUALITY_TRUE_IN_MODEL
,
51 /** The equality is not known, but is false in the current model */
52 EQUALITY_FALSE_IN_MODEL
,
53 /** The equality is completely unknown */
55 };/* enum EqualityStatus */
57 std::ostream
& operator<<(std::ostream
& os
, EqualityStatus s
);
60 * Returns true if the two statuses are compatible, i.e. both TRUE
61 * or both FALSE (regardless of inmodel/propagation).
63 bool equalityStatusCompatible(EqualityStatus s1
, EqualityStatus s2
);
66 TheoryEngine
* d_engine
;
68 Valuation(TheoryEngine
* engine
) :
73 * Return true if n has an associated SAT literal
75 bool isSatLiteral(TNode n
) const;
78 * Get the current SAT assignment to the node n.
80 * This is only permitted if n is a theory atom that has an associated
81 * SAT literal (or its negation).
83 * @return Node::null() if no current assignment; otherwise true or false.
85 Node
getSatValue(TNode n
) const;
88 * Returns true if the node has a current SAT assignment. If yes, the
89 * argument "value" is set to its value.
91 * This is only permitted if n is a theory atom that has an associated
94 * @return true if the literal has a current assignment, and returns the
95 * value in the "value" argument; otherwise false and the "value"
96 * argument is unmodified.
98 bool hasSatValue(TNode n
, bool& value
) const;
101 * Returns the equality status of the two terms, from the theory that owns the domain type.
102 * The types of a and b must be the same.
104 EqualityStatus
getEqualityStatus(TNode a
, TNode b
);
107 * Returns the model value of the shared term (or null if not available).
109 Node
getModelValue(TNode var
);
112 * Returns pointer to model.
114 TheoryModel
* getModel();
117 * Ensure that the given node will have a designated SAT literal
118 * that is definitionally equal to it. The result of this function
119 * is a Node that can be queried via getSatValue().
121 * @return the actual node that's been "literalized," which may
122 * differ from the input due to theory-rewriting and preprocessing,
123 * as well as CNF conversion
125 Node
ensureLiteral(TNode n
) CVC4_WARN_UNUSED_RESULT
;
128 * Returns whether the given lit (which must be a SAT literal) is a decision
129 * literal or not. Throws an exception if lit is not a SAT literal. "lit" may
130 * be in either phase; that is, if "lit" is a SAT literal, this function returns
131 * true both for lit and the negation of lit.
133 bool isDecision(Node lit
) const;
136 * Get the assertion level of the SAT solver.
138 unsigned getAssertionLevel() const;
141 * Request an entailment check according to the given theoryOfMode.
142 * See theory.h for documentation on entailmentCheck().
144 std::pair
<bool, Node
> entailmentCheck(theory::TheoryOfMode mode
, TNode lit
, const theory::EntailmentCheckParameters
* params
= NULL
, theory::EntailmentCheckSideEffects
* out
= NULL
);
147 bool needCheck() const;
149 };/* class Valuation */
151 }/* CVC4::theory namespace */
152 }/* CVC4 namespace */
154 #endif /* __CVC4__THEORY__VALUATION_H */