3 * Interface to GiNaC's wildcard objects. */
6 * GiNaC Copyright (C) 1999-2008 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
23 #ifndef __GINAC_WILDCARD_H__
24 #define __GINAC_WILDCARD_H__
32 /** This class acts as a wildcard for subs(), match(), has() and find(). An
33 * integer label is used to identify different wildcards. */
34 class wildcard : public basic
36 GINAC_DECLARE_REGISTERED_CLASS(wildcard, basic)
40 /** Construct wildcard with specified label. */
41 wildcard(unsigned label);
43 // functions overriding virtual functions from base classes
45 bool match(const ex & pattern, exmap& repl_lst) const;
47 /** Save (a.k.a. serialize) object into archive. */
48 void archive(archive_node& n) const;
49 /** Read (a.k.a. deserialize) object from archive. */
50 void read_archive(const archive_node& n, lst& syms);
52 unsigned calchash() const;
54 // non-virtual functions in this class
56 unsigned get_label() const {return label;}
59 void do_print(const print_context & c, unsigned level) const;
60 void do_print_tree(const print_tree & c, unsigned level) const;
61 void do_print_python_repr(const print_python_repr & c, unsigned level) const;
65 unsigned label; /**< Label used to distinguish different wildcards */
67 GINAC_DECLARE_UNARCHIVER(wildcard);
72 /** Create a wildcard object with the specified label. */
73 inline ex wild(unsigned label = 0)
75 return wildcard(label);
78 /** Check whether x has a wildcard anywhere as a subexpression. */
79 bool haswild(const ex & x);
83 #endif // ndef __GINAC_WILDCARD_H__