dlvhex  2.5.0
include/dlvhex2/FunctionPlugin.h
Go to the documentation of this file.
00001 /* dlvhex -- Answer-Set Programming with external interfaces.
00002  * Copyright (C) 2005-2007 Roman Schindlauer
00003  * Copyright (C) 2006-2015 Thomas Krennwallner
00004  * Copyright (C) 2009-2016 Peter Schüller
00005  * Copyright (C) 2011-2016 Christoph Redl
00006  * Copyright (C) 2015-2016 Tobias Kaminski
00007  * Copyright (C) 2015-2016 Antonius Weinzierl
00008  *
00009  * This file is part of dlvhex.
00010  *
00011  * dlvhex is free software; you can redistribute it and/or modify it
00012  * under the terms of the GNU Lesser General Public License as
00013  * published by the Free Software Foundation; either version 2.1 of
00014  * the License, or (at your option) any later version.
00015  *
00016  * dlvhex is distributed in the hope that it will be useful, but
00017  * WITHOUT ANY WARRANTY; without even the implied warranty of
00018  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
00019  * Lesser General Public License for more details.
00020  *
00021  * You should have received a copy of the GNU Lesser General Public
00022  * License along with dlvhex; if not, write to the Free Software
00023  * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
00024  * 02110-1301 USA.
00025  */
00026 
00034 #ifndef FUNCTION_PLUGIN__HPP_INCLUDED_
00035 #define FUNCTION_PLUGIN__HPP_INCLUDED_
00036 
00037 #include "dlvhex2/PlatformDefinitions.h"
00038 #include "dlvhex2/PluginInterface.h"
00039 #include <set>
00040 
00041 DLVHEX_NAMESPACE_BEGIN
00042 
00044 class FunctionPlugin:
00045 public PluginInterface
00046 {
00047     public:
00048         // stored in ProgramCtx, accessed using getPluginData<ExistsPlugin>()
00049         class CtxData:
00050     public PluginData
00051     {
00052         public:
00054             int maxArity;
00055 
00057             bool rewrite;
00058 
00060             bool parser;
00061 
00062             CtxData();
00063             virtual ~CtxData() {};
00064     };
00065 
00066     public:
00068         FunctionPlugin();
00070         virtual ~FunctionPlugin();
00071 
00072         // output help message for this plugin
00073         virtual void printUsage(std::ostream& o) const;
00074 
00075         // accepted options: --exists-enable  --exists-maxarity=<N>
00076         //
00077         // processes options for this plugin, and removes recognized options from pluginOptions
00078         // (do not free the pointers, the const char* directly come from argv)
00079         virtual void processOptions(std::list<const char*>& pluginOptions, ProgramCtx&);
00080 
00081         // create parser modules that extend and the basic hex grammar
00082         virtual std::vector<HexParserModulePtr> createParserModules(ProgramCtx&);
00083 
00084         // rewrite program by adding auxiliary constraints
00085         virtual PluginRewriterPtr createRewriter(ProgramCtx&);
00086 
00087         // plugin atoms
00088         virtual std::vector<PluginAtomPtr> createAtoms(ProgramCtx& ctx) const;
00089 
00090         // change model callback (print auxiliaries as negative atoms)
00091         virtual void setupProgramCtx(ProgramCtx&);
00092 
00093         // no atoms!
00094 };
00095 
00096 DLVHEX_NAMESPACE_END
00097 #endif
00098 
00099 // vim:expandtab:ts=4:sw=4:
00100 // mode: C++
00101 // End: