diff options
Diffstat (limited to 'kdecore/kregexp.h')
-rw-r--r-- | kdecore/kregexp.h | 129 |
1 files changed, 0 insertions, 129 deletions
diff --git a/kdecore/kregexp.h b/kdecore/kregexp.h deleted file mode 100644 index 88d16a3c7..000000000 --- a/kdecore/kregexp.h +++ /dev/null @@ -1,129 +0,0 @@ -/* This file is part of the KDE libraries - Copyright (c) 1999 Torben Weis <weis@kde.org> - - This library is free software; you can redistribute it and/or - modify it under the terms of the GNU Library 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 - Library General Public License for more details. - - You should have received a copy of the GNU Library General Public License - along with this library; see the file COPYING.LIB. If not, write to - the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, - Boston, MA 02110-1301, USA. -*/ -#ifndef __kregexp_h__ -#define __kregexp_h__ - -#include "kdelibs_export.h" - -class KRegExpPrivate; - -/** - * @deprecated - * Please use TQRegExp instead. - * - * Regular expression (regexp) matching with back-references. - * - * This was implemented - * because TQRegExp did not support back-references. It now does and - * is recommended over KRegExp because of the tqunicode support and the - * more powerful API. - * - * Back-references are parts of a regexp grouped with parentheses. If a - * string matches the regexp, you can access the text that matched each - * group with the group method. This is similar to regular expressions - * in Perl. - * - * Example: - * \code - * KRegExp ex( "([A-Za-z]+) (.+)" ); - * ex.match( "42 Torben Weis" ); - * kdDebug() << ex.group(0) << endl; - * kdDebug() << ex.group(1) << endl; - * kdDebug() << ex.group(2) << endl; - * \endcode - * Output: - * \code - * Torben Weis - * Torben - * Weis - * \endcode - * - * Please notice that KRegExp does @em not support tqunicode. - * - * @author Torben Weis <weis@kde.org> - */ -class KDECORE_EXPORT KDE_DEPRECATED KRegExp -{ -public: - - /** - * Creates a KRegExp object without a default pattern. - */ - KRegExp(); - - /** - * Creates a KRegExp object. - * @param _pattern The regular expression to use for matches. - * @param _mode If this is "i", case-insensitive matches will be - * performed. - */ - KRegExp( const char *_pattern, const char *_mode = "" ); - ~KRegExp(); - - /** - * Prepare a regular expression for subsequent matches. - * @param _pattern The regular expression to use for matches. - * @param _mode If this is "i", case-insensitive matches will be - * performed. - * @return bool if successful. - */ - bool compile( const char *_pattern, const char *_mode = "" ); - - /** - * Match a string to the last supplied regexp. - * @param _string the string to match - * @return @p true on match, false otherwise. - */ - bool match( const char *_string ); - - - /** - * Returns a group from the match. - * - * @param _grp May be in the range [0..9]. If @p _grp is 0 then the complete - * matched string is returned. - * @return a grouped substring. A substring may be empty. - * In this case 0 is returned. Otherwise you may @em not - * delete or modify the returned value. In addition the - * returned value becomes invalid after the KRegExp instance - * is deleted or after match() was called again. - */ - const char *group( int _grp ); - - /** - * The offset of the given group in the string. - * @param _grp May be in the range [0..9]. If @p _grp is 0 then the start offset - * of the complete matched string is returned. - * @return The start offset of the grouped substring. - */ - int groupStart( int _grp ); - /** - * The offset of the given group's end in the string. - * @param _grp May be in the range [0..9]. If @p _grp is 0 then the end offset - * of the complete matched string is returned. - * @return The end offset of the grouped substring. The "end offset" is the first - * character after the string. - */ - int groupEnd( int _grp ); - -private: - KRegExpPrivate *m_pPrivate; -}; - - -#endif |