From e16866e072f94410321d70daedbcb855ea878cac Mon Sep 17 00:00:00 2001 From: Timothy Pearson Date: Sun, 6 Nov 2011 15:56:40 -0600 Subject: Actually move the kde files that were renamed in the last commit --- tdecore/kcatalogue.h | 129 +++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 129 insertions(+) create mode 100644 tdecore/kcatalogue.h (limited to 'tdecore/kcatalogue.h') diff --git a/tdecore/kcatalogue.h b/tdecore/kcatalogue.h new file mode 100644 index 000000000..0658b9000 --- /dev/null +++ b/tdecore/kcatalogue.h @@ -0,0 +1,129 @@ +/* This file is part of the KDE libraries + Copyright (c) 2001 Hans Petter Bieker + + This library is free software; you can redistribute it and/or + modify it under the terms of the GNU Library General Public + License as published by the Free Software Foundation; either + version 2 of the License, or (at your option) any later version. + + 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 KCATALOGUE_H +#define KCATALOGUE_H + +#include +#include "kdelibs_export.h" + +struct kde_loaded_l10nfile; + +class KCataloguePrivate; + +/** + * This class abstracts a gettext message catalog. It will take care of + * opening the file and reading the catalog. + * + * @see KLocale + */ +//REVISED: hausmann +class KDECORE_EXPORT KCatalogue +{ +public: + /** + * Constructor. + * + * @param name The name of the catalog + * @param language The language of this catalog + */ + explicit KCatalogue(const TQString & name = TQString::null, const TQString & language = TQString::null); + + /** + * Copy constructor. + */ + KCatalogue(const KCatalogue & rhs); + + /** + * Assignment operator. + */ + KCatalogue & operator = ( const KCatalogue & rhs); + + /** + * Destructor. + */ + virtual ~KCatalogue(); + + /** + * Returns the name of the catalog. + * + * @return The name of the catalog + */ + TQString name() const; + + /** + * Returns the language of the catalog. + * + * @return The language of the catalog + */ + TQString language() const; + + /** + * Returns the plural type for the catalog. This type is based on the language of the catalog + and is cached for performance. + * + * @return The plural type for the catalog + */ + int pluralType() const; + + /** + * Sets the plural type for the catalog. The caller has probably looked it up in a kdelibs.mo-catalog + * for the appropriate language + * + * @return The plural type for the catalog + */ + void setPluralType( int pluralType ); + + + /** + * Retrieves a translation of the specified message id. + * + * Do not pass 0 or "" strings as message ids. + * + * @param msgid The message id + * + * @return The translated message, in utf8 encoding, or 0 if not found + */ + const char * translate( const char * msgid ) const; + +private: + /** + * @internal Changes the current file name. + * + * @param fileName The new file name + */ + + void setFileName( const TQString & fileName ); + /** + * @internal Retrieves the current file name. + * + * @return The current file name, if any. + */ + TQString fileName() const; + + /** + * @internal Unloads the current file. + */ + void doUnload(); + +private: + KCataloguePrivate * d; +}; + +#endif -- cgit v1.2.1