Regex.h

Go to the documentation of this file.

#ifndef __DCL_REGEX_H__
#define __DCL_REGEX_H__     20041119
 
#ifndef __DCL_CONFIG_H__
#include <dcl/Config.h>
#endif
#ifndef __DCL_EXCEPTION_H__
#include <dcl/Exception.h>
#endif
#ifndef __DCL_STRING_H__
#include <dcl/String.h>
#endif
 
#include <dcl/_regex.h>
 
__DCL_BEGIN_NAMESPACE
 
class StringArray;
 
class DCLCAPI RegexException : public Exception
{
    DECLARE_CLASSINFO(RegexException)
public:
    RegexException(const char* _name, const char* _what);
    virtual String toString() const;
 
protected:
    String  __message;
};
 
class DCLCAPI Regex
{
public:
    enum CompileFlags {
        ICASE      = regex_icase,
        NOSUBS        = regex_nosubs,
        NEWLINE      = regex_newline
    };
 
    enum MatchFlags {
        NOTBOL        = regex_not_bol,
        NOTEOL        = regex_not_eol
    };
 
    class DCLCAPI MatchResults
    {
    private:
        match_result*   __results;
        size_t  __size;
        void attach(match_result* _results, size_t _size);
        friend class Regex;
    public:
        MatchResults();
        ~MatchResults();
        const match_result& operator [] (size_t _index) const
            __DCL_THROWS1(InvalidIndexException*);
        size_t size() const { return __size; }
    };
 
private:
    void*   __handle;
public:
    Regex();
    ~Regex();
 
    Regex(const wchar_t* _pattern, size_t _n, unsigned int _flags = 0)
        __DCL_THROWS1(RegexException*);
 
    void compile(const wchar_t* _pattern, size_t _n, unsigned int _flags = 0)
        __DCL_THROWS1(RegexException*);
 
    bool search(const wchar_t* _begin, const wchar_t* _end, unsigned int _flags = 0)
        __DCL_THROWS1(RegexException*);
 
    bool search(const wchar_t* _begin, const wchar_t* _end, MatchResults& _results, unsigned int _flags = 0)
        __DCL_THROWS1(RegexException*);
 
    bool match(const wchar_t* _begin, const wchar_t* _end, unsigned int _flags)
        __DCL_THROWS1(RegexException*);
 
    bool match(const wchar_t* _begin, const wchar_t* _end, MatchResults& _results, unsigned int _flags = 0)
        __DCL_THROWS1(RegexException*);
 
 
    Regex(const String& _pattern, unsigned int _flags = 0)
        __DCL_THROWS1(RegexException*);
 
    void compile(const String& _pattern, unsigned int _flags = 0)
        __DCL_THROWS1(RegexException*);
 
    bool search(const String& _string, unsigned int _flags = 0)
        __DCL_THROWS1(RegexException*);
 
    bool search(const String& _string, MatchResults& _results, unsigned int _flags = 0)
        __DCL_THROWS1(RegexException*);
 
    bool match(const String& _string, unsigned int _flags = 0)
        __DCL_THROWS1(RegexException*);
    
    bool match(const String& _string, MatchResults& _results, unsigned int _flags = 0)
        __DCL_THROWS1(RegexException*);
 
    String replace(
            const String& _string,
            const String& _replacement,
            size_t _limit = (size_t)-1
            ) __DCL_THROWS1(RegexException*);
 
    size_t split(
            const wchar_t* _begin, const wchar_t* _end,
            StringArray& _results,
            size_t _limit = (size_t)-1  // unlimited
            ) __DCL_THROWS1(RegexException*);
 
    size_t split(
            const String& _string,
            StringArray& _results,
            size_t _limit = (size_t)-1      //  unlimited
            ) __DCL_THROWS1(RegexException*);
 
    static bool test(
            const wchar_t* _regex,
            const wchar_t* _string,
            bool _icase = false
            ) __DCL_THROWS1(RegexException*);
 
    static bool test(
            const char* _regex,
            const char* _string,
            bool _icase = false
            ) __DCL_THROWS1(RegexException*);
};
 
inline void Regex::compile(const String& _pattern, unsigned int _flags) // = 0)
        __DCL_THROWS1(RegexException*)
{
    compile(_pattern.data(), _pattern.length(), _flags);
}
 
inline bool Regex::search(const String& _string, unsigned int _flags) // = 0)
        __DCL_THROWS1(RegexException*)
{
    return search(_string.data(), _string.data() + _string.length(), _flags);
}
 
inline bool Regex::search(const String& _string, MatchResults& _results, unsigned int _flags) // = 0)
        __DCL_THROWS1(RegexException*)
{
    return search(_string.data(), _string.data() + _string.length(), _results, _flags);
}
 
inline bool Regex::match(const String& _string, unsigned int _flags) // = 0)
        __DCL_THROWS1(RegexException*)
{
    return match(_string.data(), _string.data() + _string.length(), _flags);
}
    
inline bool Regex::match(const String& _string, MatchResults& _results, unsigned int _flags) // = 0)
        __DCL_THROWS1(RegexException*)
{
    return match(_string.data(), _string.data() + _string.length(), _results, _flags);
}
 
inline size_t Regex::split(
            const String& _string,
            StringArray& _results,
            size_t _limit   // = (size_t)-1     //  unlimited
            ) __DCL_THROWS1(RegexException*)
{
    return split(_string.data(), _string.data() + _string.length(), _results, _limit);
}
 
__DCL_END_NAMESPACE
 
#endif  // __DCL_REGEX_H__