regexpreprocessor.h

//
// C++ Interface: RegexPreProcessor
//
// Description: performs operations or inspections on a string representing
// a valid regular expression
//
// Author: Lorenzo Bettini <http://www.lorenzobettini.it>, (C) 1999-2007
//
// Copyright: See COPYING file that comes with this distribution
//
//
#ifndef REGEXPREPROCESSOR_H
#define REGEXPREPROCESSOR_H

#include <string>
#include <list>
#include <utility>
#include <vector>
#include <boost/regex.hpp>

namespace srchilite {

struct subexpressions_info {
    const static std::string ERR_OUTER_UNMARKED;
    const static std::string ERR_NESTED_SUBEXP;
    const static std::string ERR_UNBALANCED_PAREN;
    const static std::string ERR_OUTSIDE_SUBEXP;

    unsigned int marked;
    std::string errors;

    subexpressions_info() :
        marked(0) {
    }
};

typedef std::list<std::string> subexpressions_strings;

typedef std::pair<int, int> backreference_info;

typedef std::vector<std::string> backreference_replacements;

typedef boost::match_results<std::string::const_iterator> regex_match_results;

class RegexPreProcessor {
public:
    RegexPreProcessor();

    ~RegexPreProcessor();

    static const std::string preprocess(const std::string &s);

    static const std::string make_nonsensitive(const std::string &s);

    static unsigned int num_of_subexpressions(const std::string &s);

    static subexpressions_info num_of_marked_subexpressions(
            const std::string &s, bool allow_outer_char = false,
            bool allow_outer_nonmarked = false);

    static const subexpressions_strings *split_marked_subexpressions(
            const std::string &s);

    static bool contains_backreferences(const std::string &s);

    static backreference_info num_of_backreferences(const std::string &s);

    static backreference_info num_of_references(const std::string &s);

    static const std::string replace_backreferences(
            const std::string &original,
            const backreference_replacements &replace);

    static const std::string replace_backreferences(
            const std::string &original, const regex_match_results &results);

    static const std::string replace_references(
            const std::string &original,
            const backreference_replacements &replace);

    static const std::string replace_references(
            const std::string &original, const regex_match_results &results);

};

}

#endif