src/gettext.h

   1 /*
   2 Minetest
   3 Copyright (C) 2013 celeron55, Perttu Ahola <celeron55@gmail.com>
   4
   5 This program is free software; you can redistribute it and/or modify
   6 it under the terms of the GNU Lesser General Public License as published by
   7 the Free Software Foundation; either version 2.1 of the License, or
   8 (at your option) any later version.
   9
  10 This program is distributed in the hope that it will be useful,
  11 but WITHOUT ANY WARRANTY; without even the implied warranty of
  12 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  13 GNU Lesser General Public License for more details.
  14
  15 You should have received a copy of the GNU Lesser General Public License along
  16 with this program; if not, write to the Free Software Foundation, Inc.,
  17 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
  18 */
  19
  20 #pragma once
  21
  22 #include "config.h" // for USE_GETTEXT
  23 #include <string>
  24 #include "porting.h"
  25
  26 #if USE_GETTEXT
  27         #include <libintl.h>
  28 #else
  29         // In certain environments, some standard headers like <iomanip>
  30         // and <locale> include libintl.h. If libintl.h is included after
  31         // we define our gettext macro below, this causes a syntax error
  32         // at the declaration of the gettext function in libintl.h.
  33         // Fix this by including such a header before defining the macro.
  34         // See issue #4446.
  35         // Note that we can't include libintl.h directly since we're in
  36         // the USE_GETTEXT=0 case and can't assume that gettext is installed.
  37         #include <locale>
  38
  39         #define gettext(String) String
  40 #endif
  41
  42 #define _(String) gettext(String)
  43 #define gettext_noop(String) (String)
  44 #define N_(String) gettext_noop((String))
  45
  46 void init_gettext(const char *path, const std::string &configured_language,
  47         int argc, char *argv[]);
  48
  49 extern wchar_t *utf8_to_wide_c(const char *str);
  50
  51 // You must free the returned string!
  52 // The returned string is allocated using new
  53 inline const wchar_t *wgettext(const char *str)
  54 {
  55         // We must check here that is not an empty string to avoid trying to translate it
  56         return str[0] ? utf8_to_wide_c(gettext(str)) : utf8_to_wide_c("");
  57 }
  58
  59 inline std::string strgettext(const std::string &text)
  60 {
  61         return text.empty() ? "" : gettext(text.c_str());
  62 }
  63
  64 /**
  65  * Returns translated string with format args applied
  66  *
  67  * @tparam Args Template parameter for format args
  68  * @param src Translation source string
  69  * @param args Variable format args
  70  * @return translated string
  71  */
  72 template <typename ...Args>
  73 inline std::wstring fwgettext(const char *src, Args&&... args)
  74 {
  75         wchar_t buf[255];
  76         const wchar_t* str = wgettext(src);
  77         swprintf(buf, sizeof(buf) / sizeof(wchar_t), str, std::forward<Args>(args)...);
  78         delete[] str;
  79         return std::wstring(buf);
  80 }
  81
  82 /**
  83  * Returns translated string with format args applied
  84  *
  85  * @tparam Args Template parameter for format args
  86  * @param format Translation source string
  87  * @param args Variable format args
  88  * @return translated string.
  89  */
  90 template <typename ...Args>
  91 inline std::string fmtgettext(const char *format, Args&&... args)
  92 {
  93         std::string buf;
  94         std::size_t buf_size = 256;
  95         buf.resize(buf_size);
  96
  97         format = gettext(format);
  98
  99         int len = porting::mt_snprintf(&buf[0], buf_size, format, std::forward<Args>(args)...);
 100         if (len <= 0) throw std::runtime_error("gettext format error: " + std::string(format));
 101         if ((size_t)len >= buf.size()) {
 102                 buf.resize(len+1); // extra null byte
 103                 porting::mt_snprintf(&buf[0], buf.size(), format, std::forward<Args>(args)...);
 104         }
 105         buf.resize(len); // remove null bytes
 106
 107         return buf;
 108 }