diff options
Diffstat (limited to 'kio/kio/kremoteencoding.h')
-rw-r--r-- | kio/kio/kremoteencoding.h | 127 |
1 files changed, 0 insertions, 127 deletions
diff --git a/kio/kio/kremoteencoding.h b/kio/kio/kremoteencoding.h deleted file mode 100644 index 18dfe1fdb..000000000 --- a/kio/kio/kremoteencoding.h +++ /dev/null @@ -1,127 +0,0 @@ -/* This file is part of the KDE libraries - Copyright (C) 2003 Thiago Macieira <thiago.macieira@kdemail.net> - - 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 KREMOTEENCODING_H -#define KREMOTEENCODING_H - -#include <kurl.h> -#include <tqstring.h> -#include <tqcstring.h> -#include <tqtextcodec.h> - -class KRemoteEncodingPrivate; -/** - * Allows encoding and decoding properly remote filenames into Unicode. - * - * Certain protocols do not specify an appropriate encoding for decoding - * their 8-bit data into proper Unicode forms. Therefore, ioslaves should - * use this class in order to convert those forms into QStrings before - * creating the respective TDEIO::UDSEntry. The same is true for decoding - * URLs to its components. - * - * Each TDEIO::SlaveBase has one object of this kind, even if it is not necessary. - * It can be accessed through TDEIO::SlaveBase::remoteEncoding. - * - * @short A class for handling remote filenames - * @author Thiago Macieira <thiago.macieira@kdemail.net> - * @since 3.3 - */ -class TDEIO_EXPORT KRemoteEncoding -{ -public: - /** - * Constructor. - * - * Constructs this object to use the given encoding name. - * If @p name is a null pointer, the standard encoding will be used. - */ - explicit KRemoteEncoding(const char *name = 0L); - - /** - * Destructor - */ - virtual ~KRemoteEncoding(); - - /** - * Converts the given full pathname or filename to Unicode. - * This function is supposed to work for dirnames, filenames - * or a full pathname. - */ - TQString decode(const TQCString& name) const; - - /** - * Converts the given name from Unicode. - * This function is supposed to work for dirnames, filenames - * or a full pathname. - */ - TQCString encode(const TQString& name) const; - - /** - * Converts the given URL into its 8-bit components - */ - TQCString encode(const KURL& url) const; - - /** - * Converts the given URL into 8-bit form and separate the - * dirname from the filename. This is useful for slave functions - * like stat or get. - * - * The dirname is returned with the final slash always stripped - */ - TQCString directory(const KURL& url, bool ignore_trailing_slash = true) const; - - /** - * Converts the given URL into 8-bit form and retrieve the filename. - */ - TQCString fileName(const KURL& url) const; - - /** - * Returns the encoding being used. - */ - inline const char *encoding() const - { return codec->name(); } - - /** - * Returns the MIB for the codec being used. - */ - inline int encodingMib() const - { return codec->mibEnum(); } - - /** - * Sets the encoding being used. - * This function does not change the global configuration. - * - * Pass a null pointer in @p name to revert to the standard - * encoding. - */ - void setEncoding(const char* name); - -protected: - TQTextCodec *codec; - - virtual void virtual_hook(int id, void* data); - -private: - // copy constructor - KRemoteEncoding(const KRemoteEncoding&); - - - KRemoteEncodingPrivate *d; -}; - -#endif |