QTrans.h

Go to the documentation of this file.

/********************************************************************************
*                                                                               *
*                 L a n g u a g e  T r a n s l a t i o n                        *
*                                                                               *
*********************************************************************************
*        Copyright (C) 2003-2006 by Niall Douglas.   All Rights Reserved.       *
*       NOTE THAT I DO NOT PERMIT ANY OF MY CODE TO BE PROMOTED TO THE GPL      *
*********************************************************************************
* This code is free software; you can redistribute it and/or modify it under    *
* the terms of the GNU Library General Public License v2.1 as published by the  *
* Free Software Foundation EXCEPT that clause 3 does not apply ie; you may not  *
* "upgrade" this code to the GPL without my prior written permission.           *
* Please consult the file "License_Addendum2.txt" accompanying this file.       *
*                                                                               *
* This code 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.                          *
*********************************************************************************
* $Id:                                                                          *
********************************************************************************/

#ifndef QTRANS_H
#define QTRANS_H

#include "fxdefs.h"
#include "FXProcess.h"

namespace FX {

class FXString;
class FXStream;

struct QTransStringPrivate;
class FXAPI QTransString
{
    friend class QTrans;
    friend struct QTransStringPrivate;
    QTransStringPrivate *p;
protected:
    QTransString() : p(0) { }
    QTransString(const char *context, const char *text, const char *hint, const FXString *langid=0);
    bool empty() const throw();
    QTransString copy() const;
    typedef Generic::Functor<Generic::TL::create<const FXString *>::value> GetLangIdSpec;
    GetLangIdSpec *langIdFunc() const throw();
    void setLangIdFunc(GetLangIdSpec *idfunc) throw();
    FXString translate(const FXString *id=0);
    void contents(const char *&context, const char *&text, const char *&hint) const;
public:
#ifndef HAVE_CPP0XRVALUEREFS
#ifdef HAVE_CONSTTEMPORARIES
    QTransString(const QTransString &o);
    QTransString &operator=(const QTransString &);
#else
    QTransString(QTransString &o);
    QTransString &operator=(QTransString &);
#endif
#else
private:
    QTransString(const QTransString &); // disable copy constructor
    QTransString &operator=(const QTransString &);
public:
    QTransString(QTransString &&o);
    QTransString &&operator=(QTransString &&o);
#endif
    ~QTransString();
    QTransString &arg(const FXString &str, FXint fieldwidth=0);
    QTransString &arg(char c, FXint fieldwidth=0);
    QTransString &arg(FXlong num,  FXint fieldwidth=0, FXint base=10);
    QTransString &arg(FXulong num, FXint fieldwidth=0, FXint base=10);
    QTransString &arg(FXint num,  FXint fieldwidth=0, FXint base=10) { return arg((base!=10) ? (FXulong)((FXuint) num) : (FXlong) num, fieldwidth, base); }
    QTransString &arg(FXuint num, FXint fieldwidth=0, FXint base=10) { return arg((FXulong) num, fieldwidth, base); }
    QTransString &arg(double num, FXint fieldwidth=0, FXchar fmt='g', int prec=-1);
    operator FXString() { return translate(); }
    const FXchar *text();

    void save(FXStream &s) const;
    void load(FXStream &s);
};


template<class type> class QValueList;
class QTransPrivate;
struct QTransEmbeddedFile;
class FXAPI QTrans
{
    QTransPrivate *p;
    friend class QTransInit;
    QTrans(int &argc, char **argv, FXStream &txtout);
    FXDLLLOCAL void addData(QTransEmbeddedFile &data);
    FXDLLLOCAL void removeData(const QTransEmbeddedFile &data);
public:
    ~QTrans();
    static QTransString tr(const char *context, const char *text, const char *hint=0);
    enum LanguageType
    {
        ISO639=0    
    };
    static const FXString &language(LanguageType=ISO639);
    enum CountryType
    {
        ISO3166=0   
    };
    static const FXString &country(CountryType=ISO3166);
    static void refresh();
    static void overrideLanguage(const FXString &iso639);
    static void overrideCountry(const FXString &iso3166);
    struct ProvidedInfo
    {
        FXString module, language, country;
        ProvidedInfo() { }
        ProvidedInfo(const FXString &_module, const FXString &_language, const FXString &_country)
            : module(_module), language(_language), country(_country) { }
        bool operator<(const ProvidedInfo &o) const { return module<o.module || (module==o.module && (language<o.language || (language==o.language && country<o.country))); }
        bool operator>(const ProvidedInfo &o) const { return module>o.module || (module==o.module && (language>o.language || (language==o.language && country>o.country))); }
    };
    typedef QValueList<ProvidedInfo> ProvidedInfoList;
    static ProvidedInfoList provided();
private:
    friend class QTrans_EmbeddedTranslationFile;
    friend class QTransString;
    FXDLLLOCAL void int_translateString(FXString &dest, QTransString &src, const FXString *langid=0);
    static void int_registerEmbeddedTranslationFile(const char *buffer, FXuint len, void *staticaddr);
    static void int_deregisterEmbeddedTranslationFile(const char *buffer, FXuint len, void *staticaddr);
};

#ifndef __GCCXML__
class QTrans_EmbeddedTranslationFile
{
    const char *buffer;
    FXuint len;
public:
    QTrans_EmbeddedTranslationFile(const FXuchar *_buffer, FXuint _len) : buffer((const char *) _buffer), len(_len)
    {
        QTrans::int_registerEmbeddedTranslationFile(buffer, len, this);
    }
    QTrans_EmbeddedTranslationFile(const char *_buffer, FXuint _len) : buffer(_buffer), len(_len)
    {
        QTrans::int_registerEmbeddedTranslationFile(buffer, len, this);
    }
    ~QTrans_EmbeddedTranslationFile()
    {
        QTrans::int_deregisterEmbeddedTranslationFile(buffer, len, this);
    }
};
#define QTRANS_SETTRANSFILE(buffer, len) static QTrans_EmbeddedTranslationFile _tnfox_myembeddedtranslationfile_(buffer, len)
#endif

} // namespace

#endif

---

(C) 2002-2009 Niall Douglas. Some parts (C) to assorted authors.