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 // The returned string must be freed using delete[]
  52 inline const wchar_t *wgettext(const char *str)
  53 {
  54         // We must check here that is not an empty string to avoid trying to translate it
  55         return str[0] ? utf8_to_wide_c(gettext(str)) : utf8_to_wide_c("");
  56 }
  57
  58 inline std::string strgettext(const std::string &text)
  59 {
  60         return text.empty() ? "" : gettext(text.c_str());
  61 }
  62
  63 /**
  64  * Returns translated string with format args applied
  65  *
  66  * @tparam Args Template parameter for format args
  67  * @param src Translation source string
  68  * @param args Variable format args
  69  * @return translated string
  70  */
  71 template <typename ...Args>
  72 inline std::wstring fwgettext(const char *src, Args&&... args)
  73 {
  74         wchar_t buf[255];
  75         const wchar_t* str = wgettext(src);
  76         swprintf(buf, sizeof(buf) / sizeof(wchar_t), str, std::forward<Args>(args)...);
  77         delete[] str;
  78         return std::wstring(buf);
  79 }
  80
  81 /**
  82  * Returns translated string with format args applied
  83  *
  84  * @tparam Args Template parameter for format args
  85  * @param format Translation source string
  86  * @param args Variable format args
  87  * @return translated string.
  88  */
  89 template <typename ...Args>
  90 inline std::string fmtgettext(const char *format, Args&&... args)
  91 {
  92         std::string buf;
  93         std::size_t buf_size = 256;
  94         buf.resize(buf_size);
  95
  96         format = gettext(format);
  97
  98         int len = porting::mt_snprintf(&buf[0], buf_size, format, std::forward<Args>(args)...);
  99         if (len <= 0) throw std::runtime_error("gettext format error: " + std::string(format));
 100         if ((size_t)len >= buf.size()) {
 101                 buf.resize(len+1); // extra null byte
 102                 porting::mt_snprintf(&buf[0], buf.size(), format, std::forward<Args>(args)...);
 103         }
 104         buf.resize(len); // remove null bytes
 105
 106         return buf;
 107 }