// Author: Vadim Zeitlin, Vaclav Slavik,
// Michael N. Filippov <michael@idisys.iae.nsk.su>
// Created: 2010-04-23
-// RCS-ID: $Id$
// Copyright: (c) 1998 Vadim Zeitlin <zeitlin@dptmaths.ens-cachan.fr>
// (c) 2010 Vaclav Slavik <vslavik@fastmail.fm>
// Licence: wxWindows licence
#include "wx/buffer.h"
#include "wx/language.h"
-
-#if !wxUSE_UNICODE
- #include "wx/hashmap.h"
-#endif
+#include "wx/hashmap.h"
+#include "wx/strconv.h"
+#include "wx/scopedptr.h"
// ============================================================================
// global decls
// forward decls
// ----------------------------------------------------------------------------
+class WXDLLIMPEXP_FWD_BASE wxArrayString;
class WXDLLIMPEXP_FWD_BASE wxTranslationsLoader;
class WXDLLIMPEXP_FWD_BASE wxLocale;
-class wxMsgCatalog;
+
+class wxPluralFormsCalculator;
+wxDECLARE_SCOPED_PTR(wxPluralFormsCalculator, wxPluralFormsCalculatorPtr)
+
+// ----------------------------------------------------------------------------
+// wxMsgCatalog corresponds to one loaded message catalog.
+// ----------------------------------------------------------------------------
+
+class WXDLLIMPEXP_BASE wxMsgCatalog
+{
+public:
+ // Ctor is protected, because CreateFromXXX functions must be used,
+ // but destruction should be unrestricted
+#if !wxUSE_UNICODE
+ ~wxMsgCatalog();
+#endif
+
+ // load the catalog from disk or from data; caller is responsible for
+ // deleting them if not NULL
+ static wxMsgCatalog *CreateFromFile(const wxString& filename,
+ const wxString& domain);
+
+ static wxMsgCatalog *CreateFromData(const wxScopedCharBuffer& data,
+ const wxString& domain);
+
+ // get name of the catalog
+ wxString GetDomain() const { return m_domain; }
+
+ // get the translated string: returns NULL if not found
+ const wxString *GetString(const wxString& sz, unsigned n = UINT_MAX) const;
+
+protected:
+ wxMsgCatalog(const wxString& domain)
+ : m_pNext(NULL), m_domain(domain)
+#if !wxUSE_UNICODE
+ , m_conv(NULL)
+#endif
+ {}
+
+private:
+ // variable pointing to the next element in a linked list (or NULL)
+ wxMsgCatalog *m_pNext;
+ friend class wxTranslations;
+
+ wxStringToStringHashMap m_messages; // all messages in the catalog
+ wxString m_domain; // name of the domain
+
+#if !wxUSE_UNICODE
+ // the conversion corresponding to this catalog charset if we installed it
+ // as the global one
+ wxCSConv *m_conv;
+#endif
+
+ wxPluralFormsCalculatorPtr m_pluralFormsCalculator;
+};
// ----------------------------------------------------------------------------
// wxTranslations: message catalogs
void SetLanguage(wxLanguage lang);
void SetLanguage(const wxString& lang);
+ // get languages available for this app
+ wxArrayString GetAvailableTranslations(const wxString& domain) const;
+
+ // find best translation language for given domain
+ wxString GetBestTranslation(const wxString& domain, wxLanguage msgIdLanguage);
+ wxString GetBestTranslation(const wxString& domain,
+ const wxString& msgIdLanguage = "en");
+
// add standard wxWidgets catalog ("wxstd")
bool AddStdCatalog();
// check if the given catalog is loaded
bool IsLoaded(const wxString& domain) const;
- // load catalog data directly from file or memory
- bool LoadCatalogFile(const wxString& filename,
- const wxString& domain = wxEmptyString);
- bool LoadCatalogData(const wxScopedCharTypeBuffer<char>& data,
- const wxString& domain = wxEmptyString);
-
// access to translations
- const wxString& GetString(const wxString& origString,
- const wxString& domain = wxEmptyString) const;
- const wxString& GetString(const wxString& origString,
- const wxString& origString2,
- unsigned n,
- const wxString& domain = wxEmptyString) const;
+ const wxString *GetTranslatedString(const wxString& origString,
+ const wxString& domain = wxEmptyString) const;
+ const wxString *GetTranslatedString(const wxString& origString,
+ unsigned n,
+ const wxString& domain = wxEmptyString) const;
wxString GetHeaderValue(const wxString& header,
const wxString& domain = wxEmptyString) const;
private:
// perform loading of the catalog via m_loader
- bool LoadCatalog(const wxString& domain, const wxString& lang);
-
- // find best translation for given domain
- wxString ChooseLanguageForDomain(const wxString& domain,
- const wxString& msgIdLang);
+ bool LoadCatalog(const wxString& domain, const wxString& lang, const wxString& msgIdLang);
// find catalog by name in a linked list, return NULL if !found
wxMsgCatalog *FindCatalog(const wxString& domain) const;
wxTranslationsLoader *m_loader;
wxMsgCatalog *m_pMsgCat; // pointer to linked list of catalogs
-
-#if !wxUSE_UNICODE
- wxStringToStringHashMap m_msgIdCharset;
-#endif
};
wxTranslationsLoader() {}
virtual ~wxTranslationsLoader() {}
- virtual bool LoadCatalog(wxTranslations *translations,
- const wxString& domain, const wxString& lang) = 0;
+ virtual wxMsgCatalog *LoadCatalog(const wxString& domain,
+ const wxString& lang) = 0;
+
+ virtual wxArrayString GetAvailableTranslations(const wxString& domain) const = 0;
};
public:
static void AddCatalogLookupPathPrefix(const wxString& prefix);
- virtual bool LoadCatalog(wxTranslations *translations,
- const wxString& domain, const wxString& lang);
+ virtual wxMsgCatalog *LoadCatalog(const wxString& domain,
+ const wxString& lang);
+
+ virtual wxArrayString GetAvailableTranslations(const wxString& domain) const;
};
: public wxTranslationsLoader
{
public:
- virtual bool LoadCatalog(wxTranslations *translations,
- const wxString& domain, const wxString& lang);
+ virtual wxMsgCatalog *LoadCatalog(const wxString& domain,
+ const wxString& lang);
+
+ virtual wxArrayString GetAvailableTranslations(const wxString& domain) const;
protected:
// returns resource type to use for translations
// get the translation of the string in the current locale
inline const wxString& wxGetTranslation(const wxString& str,
- const wxString& domain = wxEmptyString)
+ const wxString& domain = wxString())
{
wxTranslations *trans = wxTranslations::Get();
- if ( trans )
- return trans->GetString(str, domain);
+ const wxString *transStr = trans ? trans->GetTranslatedString(str, domain)
+ : NULL;
+ if ( transStr )
+ return *transStr;
else
// NB: this function returns reference to a string, so we have to keep
// a copy of it somewhere
inline const wxString& wxGetTranslation(const wxString& str1,
const wxString& str2,
unsigned n,
- const wxString& domain = wxEmptyString)
+ const wxString& domain = wxString())
{
wxTranslations *trans = wxTranslations::Get();
- if ( trans )
- return trans->GetString(str1, str2, n, domain);
+ const wxString *transStr = trans ? trans->GetTranslatedString(str1, n, domain)
+ : NULL;
+ if ( transStr )
+ return *transStr;
else
// NB: this function returns reference to a string, so we have to keep
// a copy of it somewhere
projects / wxWidgets.git / blobdiff