include/dlvhex2/HigherOrderPlugin.h

Go to the documentation of this file.

/* dlvhex -- Answer-Set Programming with external interfaces.
 * Copyright (C) 2005-2007 Roman Schindlauer
 * Copyright (C) 2006-2015 Thomas Krennwallner
 * Copyright (C) 2009-2016 Peter Schüller
 * Copyright (C) 2011-2016 Christoph Redl
 * Copyright (C) 2015-2016 Tobias Kaminski
 * Copyright (C) 2015-2016 Antonius Weinzierl
 *
 * This file is part of dlvhex.
 *
 * dlvhex is free software; you can redistribute it and/or modify it
 * under the terms of the GNU Lesser General Public License as
 * published by the Free Software Foundation; either version 2.1 of
 * the License, or (at your option) any later version.
 *
 * dlvhex is distributed in the hope that it will be useful, but
 * WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public
 * License along with dlvhex; if not, write to the Free Software
 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
 * 02110-1301 USA.
 */

#ifndef HIGHER_ORDER_PLUGIN__HPP_INCLUDED_1518
#define HIGHER_ORDER_PLUGIN__HPP_INCLUDED_1518

#include "dlvhex2/PlatformDefinitions.h"
#include "dlvhex2/PluginInterface.h"

DLVHEX_NAMESPACE_BEGIN

class HigherOrderPlugin:
public PluginInterface
{
    public:
        // stored in ProgramCtx, accessed using getPluginData<HigherOrderPlugin>()
        class CtxData:
    public PluginData
    {
        public:
            typedef std::set<unsigned> AritySet;
            typedef std::set<ID> PredicateInputSet;

        public:
            bool enabled;

            AritySet arities;

            PredicateInputSet predicateInputConstants;

            PredicateMask myAuxiliaryPredicateMask;

            CtxData();
            virtual ~CtxData() {};
    };

    public:
        HigherOrderPlugin();
        virtual ~HigherOrderPlugin();

        // output help message for this plugin
        virtual void printUsage(std::ostream& o) const;

        // accepted options: --higherorder-enable
        //
        // processes options for this plugin, and removes recognized options from pluginOptions
        // (do not free the pointers, the const char* directly come from argv)
        virtual void processOptions(std::list<const char*>& pluginOptions, ProgramCtx&);

        // create parser modules that extend and the basic hex grammar
        virtual std::vector<HexParserModulePtr> createParserModules(ProgramCtx&);

        // rewrite program:
        // change all predicates p(t1,...,tn) to auxn(p,t1,...,tn)
        // for each constant pi occuring at a predicate input of an external atom
        //   with some predicate pi of arity k occuring somewhere in the program
        //   create rule pi(V1,...,Vk) :- auxk(pi,V1,...,Vk)
        virtual PluginRewriterPtr createRewriter(ProgramCtx&);

        // register model callback which transforms all auxn(p,t1,...,tn) back to p(t1,...,tn)
        virtual void setupProgramCtx(ProgramCtx&);

        // no atoms!
};

DLVHEX_NAMESPACE_END
#endif

// vim:expandtab:ts=4:sw=4:
// mode: C++
// End: