13531b7d3e
Motivations: - We have been writing several comments of the form "... trace/justification..." and "this trace object justify ...". - Avoid confusion with util/trace.h Signed-off-by: Leonardo de Moura <leonardo@microsoft.com>
277 lines
7.4 KiB
C++
277 lines
7.4 KiB
C++
/*
|
|
Copyright (c) 2013 Microsoft Corporation. All rights reserved.
|
|
Released under Apache 2.0 license as described in the file LICENSE.
|
|
|
|
Author: Leonardo de Moura
|
|
*/
|
|
#pragma once
|
|
#include "util/pair.h"
|
|
#include "util/splay_map.h"
|
|
#include "util/name_generator.h"
|
|
#include "kernel/expr.h"
|
|
#include "kernel/context.h"
|
|
#include "kernel/justification.h"
|
|
|
|
namespace lean {
|
|
/**
|
|
\brief Metavariable substitution. It is essentially a mapping from
|
|
metavariables to expressions.
|
|
*/
|
|
class substitution {
|
|
typedef splay_map<name, expr, name_cmp> name2expr;
|
|
name2expr m_subst;
|
|
unsigned m_size;
|
|
public:
|
|
substitution();
|
|
|
|
friend void swap(substitution & s1, substitution & s2);
|
|
|
|
/**
|
|
\brief Return the number of assigned metavariables in this substitution.
|
|
*/
|
|
unsigned size() const { return m_size; }
|
|
|
|
/**
|
|
\brief Return true iff the metavariable named \c m is assigned in this substitution.
|
|
*/
|
|
bool is_assigned(name const & m) const;
|
|
|
|
/**
|
|
\brief Return true if the given metavariable is assigned in this
|
|
substitution.
|
|
|
|
\pre is_metavar(m)
|
|
*/
|
|
bool is_assigned(expr const & m) const;
|
|
|
|
/**
|
|
\brief Assign metavariable named \c m.
|
|
|
|
\pre !is_assigned(m)
|
|
*/
|
|
void assign(name const & m, expr const & t);
|
|
|
|
/**
|
|
\brief Assign metavariable \c m to \c t.
|
|
|
|
\pre is_metavar(m)
|
|
\pre !has_meta_context(m)
|
|
\pre !is_assigned(m)
|
|
*/
|
|
void assign(expr const & m, expr const & t);
|
|
|
|
/**
|
|
\brief Return the substitution associated with the given metavariable
|
|
in this substitution.
|
|
|
|
If the metavariable is not assigned in this substitution, then it returns the null
|
|
expression.
|
|
|
|
\pre is_metavar(m)
|
|
*/
|
|
expr get_subst(expr const & m) const;
|
|
|
|
/**
|
|
\brief Apply f to each entry in this substitution.
|
|
*/
|
|
template<typename F>
|
|
void for_each(F f) const { m_subst.for_each(f); }
|
|
};
|
|
|
|
void swap(substitution & s1, substitution & s2);
|
|
|
|
/**
|
|
\brief Metavar environment. It is an auxiliary datastructure used for:
|
|
|
|
1- Creating metavariables.
|
|
2- Storing their types and the contexts where they were created.
|
|
3- Storing substitutions.
|
|
4- Collecting constraints
|
|
*/
|
|
class metavar_env {
|
|
typedef splay_map<name, expr, name_cmp> name2expr;
|
|
typedef splay_map<name, context, name_cmp> name2context;
|
|
typedef splay_map<name, justification, name_cmp> name2justification;
|
|
|
|
name_generator m_name_generator;
|
|
substitution m_substitution;
|
|
name2expr m_metavar_types;
|
|
name2context m_metavar_contexts;
|
|
name2justification m_metavar_justifications;
|
|
unsigned m_timestamp;
|
|
|
|
void inc_timestamp();
|
|
public:
|
|
metavar_env(name const & prefix);
|
|
metavar_env();
|
|
|
|
friend void swap(metavar_env & a, metavar_env & b);
|
|
|
|
/**
|
|
\brief The timestamp is increased whenever this environment is
|
|
updated.
|
|
*/
|
|
unsigned get_timestamp() const { return m_timestamp; }
|
|
|
|
/**
|
|
\brief Create a new metavariable in the given context and with the given type.
|
|
*/
|
|
expr mk_metavar(context const & ctx = context(), expr const & type = expr());
|
|
|
|
/**
|
|
\brief Return the context where the given metavariable was created.
|
|
\pre is_metavar(m)
|
|
\pre !has_local_context(m)
|
|
*/
|
|
context get_context(expr const & m) const;
|
|
context get_context(name const & m) const;
|
|
|
|
/**
|
|
\brief Return the type of the given metavariable.
|
|
\pre is_metavar(m)
|
|
|
|
\remark If \c m does not have a type associated with it, then a new
|
|
metavariable is created to represent the type of \c m.
|
|
|
|
\remark If \c m has a local context, then the local context is applied.
|
|
*/
|
|
expr get_type(expr const & m);
|
|
expr get_type(name const & m);
|
|
|
|
/**
|
|
\brief Return true iff \c m has a type associated with it.
|
|
\pre is_metavar(m)
|
|
*/
|
|
bool has_type(expr const & m) const;
|
|
bool has_type(name const & m) const;
|
|
|
|
/**
|
|
\brief Return the justification for an assigned metavariable.
|
|
\pre is_metavar(m)
|
|
\pre is_assigned(m)
|
|
*/
|
|
justification get_justification(expr const & m) const;
|
|
justification get_justification(name const & m) const;
|
|
|
|
|
|
/**
|
|
\brief Return true iff the metavariable named \c m is assigned in this substitution.
|
|
*/
|
|
bool is_assigned(name const & m) const;
|
|
|
|
/**
|
|
\brief Return true if the given metavariable is assigned in this
|
|
substitution.
|
|
|
|
\pre is_metavar(m)
|
|
*/
|
|
bool is_assigned(expr const & m) const;
|
|
|
|
/**
|
|
\brief Assign metavariable named \c m.
|
|
|
|
\pre !is_assigned(m)
|
|
*/
|
|
void assign(name const & m, expr const & t, justification const & j = justification());
|
|
|
|
/**
|
|
\brief Assign metavariable \c m to \c t.
|
|
|
|
\pre is_metavar(m)
|
|
\pre !has_meta_context(m)
|
|
\pre !is_assigned(m)
|
|
*/
|
|
void assign(expr const & m, expr const & t, justification const & j = justification());
|
|
|
|
/**
|
|
\brief Return the set of substitutions.
|
|
*/
|
|
substitution const & get_substitutions() const { return m_substitution; }
|
|
|
|
operator substitution const &() const { return get_substitutions(); }
|
|
|
|
/**
|
|
\brief Return the substitution associated with the given metavariable
|
|
in this substitution.
|
|
|
|
If the metavariable is not assigned in this substitution, then it returns the null
|
|
expression.
|
|
|
|
\pre is_metavar(m)
|
|
*/
|
|
expr get_subst(expr const & m) const { return m_substitution.get_subst(m); }
|
|
|
|
/**
|
|
\brief Return a unassigned metavariable (if one exists). Only metavariables
|
|
that have types are considered. Return the anonymous name if all metavariables (with types)
|
|
are assigned.
|
|
*/
|
|
name find_unassigned_metavar() const;
|
|
};
|
|
|
|
void swap(metavar_env & a, metavar_env & b);
|
|
|
|
/**
|
|
\brief Apply the changes in \c lctx to \c a.
|
|
*/
|
|
expr apply_local_context(expr const & a, local_context const & lctx);
|
|
|
|
/**
|
|
\brief Instantiate the metavariables occurring in \c e with the substitutions
|
|
provided by \c s.
|
|
*/
|
|
expr instantiate_metavars(expr const & e, substitution const & s);
|
|
|
|
/**
|
|
\brief Extend the local context \c lctx with the entry <tt>lift:s:n</tt>
|
|
*/
|
|
local_context add_lift(local_context const & lctx, unsigned s, unsigned n);
|
|
|
|
/**
|
|
\brief Add a lift:s:n operation to the context of the given metavariable.
|
|
|
|
\pre is_metavar(m)
|
|
*/
|
|
expr add_lift(expr const & m, unsigned s, unsigned n);
|
|
|
|
/**
|
|
\brief Add an inst:s:v operation to the context of the given metavariable.
|
|
|
|
\pre is_metavar(m)
|
|
*/
|
|
expr add_inst(expr const & m, unsigned s, expr const & v);
|
|
|
|
/**
|
|
\brief Extend the local context \c lctx with the entry <tt>inst:s v</tt>
|
|
*/
|
|
local_context add_inst(local_context const & lctx, unsigned s, expr const & v);
|
|
|
|
/**
|
|
\brief Return true iff the given metavariable has a non-empty
|
|
local context associated with it.
|
|
|
|
\pre is_metavar(m)
|
|
*/
|
|
bool has_local_context(expr const & m);
|
|
|
|
/**
|
|
\brief Return the same metavariable, but the head of the context is removed.
|
|
|
|
\pre is_metavar(m)
|
|
\pre has_meta_context(m)
|
|
*/
|
|
expr pop_meta_context(expr const & m);
|
|
|
|
/**
|
|
\brief Return true iff \c e has a metavariable that is assigned in \c s.
|
|
*/
|
|
bool has_assigned_metavar(expr const & e, substitution const & s);
|
|
|
|
/**
|
|
\brief Return true iff \c e contains the metavariable \c m.
|
|
The substitutions in \c s are taken into account.
|
|
|
|
\brief is_metavar(m)
|
|
*/
|
|
bool has_metavar(expr const & e, expr const & m, substitution const & s = substitution());
|
|
}
|