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 <[email protected]>
+
+    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 <[email protected]>
+    @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 );
+};