wxRegEx class added
git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@11004 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
This commit is contained in:
127
include/wx/regex.h
Normal file
127
include/wx/regex.h
Normal file
@@ -0,0 +1,127 @@
|
||||
///////////////////////////////////////////////////////////////////////////////
|
||||
// Name: wx/regex.h
|
||||
// Purpose: regular expression matching
|
||||
// Author: Karsten Ball<6C>der
|
||||
// Modified by: VZ at 13.07.01 (integrated to wxWin)
|
||||
// Created: 05.02.2000
|
||||
// RCS-ID: $Id$
|
||||
// Copyright: (c) 2000 Karsten Ball<6C>der <ballueder@gmx.net>
|
||||
// Licence: wxWindows licence
|
||||
///////////////////////////////////////////////////////////////////////////////
|
||||
|
||||
#ifndef _WX_REGEX_H_
|
||||
#define _WX_REGEX_H_
|
||||
|
||||
#ifdef __GNUG__
|
||||
#pragma interface "regex.h"
|
||||
#endif
|
||||
|
||||
#include "wx/defs.h"
|
||||
|
||||
#if wxUSE_REGEX
|
||||
|
||||
// ----------------------------------------------------------------------------
|
||||
// constants
|
||||
// ----------------------------------------------------------------------------
|
||||
|
||||
// max number of subexpression matches, the default should be big enough for
|
||||
// all uses but may be a bit wasteful
|
||||
#ifndef WX_REGEX_MAXMATCHES
|
||||
#define WX_REGEX_MAXMATCHES 1024
|
||||
#endif
|
||||
|
||||
// flags for regex compilation: these can be used with Compile()
|
||||
enum
|
||||
{
|
||||
// use extended regex syntax: default
|
||||
wxRE_EXTENDED = 0,
|
||||
|
||||
// use basic RE syntax
|
||||
wxRE_BASIC = 2,
|
||||
|
||||
// ignore case in match
|
||||
wxRE_ICASE = 4,
|
||||
|
||||
// only check match, don't set back references
|
||||
wxRE_NOSUB = 8,
|
||||
|
||||
// if not set, treat '\n' as an ordinary character, otherwise it is
|
||||
// special: it is not matched by '.' and '^' and '$' always match
|
||||
// after/before it regardless of the setting of wxRE_NOT[BE]OL
|
||||
wxRE_NEWLINE = 16,
|
||||
|
||||
// default flags
|
||||
wxRE_DEFAULT = wxRE_NOSUB | wxRE_EXTENDED
|
||||
};
|
||||
|
||||
// flags for regex matching: these can be used with Matches()
|
||||
//
|
||||
// these flags are mainly useful when doing several matches in a long string,
|
||||
// they can be used to prevent erroneous matches for '^' and '$'
|
||||
enum
|
||||
{
|
||||
// '^' doesn't match at the start of line
|
||||
wxRE_NOTBOL = 32,
|
||||
|
||||
// '$' doesn't match at the end of line
|
||||
wxRE_NOTEOL = 64
|
||||
};
|
||||
|
||||
// ----------------------------------------------------------------------------
|
||||
// wxRegEx: a regular expression
|
||||
// ----------------------------------------------------------------------------
|
||||
|
||||
class WXDLLEXPORT wxRegExImpl;
|
||||
|
||||
class WXDLLEXPORT wxRegEx
|
||||
{
|
||||
public:
|
||||
// default ctor: use Compile() later
|
||||
wxRegEx() { Init(); }
|
||||
|
||||
// create and compile
|
||||
wxRegEx(const wxString& expr, int flags = wxRE_DEFAULT)
|
||||
{
|
||||
Init();
|
||||
(void)Compile(expr, flags);
|
||||
}
|
||||
|
||||
// return TRUE if this is a valid compiled regular expression
|
||||
bool IsValid() const { return m_impl != NULL; }
|
||||
|
||||
// compile the string into regular expression, return TRUE if ok or FALSE
|
||||
// if string has a syntax error
|
||||
bool Compile(const wxString& pattern, int flags = wxRE_DEFAULT);
|
||||
|
||||
// matches the precompiled regular expression against a string, return
|
||||
// TRUE if matches and FALSE otherwise
|
||||
//
|
||||
// flags may be combination of wxRE_NOTBOL and wxRE_NOTEOL
|
||||
bool Matches(const wxString& str, int flags = 0) const;
|
||||
|
||||
// get the start index and the length of the match of the expression
|
||||
// (index 0) or a bracketed subexpression (index != 0)
|
||||
//
|
||||
// return FALSE if no match or on error
|
||||
bool GetMatch(size_t *start, size_t *len, size_t index = 0) const;
|
||||
|
||||
// replaces the current regular expression in the string pointed to by
|
||||
// pattern, with the text in replacement and return number of matches
|
||||
// replaced (maybe 0 if none found) or -1 on error
|
||||
int Replace(wxString *str, const wxString& replacement) const;
|
||||
|
||||
// dtor not virtual, don't derive from this class
|
||||
~wxRegEx();
|
||||
|
||||
private:
|
||||
// common part of all ctors
|
||||
void Init();
|
||||
|
||||
// the real guts of this class
|
||||
wxRegExImpl *m_impl;
|
||||
};
|
||||
|
||||
#endif // wxUSE_REGEX
|
||||
|
||||
#endif // _WX_REGEX_H_
|
||||
|
Reference in New Issue
Block a user