summaryrefslogtreecommitdiffstats
path: root/libtdepim/kregexp3.h
diff options
context:
space:
mode:
Diffstat (limited to 'libtdepim/kregexp3.h')
-rw-r--r--libtdepim/kregexp3.h111
1 files changed, 111 insertions, 0 deletions
diff --git a/libtdepim/kregexp3.h b/libtdepim/kregexp3.h
new file mode 100644
index 000000000..e5013366c
--- /dev/null
+++ b/libtdepim/kregexp3.h
@@ -0,0 +1,111 @@
+/* -*- c++ -*-
+ kregexp3.h
+
+ This file is part of libkdenetwork.
+ Copyright (c) 2001 Marc Mutz <mutz@kde.org>
+
+ This library is free software; you can redistribute it and/or
+ modify it under the terms of the GNU General Public License,
+ version 2, as published by the Free Software Foundation.
+
+ This library 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
+ General Public License for more details.
+
+ You should have received a copy of the GNU General Public License
+ along with this library; if not, write to the Free Software
+ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
+
+ In addition, as a special exception, the copyright holders give
+ permission to link the code of this library with any edition of
+ the TQt library by Trolltech AS, Norway (or with modified versions
+ of TQt that use the same license as TQt), and distribute linked
+ combinations including the two. You must obey the GNU General
+ Public License in all respects for all of the code used other than
+ TQt. If you modify this file, you may extend this exception to
+ your version of the file, but you are not obligated to do so. If
+ you do not wish to do so, delete this exception statement from
+ your version.
+*/
+
+#include <tqglobal.h>
+#include <tqregexp.h>
+
+#include <tqstring.h>
+
+#include <tdepimmacros.h>
+
+/** @short A TQRegExp (TQt3.x) with a replace() method.
+
+ This class is simply there to provide a namespace for some nice
+ enhancements of the mighty TQRegExp (TQt3 version) regular
+ expression engine, namely the method replace(), which can be
+ used to do search-and-replace like one is used to from perl or sed.
+
+ It "simply" adds the ability to define a replacement string which
+ contains references to the captured substrings. The following
+ constructs are understood, which can be freely mixed in the
+ replacement string:
+
+ @section Sed syntax
+
+ Back references in the replacement string are made using \n
+ (backslash-digit), where @p n is a single digit. With this mode of
+ operation, only the first nine captured substrings can be
+ referenced.
+
+ NOTE: Remember that C++ interprets the backslash in string
+ constants, so you have to write a backslash as "\\".
+
+ @section Perl syntax
+
+ Back references in the replacement string are made using $n
+ (dollarsign-digit), where @p n is a single digit. With this mode
+ of operation, only the first nine captured substrings can be
+ referenced.
+
+ Additionally, Perl supports the syntax ${nn}
+ (dollarSign-leftCurlyBrace-digits-rightCurlyBrace), where @p nn
+ can be a multi-digit number.
+
+ In all modes, counting of captured substrings starts with 1 (one)!
+ To reference the entire matched string, use $0, ${0} or \\0.
+
+ @author Marc Mutz <mutz@kde.org>
+ @see TQRegExp
+*/
+
+class KDE_EXPORT KRegExp3 : public TQRegExp
+{
+public:
+ KRegExp3()
+ : TQRegExp() {}
+ KRegExp3( const TQString & pattern,
+ bool caseSensitive = TRUE,
+ bool wildcard = FALSE )
+ : TQRegExp( pattern, caseSensitive, wildcard ) {}
+ KRegExp3( const TQRegExp & rx )
+ : TQRegExp( rx ) {}
+ KRegExp3( const KRegExp3 & rx )
+ : TQRegExp( (TQRegExp)rx ) {}
+
+ /** Replaces each matching subpattern in @p str with
+ @p replacementStr, inserting captured substrings for
+ \\n, $n and ${nn} as described in the class documentation.
+ @param str The source string.
+ @param replacementStr The string which replaces matched
+ substrings of @p str.
+ @param start Start position for the search.
+ If @p start is negative, starts @p -(start) positions
+ from the end of @p str.
+ @param global If @p TRUE, requests to replace all occurrences
+ of the regexp with @p replacementStr; if @p FALSE,
+ only the first occurrence will be replaced.
+ Equivalent to the /g switch to perl's s/// operator.
+ @return The modified string.
+ */
+ TQString replace( const TQString & str,
+ const TQString & replacementStr,
+ int start=0, bool global=TRUE );
+};