gettext.hpp

Go to the documentation of this file.

/*
   Copyright (C) 2003 - 2016 by David White <[email protected]>
   Part of the Battle for Wesnoth Project http://www.wesnoth.org/

   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.

   See the COPYING file for more details.
*/

#ifndef GETTEXT_HPP_INCLUDED
#define GETTEXT_HPP_INCLUDED

/**
 * How to use gettext for wesnoth source files:
 * -# include this header file in the .cpp file
 * -# make sure, that the source file is listed in the respective POTFILES.in
 *    for the textdomain, in the case of wesnoth-lib it is this file:
 *    po/wesnoth-lib/POTFILES.in
 * -# add the following include to set the correct textdomain, in this example
 *    wesnoth-lib (not required for the domain 'wesnoth', required for all
 *    other textdomains).
 *    @code
 *    #define GETTEXT_DOMAIN "wesnoth-lib"
 *    @endcode
 *
 * This should be all that is required to have your strings that are marked
 * translatable in the po files and translated ingame. So you at least have
 * to mark the strings translatable, too. ;)
 */

// gettext-related declarations
#include "wesconfig.h"
#include <string>
#include <vector>

#ifndef GETTEXT_DOMAIN
# define GETTEXT_DOMAIN PACKAGE
#endif

//A Hack to make the eclipse-cdt parser happy.
#ifdef __CDT_PARSER__
# define GETTEXT_DOMAIN ""
#endif

#if defined(__GNUCC__) || defined(__clang__) || defined(__MINGW32__)
#define UNUSEDNOWARN __attribute__((unused))
#else
#define UNUSEDNOWARN
#endif

namespace translation
{
    std::string dgettext(const char* domain, const char* msgid);
    std::string egettext(const char*);
    std::string dsgettext(const char * domainname, const char *msgid);
    //const char* sngettext(const char *singular, const char *plural, int n);
    std::string dsngettext(const char * domainname, const char *singular, const char *plural, int n);

    inline UNUSEDNOWARN static std::string gettext(const char* str)
    { return translation::dgettext(GETTEXT_DOMAIN, str); }
    inline UNUSEDNOWARN static std::string sgettext(const char* str)
    { return translation::dsgettext(GETTEXT_DOMAIN, str); }
    inline UNUSEDNOWARN static std::string sngettext(const char* str1, const char* str2, int n)
    { return translation::dsngettext(GETTEXT_DOMAIN, str1, str2 , n); }


    void bind_textdomain(const char* domain, const char* directory, const char* encoding);
    void set_default_textdomain(const char* domain);

    void set_language(const std::string& language, const std::vector<std::string>* alternates);

    void init();
    int compare(const std::string& s1,const std::string& s2);
}

//#define _(String) translation::dsgettext(GETTEXT_DOMAIN,String)
inline static UNUSEDNOWARN std::string _(const char* str)
{ return translation::dsgettext(GETTEXT_DOMAIN, str); }

//#define _n(String1, String2, Int) translation::dsngettext(GETTEXT_DOMAIN, String1,String2,Int)
inline UNUSEDNOWARN static std::string _n(const char* str1, const char* str2, int n)
{ return translation::dsngettext(GETTEXT_DOMAIN, str1, str2, n); }

#define gettext_noop(String) String
#define N_(String) gettext_noop (String)

#endif