src/Messages.h

   1 // -*- C++ -*-
   2 /* \file Messages.h
   3  * This file is part of LyX, the document processor.
   4  * Licence details can be found in the file COPYING.
   5  *
   6  * \author Lars Gullik Bjønnes
   7  *
   8  * Full author contact details are available in file CREDITS.
   9  */
  10
  11 #ifndef MESSAGES_H
  12 #define MESSAGES_H
  13
  14 #include "support/docstring.h"
  15
  16 #include <map>
  17 #include <string>
  18
  19 namespace lyx {
  20
  21 ///
  22 class Messages {
  23 public:
  24         /// messages in the language \p l.
  25         /// If \p l is empty, the language will be defined by the environment.
  26         Messages(std::string const & l = std::string());
  27         ///
  28         docstring const get(std::string const & msg) const;
  29         ///
  30         static void init();
  31 private:
  32         ///
  33         std::string lang_;
  34         /// Did we warn about unavailable locale already?
  35         mutable bool warned_;
  36         ///
  37         typedef std::map<std::string, docstring> TranslationCache;
  38         /// Internal cache for gettext translated strings.
  39         /// This is needed for performance reason within \c updateLabels()
  40         /// under Windows.
  41         mutable TranslationCache cache_;
  42 };
  43
  44 /// Access to the unique Messages object for the passed \p language.
  45 /// Implementation is in LyX.cpp.
  46 extern Messages & getMessages(std::string const & language);
  47 /// Access to the unique Messages object used for GUI element.
  48 /// Implementation is in LyX.cpp.
  49 extern Messages & getGuiMessages();
  50
  51 } // namespace lyx
  52
  53 #endif