3
0
Fork 0
mirror of https://github.com/Z3Prover/z3 synced 2026-03-07 22:04:53 +00:00
z3/src/smt/theory_nseq.cpp
Nikolaj Bjorner 58b57b2632 Add Phase 2: core data structures for theory_nseq
- nseq_constraint.h: constraint types (nseq_eq, nseq_ne, nseq_mem,
  nseq_pred) with dependency tracking via scoped_dependency_manager
- nseq_state.h/cpp: backtrackable state management with scoped_vector
  collections, axiom queue, length tracking, linearization for
  conflict/propagation justifications, statistics, display
- theory_nseq.h/cpp: full internalization (term/atom/bool), equality
  and disequality handling with union-find, literal assignment dispatch
  (prefix/suffix/contains/in_re), axiom management, propagation
  helpers (propagate_eq/lit, set_conflict), scope push/pop wired
  to nseq_state

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-02-27 17:26:10 -08:00

409 lines
13 KiB
C++

/*++
Copyright (c) 2025 Microsoft Corporation
Module Name:
theory_nseq.cpp
Abstract:
Theory solver for strings based on Nielsen transformations
and lazy regex membership (ZIPT algorithm).
Author:
Clemens Eisenhofer
Nikolaj Bjorner (nbjorner) 2025-2-28
--*/
#include "ast/ast_pp.h"
#include "ast/ast_trail.h"
#include "smt/theory_nseq.h"
#include "smt/smt_context.h"
namespace smt {
theory_nseq::theory_nseq(context& ctx)
: theory(ctx, ctx.get_manager().mk_family_id("seq")),
m_util(ctx.get_manager()),
m_autil(ctx.get_manager()),
m_seq_rewrite(ctx.get_manager()),
m_rewrite(ctx.get_manager()),
m_sk(ctx.get_manager(), m_rewrite),
m_arith_value(ctx.get_manager()),
m_state(ctx.get_manager(), m_util),
m_find(*this),
m_has_seq(false),
m_new_propagation(false) {
}
theory_nseq::~theory_nseq() {
}
void theory_nseq::init() {
m_arith_value.init(&ctx);
}
// -------------------------------------------------------
// Final check
// -------------------------------------------------------
final_check_status theory_nseq::final_check_eh(unsigned) {
if (!m_has_seq)
return FC_DONE;
TRACE(seq, display(tout << "final_check level=" << ctx.get_scope_level() << "\n"););
// Process pending axioms
if (m_state.has_pending_axioms()) {
unsigned head = m_state.axioms_head();
auto const& axioms = m_state.axioms();
for (unsigned i = head; i < axioms.size(); ++i)
deque_axiom(axioms[i]);
m_state.set_axioms_head(axioms.size());
return FC_CONTINUE;
}
// TODO: implement Nielsen transformation-based solving
// TODO: implement regex membership checking
// TODO: implement length/Parikh reasoning
return FC_GIVEUP;
}
// -------------------------------------------------------
// Internalization
// -------------------------------------------------------
bool theory_nseq::internalize_atom(app* a, bool) {
return internalize_term(a);
}
bool theory_nseq::internalize_term(app* term) {
if (!m_has_seq) {
ctx.push_trail(value_trail<bool>(m_has_seq));
m_has_seq = true;
}
if (m_util.str.is_in_re(term))
mk_var(ensure_enode(term->get_arg(0)));
if (m_util.str.is_length(term))
mk_var(ensure_enode(term->get_arg(0)));
if (ctx.e_internalized(term)) {
mk_var(ctx.get_enode(term));
return true;
}
if (m.is_bool(term) &&
(m_util.str.is_in_re(term) || m_sk.is_skolem(term))) {
bool_var bv = ctx.mk_bool_var(term);
ctx.set_var_theory(bv, get_id());
ctx.mark_as_relevant(bv);
return true;
}
for (auto arg : *term)
mk_var(ensure_enode(arg));
if (m.is_bool(term)) {
bool_var bv = ctx.mk_bool_var(term);
ctx.set_var_theory(bv, get_id());
ctx.mark_as_relevant(bv);
}
enode* e = nullptr;
if (ctx.e_internalized(term))
e = ctx.get_enode(term);
else
e = ctx.mk_enode(term, false, m.is_bool(term), true);
mk_var(e);
if (!ctx.relevancy())
relevant_eh(term);
return true;
}
void theory_nseq::internalize_eq_eh(app* atom, bool_var v) {
}
theory_var theory_nseq::mk_var(enode* n) {
expr* o = n->get_expr();
if (!m_util.is_seq(o) && !m_util.is_re(o))
return null_theory_var;
if (is_attached_to_var(n))
return n->get_th_var(get_id());
theory_var v = theory::mk_var(n);
m_find.mk_var();
ctx.attach_th_var(n, this, v);
ctx.mark_as_relevant(n);
return v;
}
void theory_nseq::apply_sort_cnstr(enode* n, sort* s) {
mk_var(n);
}
// -------------------------------------------------------
// Equality and disequality callbacks
// -------------------------------------------------------
void theory_nseq::new_eq_eh(theory_var v1, theory_var v2) {
enode* n1 = get_enode(v1);
enode* n2 = get_enode(v2);
expr* o1 = n1->get_expr();
expr* o2 = n2->get_expr();
if (!m_util.is_seq(o1) && !m_util.is_re(o1))
return;
nseq_dependency* dep = m_state.mk_dep(n1, n2);
if (m_util.is_seq(o1)) {
if (m_find.find(v1) != m_find.find(v2))
m_find.merge(v1, v2);
m_state.add_eq(o1, o2, dep);
TRACE(seq, tout << "new eq: " << mk_bounded_pp(o1, m) << " = " << mk_bounded_pp(o2, m) << "\n";);
}
}
void theory_nseq::new_diseq_eh(theory_var v1, theory_var v2) {
enode* n1 = get_enode(v1);
enode* n2 = get_enode(v2);
expr* e1 = n1->get_expr();
expr* e2 = n2->get_expr();
if (!m_util.is_seq(e1))
return;
if (n1->get_root() == n2->get_root())
return;
literal lit = mk_eq(e1, e2, false);
nseq_dependency* dep = m_state.mk_dep(~lit);
m_state.add_ne(e1, e2, dep);
TRACE(seq, tout << "new diseq: " << mk_bounded_pp(e1, m) << " != " << mk_bounded_pp(e2, m) << "\n";);
}
// -------------------------------------------------------
// Assignment callback
// -------------------------------------------------------
void theory_nseq::assign_eh(bool_var v, bool is_true) {
expr* e = ctx.bool_var2expr(v);
expr* e1 = nullptr, *e2 = nullptr;
literal lit(v, !is_true);
TRACE(seq, tout << (is_true ? "" : "not ") << mk_bounded_pp(e, m) << "\n";);
if (m_util.str.is_prefix(e, e1, e2)) {
nseq_dependency* dep = m_state.mk_dep(lit);
m_state.add_pred(NSEQ_PREFIX, e1, e2, is_true, dep);
}
else if (m_util.str.is_suffix(e, e1, e2)) {
nseq_dependency* dep = m_state.mk_dep(lit);
m_state.add_pred(NSEQ_SUFFIX, e1, e2, is_true, dep);
}
else if (m_util.str.is_contains(e, e1, e2)) {
nseq_dependency* dep = m_state.mk_dep(lit);
m_state.add_pred(NSEQ_CONTAINS, e1, e2, is_true, dep);
}
else if (m_util.str.is_in_re(e, e1, e2)) {
nseq_dependency* dep = m_state.mk_dep(lit);
m_state.add_mem(e1, e2, is_true, dep);
}
}
// -------------------------------------------------------
// Propagation
// -------------------------------------------------------
bool theory_nseq::can_propagate() {
return m_state.has_pending_axioms();
}
void theory_nseq::propagate() {
unsigned head = m_state.axioms_head();
auto const& axioms = m_state.axioms();
for (unsigned i = head; i < axioms.size(); ++i)
deque_axiom(axioms[i]);
m_state.set_axioms_head(axioms.size());
}
// -------------------------------------------------------
// Scope management
// -------------------------------------------------------
void theory_nseq::push_scope_eh() {
theory::push_scope_eh();
m_state.push_scope();
}
void theory_nseq::pop_scope_eh(unsigned num_scopes) {
m_state.pop_scope(num_scopes);
theory::pop_scope_eh(num_scopes);
m_rewrite.reset();
}
void theory_nseq::restart_eh() {
}
void theory_nseq::relevant_eh(app* n) {
if (m_util.str.is_length(n))
add_length(n);
// Enqueue axioms for operations that need reduction
if (m_util.str.is_index(n) ||
m_util.str.is_replace(n) ||
m_util.str.is_extract(n) ||
m_util.str.is_at(n) ||
m_util.str.is_nth_i(n) ||
m_util.str.is_itos(n) ||
m_util.str.is_stoi(n) ||
m_util.str.is_from_code(n) ||
m_util.str.is_to_code(n))
enque_axiom(n);
}
// -------------------------------------------------------
// Axiom management
// -------------------------------------------------------
void theory_nseq::enque_axiom(expr* e) {
m_state.enqueue_axiom(e);
}
void theory_nseq::deque_axiom(expr* e) {
// TODO: generate axioms for string operations
TRACE(seq, tout << "deque axiom: " << mk_bounded_pp(e, m) << "\n";);
}
void theory_nseq::add_axiom(literal l1, literal l2, literal l3, literal l4, literal l5) {
literal_vector lits;
if (l1 != null_literal) lits.push_back(l1);
if (l2 != null_literal) lits.push_back(l2);
if (l3 != null_literal) lits.push_back(l3);
if (l4 != null_literal) lits.push_back(l4);
if (l5 != null_literal) lits.push_back(l5);
ctx.mk_th_axiom(get_id(), lits);
m_state.stats().m_num_axioms++;
}
// -------------------------------------------------------
// Propagation helpers
// -------------------------------------------------------
bool theory_nseq::propagate_eq(nseq_dependency* dep, enode* n1, enode* n2) {
if (n1->get_root() == n2->get_root())
return false;
enode_pair_vector eqs;
literal_vector lits;
m_state.linearize(dep, eqs, lits);
TRACE(seq, tout << "propagate eq: " << mk_bounded_pp(n1->get_expr(), m) << " = " << mk_bounded_pp(n2->get_expr(), m) << "\n";);
justification* js = ctx.mk_justification(
ext_theory_eq_propagation_justification(get_id(), ctx, lits.size(), lits.data(), eqs.size(), eqs.data(), n1, n2));
ctx.assign_eq(n1, n2, eq_justification(js));
m_state.stats().m_num_propagations++;
m_new_propagation = true;
return true;
}
bool theory_nseq::propagate_eq(nseq_dependency* dep, expr* e1, expr* e2, bool add_to_eqs) {
enode* n1 = ensure_enode(e1);
enode* n2 = ensure_enode(e2);
return propagate_eq(dep, n1, n2);
}
bool theory_nseq::propagate_lit(nseq_dependency* dep, literal lit) {
if (ctx.get_assignment(lit) == l_true)
return false;
enode_pair_vector eqs;
literal_vector lits;
m_state.linearize(dep, eqs, lits);
justification* js = ctx.mk_justification(
ext_theory_propagation_justification(get_id(), ctx, lits.size(), lits.data(), eqs.size(), eqs.data(), lit));
ctx.assign(lit, js);
m_state.stats().m_num_propagations++;
m_new_propagation = true;
return true;
}
void theory_nseq::set_conflict(nseq_dependency* dep, literal_vector const& extra_lits) {
enode_pair_vector eqs;
literal_vector lits;
lits.append(extra_lits);
m_state.linearize(dep, eqs, lits);
TRACE(seq, tout << "conflict: " << lits << "\n";);
ctx.set_conflict(
ctx.mk_justification(
ext_theory_conflict_justification(get_id(), ctx, lits.size(), lits.data(), eqs.size(), eqs.data())));
m_state.stats().m_num_conflicts++;
}
// -------------------------------------------------------
// Utility helpers
// -------------------------------------------------------
void theory_nseq::add_length(expr* l) {
expr* e = nullptr;
VERIFY(m_util.str.is_length(l, e));
m_state.add_length(l, e, m_state.trail());
}
literal theory_nseq::mk_literal(expr* e) {
expr_ref _e(e, m);
if (!ctx.e_internalized(e))
ctx.internalize(e, false);
return ctx.get_literal(e);
}
literal theory_nseq::mk_eq_empty(expr* e, bool phase) {
expr_ref emp(m_util.str.mk_empty(e->get_sort()), m);
literal lit = mk_eq(e, emp, false);
ctx.force_phase(phase ? lit : ~lit);
return lit;
}
expr_ref theory_nseq::mk_len(expr* s) {
return expr_ref(m_util.str.mk_length(s), m);
}
expr_ref theory_nseq::mk_concat(expr_ref_vector const& es, sort* s) {
SASSERT(!es.empty());
return expr_ref(m_util.str.mk_concat(es.size(), es.data(), s), m);
}
// -------------------------------------------------------
// Display and statistics
// -------------------------------------------------------
void theory_nseq::display(std::ostream& out) const {
out << "theory_nseq\n";
m_state.display(out);
}
void theory_nseq::collect_statistics(::statistics& st) const {
auto const& s = m_state.stats();
st.update("nseq eqs", s.m_num_eqs);
st.update("nseq neqs", s.m_num_neqs);
st.update("nseq memberships", s.m_num_memberships);
st.update("nseq predicates", s.m_num_predicates);
st.update("nseq conflicts", s.m_num_conflicts);
st.update("nseq propagations", s.m_num_propagations);
st.update("nseq splits", s.m_num_splits);
st.update("nseq axioms", s.m_num_axioms);
}
// -------------------------------------------------------
// Model generation (stub)
// -------------------------------------------------------
model_value_proc* theory_nseq::mk_value(enode* n, model_generator& mg) {
return nullptr;
}
void theory_nseq::init_model(model_generator& mg) {
mg.register_factory(alloc(seq_factory, get_manager(), get_family_id(), mg.get_model()));
}
void theory_nseq::finalize_model(model_generator& mg) {
}
}