/////////////////////////////////////////////////////////////////////////////
// Name: regex.h
-// Purpose: documentation for wxRegEx class
+// Purpose: interface of wxRegEx
// Author: wxWidgets team
// RCS-ID: $Id$
// Licence: wxWindows license
Regular expressions, as defined by POSIX, come in two flavours: @e extended
and @e basic. The builtin library also adds a third flavour
- of expression advanced, which is not available
+ of expression advanced(), which is not available
when using the system library.
Unicode is fully supported only when using the builtin library.
@library{wxbase}
@category{data}
- @seealso
- wxRegEx::ReplaceFirst
+ @see wxRegEx::ReplaceFirst
*/
class wxRegEx
{
and only if @c wxRE_NOSUB was @b not used in
Compile().
*/
- bool GetMatch(size_t* start, size_t* len, size_t index = 0);
- not wxString GetMatch(const wxString& text,
- size_t index = 0);
+ bool GetMatch(size_t* start, size_t* len, size_t index = 0) const;
+ const not used in
+ Compile().
+ Returns false if no match or if an error occurred.
+ wxString GetMatch(const wxString& text, size_t index = 0) const;
//@}
/**
May only be called after successful call to Compile().
and only if @c wxRE_NOSUB was @b not used.
*/
- size_t GetMatchCount();
+ size_t GetMatchCount() const;
/**
Return @true if this is a valid compiled regular expression, @false
otherwise.
*/
- bool IsValid();
+ bool IsValid() const;
//@{
/**
possible to avoid a @e wxStrlen() inside the loop.
May only be called after successful call to Compile().
*/
- bool Matches(const wxChar* text, int flags = 0);
- bool Matches(const wxChar* text, int flags, size_t len);
- bool Matches(const wxString& text, int flags = 0);
+ bool Matches(const wxChar* text, int flags = 0) const;
+ const bool Matches(const wxChar* text, int flags, size_t len) const;
+ const bool Matches(const wxString& text, int flags = 0) const;
//@}
/**
pattern in the text while default value of 0 means replace all.
*/
int Replace(wxString* text, const wxString& replacement,
- size_t maxMatches = 0);
+ size_t maxMatches = 0) const;
/**
Replace all occurrences: this is actually a synonym for
Replace().
-
+
@see ReplaceFirst()
*/
- int ReplaceAll(wxString* text, const wxString& replacement);
+ int ReplaceAll(wxString* text, const wxString& replacement) const;
/**
Replace the first occurrence.
*/
- int ReplaceFirst(wxString* text, const wxString& replacement);
+ int ReplaceFirst(wxString* text, const wxString& replacement) const;
};
+