// Copyright (C) 2018 xaizek <xaizek@posteo.net>
//
// This file is part of zograscope.
//
// zograscope is free software: you can redistribute it and/or modify
// it under the terms of version 3 of the GNU Affero General Public License as
// published by the Free Software Foundation.
//
// zograscope 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 Affero General Public License for more details.
//
// You should have received a copy of the GNU Affero General Public License
// along with zograscope. If not, see <http://www.gnu.org/licenses/>.
#ifndef ZOGRASCOPE_TOOLING_MATCHER_HPP_
#define ZOGRASCOPE_TOOLING_MATCHER_HPP_
#include <cstdint>
#include <utility>
#include "Language.hpp"
#include "mtypes.hpp"
#include "tree.hpp"
// Finds a node of specified type that matches another matcher.
class Matcher
{
public:
// Constructs matcher that matches `mtype` and delegates nested matching to
// `nested`. `nested` matcher can be `nullptr`, in which case `handler`
// passed to `match()` is called.
Matcher(MType mtype, Matcher *nested);
public:
// Matches children of `node` and invokes `handler` on the last match in the
// chain. Returns `true` if at something was matched, `false` otherwise.
// `handler` must be callable as if it has `void handler(Node *node)`
// signature.
template <typename F>
bool match(const Node *node, Language &lang, F &&handler);
// Retrieves type this matcher matches against.
MType getMType() const;
// Retrieves number of nodes of specified type seen.
int getSeen() const;
// Retrieves number of nodes of specified type which were matched.
int getMatched() const;
private:
MType mtype; // Type to match against.
Matcher *nested; // Nested matcher, can be `nullptr`.
int seen; // Number of nodes of specified type seen.
int matched; // Number of nodes of specified which were matched.
};
inline
Matcher::Matcher(MType mtype, Matcher *nested)
: mtype(mtype), nested(nested), seen(0), matched(0)
{
}
template <typename F>
inline bool
Matcher::match(const Node *node, Language &lang, F &&handler)
{
if (node->next != nullptr) {
return match(node->next, lang, std::forward<F>(handler));
}
bool foundMatch = false;
for (Node *child : node->children) {
if (lang.classify(child->stype) != mtype) {
foundMatch |= match(child, lang, std::forward<F>(handler));
continue;
}
++seen;
if (nested == nullptr ||
nested->match(child, lang, std::forward<F>(handler))) {
++matched;
foundMatch = true;
if (nested == nullptr) {
handler(child);
}
if (canNest(mtype)) {
match(child, lang, std::forward<F>(handler));
}
}
}
return foundMatch;
}
inline MType
Matcher::getMType() const
{
return mtype;
}
inline int
Matcher::getSeen() const
{
return seen;
}
inline int
Matcher::getMatched() const
{
return matched;
}
#endif // ZOGRASCOPE_TOOLING_MATCHER_HPP_
Before first commit, do not forget to setup your git environment:
git config --global user.name "your_name_here"
git config --global user.email "your@email_here"
Clone this repository using HTTP(S):
git clone https://code.reversed.top/user/xaizek/zograscope
Clone this repository using ssh (do not forget to upload a key first):
git clone ssh://rocketgit@code.reversed.top/user/xaizek/zograscope
You are allowed to anonymously push to this repository.
This means that your pushed commits will automatically be transformed into a
pull request:
... clone the repository ...
... make some changes and some commits ...
git push origin master