summaryrefslogtreecommitdiffstats
path: root/kdecore/kglobal.h
diff options
context:
space:
mode:
Diffstat (limited to 'kdecore/kglobal.h')
-rw-r--r--kdecore/kglobal.h237
1 files changed, 0 insertions, 237 deletions
diff --git a/kdecore/kglobal.h b/kdecore/kglobal.h
deleted file mode 100644
index 08e12767e..000000000
--- a/kdecore/kglobal.h
+++ /dev/null
@@ -1,237 +0,0 @@
-/* This file is part of the KDE libraries
- Copyright (C) 1999 Sirtaj Singh Kanq <taj@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 _KGLOBAL_H
-#define _KGLOBAL_H
-
-#include "kdelibs_export.h"
-#include <kinstance.h> // KDE4: class KInstance is enough here
-
-class KCharsets;
-class KConfig;
-class KSharedConfig;
-class KIconLoader;
-class KLocale;
-class KStandardDirs;
-class KStaticDeleterBase;
-class KStaticDeleterList;
-class KStringDict;
-class TQString;
-
-/**
- * Access to the KDE global objects.
- * KGlobal provides you with pointers of many central
- * objects that exist only once in the process. It is also
- * responsible for managing instances of KStaticDeleterBase.
- *
- * @see KStaticDeleterBase
- * @author Sirtaj Singh Kang (taj@kde.org)
- */
-class KDECORE_EXPORT KGlobal
-{
-public:
-
- /**
- * Returns the global instance. There is always at least
- * one instance of a component in one application (in most
- * cases the application itself).
- * @return the global instance
- */
- static KInstance *instance();
-
- /**
- * Returns the application standard dirs object.
- * @return the global standard dir object
- */
- static KStandardDirs *dirs();
-
- /**
- * Returns the general config object.
- * @return the global configuration object.
- */
- static KConfig *config();
-
- /**
- * Returns the general config object.
- * @return the global configuration object.
- */
- static KSharedConfig *sharedConfig();
-
- /**
- * Returns an iconloader object.
- * @return the global iconloader object
- */
- static KIconLoader *iconLoader();
-
- /**
- * Returns the global locale object.
- * @return the global locale object
- */
- static KLocale *locale();
-
- /**
- * The global charset manager.
- * @return the global charset manager
- */
- static KCharsets *charsets();
-
- /**
- * Creates a static TQString.
- *
- * To be used inside functions(!) like:
- * \code
- * static const TQString &myString = KGlobal::staticQString("myText");
- * \endcode
- *
- * !!! Do _NOT_ use: !!!
- * \code
- * static TQString myString = KGlobal::staticQString("myText");
- * \endcode
- * This creates a static object (instead of a static reference)
- * and as you know static objects are EVIL.
- * @param str the string to create
- * @return the static string
- */
- static const TQString &staticQString(const char *str);
-
- /**
- * Creates a static TQString.
- *
- * To be used inside functions(!) like:
- * \code
- * static const TQString &myString = KGlobal::staticQString(i18n("My Text"));
- * \endcode
- *
- * !!! Do _NOT_ use: !!!
- * \code
- * static TQString myString = KGlobal::staticQString(i18n("myText"));
- * \endcode
- * This creates a static object (instead of a static reference)
- * and as you know static objects are EVIL.
- * @param str the string to create
- * @return the static string
- */
- static const TQString &staticQString(const TQString &str);
-
- /**
- * Registers a static deleter.
- * @param d the static deleter to register
- * @see KStaticDeleterBase
- * @see KStaticDeleter
- */
- static void registerStaticDeleter(KStaticDeleterBase *d);
-
- /**
- * Unregisters a static deleter.
- * @param d the static deleter to unregister
- * @see KStaticDeleterBase
- * @see KStaticDeleter
- */
- static void unregisterStaticDeleter(KStaticDeleterBase *d);
-
- /**
- * Calls KStaticDeleterBase::destructObject() on all
- * registered static deleters and unregisters them all.
- * @see KStaticDeleterBase
- * @see KStaticDeleter
- */
- static void deleteStaticDeleters();
-
- //private:
- static KStringDict *_stringDict;
- static KInstance *_instance;
- static KLocale *_locale;
- static KCharsets *_charsets;
- static KStaticDeleterList *_staticDeleters;
-
- /**
- * The instance currently active (useful in a multi-instance
- * application, such as a KParts application).
- * Don't use this - it's mainly for KAboutDialog and KBugReport.
- * @internal
- */
- static void setActiveInstance(KInstance *d);
- static KInstance *activeInstance() { return _activeInstance; }
-
- static KInstance *_activeInstance;
-};
-
-/**
- * \relates KGlobal
- * A typesafe function to find the minimum of the two arguments.
- */
-#define KMIN(a,b) kMin(a,b)
-/**
- * \relates KGlobal
- * A typesafe function to find the maximum of the two arguments.
- */
-#define KMAX(a,b) kMax(a,b)
-/**
- * \relates KGlobal
- * A typesafe function to determine the absolute value of the argument.
- */
-#define KABS(a) kAbs(a)
-/**
- * \relates KGlobal
- * A typesafe function that returns x if it's between low and high values.
- * low if x is smaller than then low and high if x is bigger than high.
- */
-#define KCLAMP(x,low,high) kClamp(x,low,high)
-
-// XXX KDE4: Make kMin, kMax and kClamp return "T" instead of "const T &"!
-template<class T>
-inline const T& kMin (const T& a, const T& b) { return a < b ? a : b; }
-
-template<class T>
-inline const T& kMax (const T& a, const T& b) { return b < a ? a : b; }
-
-template<class T>
-inline T kAbs (const T& a) { return a < 0 ? -a : a; }
-
-template<class T>
-inline const T& kClamp( const T& x, const T& low, const T& high )
-{
- if ( x < low ) return low;
- else if ( high < x ) return high;
- else return x;
-}
-
-/**
- * Locale-independent qstricmp. Use this for comparing ascii keywords
- * in a case-insensitive way.
- * qstricmp fails with e.g. the Turkish locale where 'I'.lower() != 'i'
- * @since 3.4
- */
-int KDECORE_EXPORT kasciistricmp( const char *str1, const char *str2 );
-
-
-/**
- * \mainpage The KDE Core Functionality Library
- *
- * All KDE programs use this library to provide basic functionality such
- * as the configuration system, IPC, internationalization and locale
- * support, site-independent access to the filesystem and a large number
- * of other (but no less important) things.
- *
- * All KDE applications should link to the tdecore library. Also, using a
- * KApplication derived class instead of TQApplication is almost
- * mandatory if you expect your application to behave nicely within the
- * KDE environment.
- */
-
-#endif // _KGLOBAL_H
-