3 * Definition of helper classes for expression output. */
6 * GiNaC Copyright (C) 1999-2019 Johannes Gutenberg University Mainz, Germany
8 * This program is free software; you can redistribute it and/or modify
9 * it under the terms of the GNU General Public License as published by
10 * the Free Software Foundation; either version 2 of the License, or
11 * (at your option) any later version.
13 * This program is distributed in the hope that it will be useful,
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 * GNU General Public License for more details.
18 * You should have received a copy of the GNU General Public License
19 * along with this program; if not, write to the Free Software
20 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
26 #include "class_info.h"
34 /** This class stores information about a registered print_context class. */
35 class print_context_options {
37 print_context_options(const char *n, const char *p, unsigned i)
38 : name(n), parent_name(p), id(i) {}
40 const char *get_name() const { return name; }
41 const char *get_parent_name() const { return parent_name; }
42 unsigned get_id() const { return id; }
45 const char *name; /**< Class name. */
46 const char *parent_name; /**< Name of superclass. */
47 unsigned id; /**< ID number (assigned automatically). */
50 typedef class_info<print_context_options> print_context_class_info;
53 /** Flags to control the behavior of a print_context. */
57 print_index_dimensions = 0x0001 ///< print the dimensions of indices
62 /** Common part of GINAC_DECLARE_PRINT_CONTEXT_BASE and GINAC_DECLARE_PRINT_CONTEXT_DERIVED. */
63 #define GINAC_DECLARE_PRINT_CONTEXT_COMMON(classname) \
65 friend class function_options; \
66 friend class registered_class_options; \
67 static const GiNaC::print_context_class_info &get_class_info_static(); \
70 #define GINAC_DECLARE_PRINT_CONTEXT_BASE(classname) \
71 GINAC_DECLARE_PRINT_CONTEXT_COMMON(classname) \
72 virtual const GiNaC::print_context_class_info &get_class_info() const { return classname::get_class_info_static(); } \
73 virtual const char *class_name() const { return classname::get_class_info_static().options.get_name(); } \
74 virtual classname * duplicate() const { return new classname(*this); } \
77 /** Macro for inclusion in the declaration of a print_context class.
78 * It declares some functions that are common to all classes derived
79 * from 'print_context' as well as all required stuff for the GiNaC
81 #define GINAC_DECLARE_PRINT_CONTEXT(classname, supername) \
82 GINAC_DECLARE_PRINT_CONTEXT_COMMON(classname) \
83 typedef supername inherited; \
84 const GiNaC::print_context_class_info &get_class_info() const override { return classname::get_class_info_static(); } \
85 const char *class_name() const override { return classname::get_class_info_static().options.get_name(); } \
86 classname * duplicate() const override { return new classname(*this); } \
89 /** Macro for inclusion in the implementation of each print_context class. */
90 #define GINAC_IMPLEMENT_PRINT_CONTEXT(classname, supername) \
91 const GiNaC::print_context_class_info &classname::get_class_info_static() \
93 static GiNaC::print_context_class_info reg_info = GiNaC::print_context_class_info(GiNaC::print_context_options(#classname, #supername, GiNaC::next_print_context_id++)); \
98 extern unsigned next_print_context_id;
101 /** Base class for print_contexts. */
104 GINAC_DECLARE_PRINT_CONTEXT_BASE(print_context)
106 print_context(std::ostream &, unsigned options = 0);
107 virtual ~print_context() {}
109 std::ostream & s; /**< stream to output to */
110 unsigned options; /**< option flags */
113 /** Context for default (ginsh-parsable) output. */
114 class print_dflt : public print_context
116 GINAC_DECLARE_PRINT_CONTEXT(print_dflt, print_context)
118 print_dflt(std::ostream &, unsigned options = 0);
121 /** Context for latex-parsable output. */
122 class print_latex : public print_context
124 GINAC_DECLARE_PRINT_CONTEXT(print_latex, print_context)
126 print_latex(std::ostream &, unsigned options = 0);
129 /** Context for python pretty-print output. */
130 class print_python : public print_context
132 GINAC_DECLARE_PRINT_CONTEXT(print_python, print_context)
134 print_python(std::ostream &, unsigned options = 0);
137 /** Context for python-parsable output. */
138 class print_python_repr : public print_context
140 GINAC_DECLARE_PRINT_CONTEXT(print_python_repr, print_context)
142 print_python_repr(std::ostream &, unsigned options = 0);
145 /** Context for tree-like output for debugging. */
146 class print_tree : public print_context
148 GINAC_DECLARE_PRINT_CONTEXT(print_tree, print_context)
150 print_tree(unsigned d);
151 print_tree(std::ostream &, unsigned options = 0, unsigned d = 4);
153 const unsigned delta_indent; /**< size of indentation step */
156 /** Base context for C source output. */
157 class print_csrc : public print_context
159 GINAC_DECLARE_PRINT_CONTEXT(print_csrc, print_context)
161 print_csrc(std::ostream &, unsigned options = 0);
164 /** Context for C source output using float precision. */
165 class print_csrc_float : public print_csrc
167 GINAC_DECLARE_PRINT_CONTEXT(print_csrc_float, print_csrc)
169 print_csrc_float(std::ostream &, unsigned options = 0);
172 /** Context for C source output using double precision. */
173 class print_csrc_double : public print_csrc
175 GINAC_DECLARE_PRINT_CONTEXT(print_csrc_double, print_csrc)
177 print_csrc_double(std::ostream &, unsigned options = 0);
180 /** Context for C source output using CLN numbers. */
181 class print_csrc_cl_N : public print_csrc
183 GINAC_DECLARE_PRINT_CONTEXT(print_csrc_cl_N, print_csrc)
185 print_csrc_cl_N(std::ostream &, unsigned options = 0);
188 /** Check if obj is a T, including base classes. */
190 inline bool is_a(const print_context & obj)
191 { return dynamic_cast<const T *>(&obj) != nullptr; }
196 /** Base class for print_functor handlers */
197 class print_functor_impl {
199 virtual ~print_functor_impl() {}
200 virtual print_functor_impl *duplicate() const = 0;
201 virtual void operator()(const basic & obj, const print_context & c, unsigned level) const = 0;
204 /** print_functor handler for pointer-to-functions of class T, context type C */
205 template <class T, class C>
206 class print_ptrfun_handler : public print_functor_impl {
208 typedef void (*F)(const T &, const C &, unsigned);
210 print_ptrfun_handler(F f_) : f(f_) {}
211 print_ptrfun_handler *duplicate() const override { return new print_ptrfun_handler(*this); }
213 void operator()(const basic & obj, const print_context & c, unsigned level) const override
215 // Call the supplied function
216 f(dynamic_cast<const T &>(obj), dynamic_cast<const C &>(c), level);
223 /** print_functor handler for member functions of class T, context type C */
224 template <class T, class C>
225 class print_memfun_handler : public print_functor_impl {
227 typedef void (T::*F)(const C & c, unsigned level) const;
229 print_memfun_handler(F f_) : f(f_) {}
230 print_memfun_handler *duplicate() const override { return new print_memfun_handler(*this); }
232 void operator()(const basic & obj, const print_context & c, unsigned level) const override
234 // Call the supplied member function
235 return (dynamic_cast<const T &>(obj).*f)(dynamic_cast<const C &>(c), level);
242 /** This class represents a print method for a certain algebraic class and
243 * print_context type. Its main purpose is to hide the difference between
244 * member functions and nonmember functions behind one unified operator()
245 * interface. print_functor has value semantics and acts as a smart pointer
246 * (with deep copy) to a class derived from print_functor_impl which
247 * implements the actual function call. */
248 class print_functor {
250 print_functor() : impl(nullptr) {}
251 print_functor(const print_functor & other) : impl(other.impl.get() ? other.impl->duplicate() : 0) {}
252 print_functor(std::unique_ptr<print_functor_impl> impl_) : impl(std::move(impl_)) {}
254 template <class T, class C>
255 print_functor(void f(const T &, const C &, unsigned)) : impl(new print_ptrfun_handler<T, C>(f)) {}
257 template <class T, class C>
258 print_functor(void (T::*f)(const C &, unsigned) const) : impl(new print_memfun_handler<T, C>(f)) {}
260 print_functor & operator=(const print_functor & other)
262 if (this != &other) {
263 print_functor_impl *p = other.impl.get();
264 impl.reset(p ? other.impl->duplicate() : nullptr);
269 void operator()(const basic & obj, const print_context & c, unsigned level) const
271 (*impl)(obj, c, level);
274 bool is_valid() const { return impl.get(); }
277 std::unique_ptr<print_functor_impl> impl;
283 #endif // ndef GINAC_BASIC_H