kstringhandler.h

/* This file is part of the KDE libraries
   Copyright (C) 1999 Ian Zepp (icszepp@islc.net)
   Copyright (C) 2000 Rik Hemsley (rikkus) <rik@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 KSTRINGHANDLER_H
#define KSTRINGHANDLER_H
 
#include <tqstring.h>
#include <tqstringlist.h>
#include <tqregexp.h>            // for the word ranges
#include <tqfontmetrics.h>
#include "tdelibs_export.h"
 
class TDECORE_EXPORT KStringHandler
{
public:
    static TQString        word( const TQString &text , uint pos ) TDE_DEPRECATED;
 
    static TQString        word( const TQString &text , const char *range );
 
    static TQString        insword( const TQString &text , const TQString &word , uint pos );
 
    static TQString        setword( const TQString &text , const TQString &word , uint pos );
 
    static TQString        remrange( const TQString &text , const char *range );
 
 
    static TQString        remword( const TQString &text , uint pos );
 
    static TQString        remword( const TQString &text , const TQString &word );
 
    static TQString        capwords( const TQString &text );
 
    static TQStringList    capwords( const TQStringList &list );
 
    static TQString        reverse( const TQString &text );
 
    static TQStringList    reverse( const TQStringList &list );
 
    static TQString        ljust( const TQString &text , uint width ) TDE_DEPRECATED;
 
    static TQString        rjust( const TQString &text , uint width ) TDE_DEPRECATED;
 
    static TQString        center( const TQString &text , uint width );
 
    static TQString        lsqueeze( const TQString & str, uint maxlen = 40 );
 
    static TQString lEmSqueeze( const TQString & name,
                               const TQFontMetrics& fontMetrics,
                               uint maxlen = 30 );
 
    static TQString lPixelSqueeze( const TQString & name,
                                  const TQFontMetrics& fontMetrics,
                                  uint maxPixels );
 
    static TQString        csqueeze( const TQString & str, uint maxlen = 40 );
 
    static TQString cEmSqueeze( const TQString & name,
                               const TQFontMetrics& fontMetrics,
                               uint maxlen = 30 );
 
    static TQString cPixelSqueeze( const TQString & name,
                                  const TQFontMetrics& fontMetrics,
                                  uint maxPixels );
 
    static TQString        rsqueeze( const TQString & str, uint maxlen = 40 );
 
    static TQString rEmSqueeze( const TQString & name,
                               const TQFontMetrics& fontMetrics,
                               uint maxlen = 30 );
 
    static TQString rPixelSqueeze( const TQString & name,
                                  const TQFontMetrics& fontMetrics,
                                  uint maxPixels );
 
    static bool matchFileName( const TQString& filename, const TQString& pattern );
    // KDE4: move to KShell
 
    static TQStringList perlSplit
      (const TQString & sep, const TQString & s, uint max = 0);
 
    static TQStringList perlSplit
      (const TQChar & sep, const TQString & s, uint max = 0);
 
    static TQStringList perlSplit
      (const TQRegExp & sep, const TQString & s, uint max = 0);
 
    static TQString tagURLs( const TQString& text );
 
    static TQString obscure( const TQString &str );
 
    static bool isUtf8( const char *str );
 
    static TQString from8Bit( const char *str );
 
#ifdef KDE_NO_COMPAT
private:
#endif
    static TDE_DEPRECATED bool matchFilename( const TQString& filename, const TQString& pattern )
    {
        return matchFileName (filename, pattern);
    }
 
};
#endif