IntenseFinance/gnucash
3
0
Fork 0
mirror of https://github.com/Gnucash/gnucash.git synced 2024-11-29 20:24:25 -06:00
Code Issues Packages Projects Releases Wiki Activity
4006e5a488
gnucash/libgnucash/core-utils/gnc-locale-utils.cpp

121 lines
4.0 KiB
C++
Raw Normal View History

Provide a single static instance of C++ locale. We can't use std::locale::global because all streams imbue it by default and if it's not 'C' (aka std::locale::classic) then we must imbue all the streams that we don't want localized, and that's most of them. Provides error checking for setting the C++ locale from the environment. This is necessary both because the environment might have an invalid locale, which would cause an unhandled exception crash. On windows std::locale("") can't handle some Microsoft-style locale strings (e.g. Spanish_Spain) so we use boost::locale's gen("") function to set the locale--though even that can't handle a Microsoft-style locale string with an appended charset (e.g. Spanish_Spain.1252) and that's what glibc's setlocale(LC_ALL, NULL) emits.
2019-01-06 11:52:43 -06:00
/********************************************************************\
* gnc-locale-utils.cpp -- provide a default locale for C++ *
* Copyright (C) 2019 John Ralls <jralls@ceridwen.us *
* *
* This program is free software; you can redistribute it and/or *
* modify it under the terms of the GNU General Public License as *
* published by the Free Software Foundation; either version 2 of *
* the License, or (at your option) any later version. *
* *
* This program 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 General Public License for more details. *
* *
* You should have received a copy of the GNU General Public License*
* along with this program; if not, contact: *
* *
* Free Software Foundation Voice: +1-617-542-5942 *
* 51 Franklin Street, Fifth Floor Fax: +1-617-542-2652 *
* Boston, MA 02110-1301, USA gnu@gnu.org *
\********************************************************************/
Bug 797067 - Date displayed incorrectly in register take two. Revert using boost::locale to generate std::locales as boost::locale- generated locales don't implement std::locale::facet and there was a bug in the boost::locale ICU wrapper code that caused the wrong year to be output for the last 3 days of December. GCC's libstdc++ supports only the "C" locale on Windows and throws if one attempts to create any other kind. For dates we work around this by using wstrftime() to format according to locale and then convert the UTF16 string to UTF8. wstrftime() interprets the time zone flags %z, %Z, and %ZP differently so we process those first before calling strftime. This will have the unfortunate effect of not localizing timezone names but it's as close as we can get.
2019-02-08 13:40:21 -06:00
extern "C"
{
#include <glib.h>
}
Provide a single static instance of C++ locale. We can't use std::locale::global because all streams imbue it by default and if it's not 'C' (aka std::locale::classic) then we must imbue all the streams that we don't want localized, and that's most of them. Provides error checking for setting the C++ locale from the environment. This is necessary both because the environment might have an invalid locale, which would cause an unhandled exception crash. On windows std::locale("") can't handle some Microsoft-style locale strings (e.g. Spanish_Spain) so we use boost::locale's gen("") function to set the locale--though even that can't handle a Microsoft-style locale string with an appended charset (e.g. Spanish_Spain.1252) and that's what glibc's setlocale(LC_ALL, NULL) emits.
2019-01-06 11:52:43 -06:00
#include <clocale>
#include <boost/locale.hpp>
#include "gnc-locale-utils.hpp"
Fix translations using boost::locale::translate This requires a std::locale generated from a boost::locale::generator The examples already in our code base used the wrong message_path while creating the generator and as a result our message catalogs weren't found. As with the std::locale I have added code to create a locale via boost::locale only once instead of having each c++ file redo the work. This code expects a message_path to set for the boost generator. An earlier attempt queried for this path directly from within gnc-locale-utils using gnc_get_locale_dir (from gnc-path.h). That however broke several c++ tests depending on gnc_locale_utils as those then also needed to be linked against gnc-path.o. I couldn't get the linker to do this properly so I worked around it for now by splitting the boost_locale functionality in two steps: - an initializer step that takes the messages_path as a string and will generate the locale - a getter to get the locale. The initializer should only be run once, and before the getter is called. It won't hurt though if the initializer is called more often. If the getter is called before the initializer it will still generate a std::locale but without setting a messages_path. It will then also log a warning explaining translations may not be properly found.
2020-06-09 15:58:01 -05:00
#include <config.h>
Provide a single static instance of C++ locale. We can't use std::locale::global because all streams imbue it by default and if it's not 'C' (aka std::locale::classic) then we must imbue all the streams that we don't want localized, and that's most of them. Provides error checking for setting the C++ locale from the environment. This is necessary both because the environment might have an invalid locale, which would cause an unhandled exception crash. On windows std::locale("") can't handle some Microsoft-style locale strings (e.g. Spanish_Spain) so we use boost::locale's gen("") function to set the locale--though even that can't handle a Microsoft-style locale string with an appended charset (e.g. Spanish_Spain.1252) and that's what glibc's setlocale(LC_ALL, NULL) emits.
2019-01-06 11:52:43 -06:00
Rewire and corrected Doxygen comment for gnc_get_locale() c++ function. There's no point in going through the cache dance on MinGW, that will just throw.
2019-04-30 17:00:06 -05:00
/** Cache the UI locale
Provide a single static instance of C++ locale. We can't use std::locale::global because all streams imbue it by default and if it's not 'C' (aka std::locale::classic) then we must imbue all the streams that we don't want localized, and that's most of them. Provides error checking for setting the C++ locale from the environment. This is necessary both because the environment might have an invalid locale, which would cause an unhandled exception crash. On windows std::locale("") can't handle some Microsoft-style locale strings (e.g. Spanish_Spain) so we use boost::locale's gen("") function to set the locale--though even that can't handle a Microsoft-style locale string with an appended charset (e.g. Spanish_Spain.1252) and that's what glibc's setlocale(LC_ALL, NULL) emits.
2019-01-06 11:52:43 -06:00
*
Rewire and corrected Doxygen comment for gnc_get_locale() c++ function. There's no point in going through the cache dance on MinGW, that will just throw.
2019-04-30 17:00:06 -05:00
* We don't want to set the default locale because we need
* std::locale::classic for consistency in stored data. We also don't
* want to call std::locale("") more than once, it's slow... and we
* don't want to call it on MinGW32 at all because that supports only
* std::locale::classic and throws if you try to construct anything
* else. Boost::locale doesn't support std::locale::facet required by
* boost::datetime (go figure).
*
* @return a copy of std::locale::classic() on MinGW32 and a copy of
* the cached result of std::locale("") otherwise.
Provide a single static instance of C++ locale. We can't use std::locale::global because all streams imbue it by default and if it's not 'C' (aka std::locale::classic) then we must imbue all the streams that we don't want localized, and that's most of them. Provides error checking for setting the C++ locale from the environment. This is necessary both because the environment might have an invalid locale, which would cause an unhandled exception crash. On windows std::locale("") can't handle some Microsoft-style locale strings (e.g. Spanish_Spain) so we use boost::locale's gen("") function to set the locale--though even that can't handle a Microsoft-style locale string with an appended charset (e.g. Spanish_Spain.1252) and that's what glibc's setlocale(LC_ALL, NULL) emits.
2019-01-06 11:52:43 -06:00
*/
const std::locale&
gnc_get_locale()
{
Bug 797067 - Date displayed incorrectly in register take two. Revert using boost::locale to generate std::locales as boost::locale- generated locales don't implement std::locale::facet and there was a bug in the boost::locale ICU wrapper code that caused the wrong year to be output for the last 3 days of December. GCC's libstdc++ supports only the "C" locale on Windows and throws if one attempts to create any other kind. For dates we work around this by using wstrftime() to format according to locale and then convert the UTF16 string to UTF8. wstrftime() interprets the time zone flags %z, %Z, and %ZP differently so we process those first before calling strftime. This will have the unfortunate effect of not localizing timezone names but it's as close as we can get.
2019-02-08 13:40:21 -06:00
#ifdef __MINGW32__
Rewire and corrected Doxygen comment for gnc_get_locale() c++ function. There's no point in going through the cache dance on MinGW, that will just throw.
2019-04-30 17:00:06 -05:00
return std::locale::classic(); // Nothing else supported.
Bug 797067 - Date displayed incorrectly in register take two. Revert using boost::locale to generate std::locales as boost::locale- generated locales don't implement std::locale::facet and there was a bug in the boost::locale ICU wrapper code that caused the wrong year to be output for the last 3 days of December. GCC's libstdc++ supports only the "C" locale on Windows and throws if one attempts to create any other kind. For dates we work around this by using wstrftime() to format according to locale and then convert the UTF16 string to UTF8. wstrftime() interprets the time zone flags %z, %Z, and %ZP differently so we process those first before calling strftime. This will have the unfortunate effect of not localizing timezone names but it's as close as we can get.
2019-02-08 13:40:21 -06:00
#else
Rewire and corrected Doxygen comment for gnc_get_locale() c++ function. There's no point in going through the cache dance on MinGW, that will just throw.
2019-04-30 17:00:06 -05:00
static std::locale cached;
static bool tried_already = false;
if (!tried_already)
{
tried_already = true;
try
{
cached = std::locale("");
}
catch (const std::runtime_error& err)
{
char* locale = g_strdup(setlocale(LC_ALL, ""));
Log a warning in gnc_get_locale() instead of writing to stderr.
2019-02-12 14:58:42 -06:00
Rewire and corrected Doxygen comment for gnc_get_locale() c++ function. There's no point in going through the cache dance on MinGW, that will just throw.
2019-04-30 17:00:06 -05:00
g_log(G_LOG_DOMAIN, G_LOG_LEVEL_WARNING,
"Failed to create C++ default locale from"
"%s because %s. Using the 'C' locale for C++.",
locale, err.what());
g_free(locale);
cached = std::locale::classic();
}
}
return cached;
#endif
Provide a single static instance of C++ locale. We can't use std::locale::global because all streams imbue it by default and if it's not 'C' (aka std::locale::classic) then we must imbue all the streams that we don't want localized, and that's most of them. Provides error checking for setting the C++ locale from the environment. This is necessary both because the environment might have an invalid locale, which would cause an unhandled exception crash. On windows std::locale("") can't handle some Microsoft-style locale strings (e.g. Spanish_Spain) so we use boost::locale's gen("") function to set the locale--though even that can't handle a Microsoft-style locale string with an appended charset (e.g. Spanish_Spain.1252) and that's what glibc's setlocale(LC_ALL, NULL) emits.
2019-01-06 11:52:43 -06:00
}
Bug 797067 - Date displayed incorrectly in register take two. Revert using boost::locale to generate std::locales as boost::locale- generated locales don't implement std::locale::facet and there was a bug in the boost::locale ICU wrapper code that caused the wrong year to be output for the last 3 days of December. GCC's libstdc++ supports only the "C" locale on Windows and throws if one attempts to create any other kind. For dates we work around this by using wstrftime() to format according to locale and then convert the UTF16 string to UTF8. wstrftime() interprets the time zone flags %z, %Z, and %ZP differently so we process those first before calling strftime. This will have the unfortunate effect of not localizing timezone names but it's as close as we can get.
2019-02-08 13:40:21 -06:00
Fix translations using boost::locale::translate This requires a std::locale generated from a boost::locale::generator The examples already in our code base used the wrong message_path while creating the generator and as a result our message catalogs weren't found. As with the std::locale I have added code to create a locale via boost::locale only once instead of having each c++ file redo the work. This code expects a message_path to set for the boost generator. An earlier attempt queried for this path directly from within gnc-locale-utils using gnc_get_locale_dir (from gnc-path.h). That however broke several c++ tests depending on gnc_locale_utils as those then also needed to be linked against gnc-path.o. I couldn't get the linker to do this properly so I worked around it for now by splitting the boost_locale functionality in two steps: - an initializer step that takes the messages_path as a string and will generate the locale - a getter to get the locale. The initializer should only be run once, and before the getter is called. It won't hurt though if the initializer is called more often. If the getter is called before the initializer it will still generate a std::locale but without setting a messages_path. It will then also log a warning explaining translations may not be properly found.
2020-06-09 15:58:01 -05:00
static std::locale boost_cached;
static bool tried_boost_already = false;
void
gnc_init_boost_locale (const std::string& messages_path)
{
if (!tried_boost_already)
{
tried_boost_already = true;
try
{
boost::locale::generator gen;
if (!messages_path.empty())
gen.add_messages_path(messages_path);
else
g_log(G_LOG_DOMAIN, G_LOG_LEVEL_WARNING,
"Attempt to initialize boost_locale without a message_path. "
"If message catalogs are not installed in the system's default locations "
"user interface strings will not be translated.");
gen.add_messages_domain(PROJECT_NAME);
boost_cached = gen ("");
}
catch (const std::runtime_error& err)
{
char* locale = g_strdup(setlocale(LC_ALL, ""));
g_log(G_LOG_DOMAIN, G_LOG_LEVEL_WARNING,
"Failed to create C++ default locale from"
"%s because %s. Using the 'C' locale for C++.",
locale, err.what());
boost_cached = std::locale::classic();
}
}
}
const std::locale&
gnc_get_boost_locale()
{
return boost_cached;
}
Reference in New Issue Copy Permalink