Qt
Internal/Contributor docs for the Qt SDK. Note: These are NOT official API docs; those are found at https://doc.qt.io/
Loading...
Searching...
No Matches
Translator Class Reference

#include <translator.h>

Collaboration diagram for Translator:

Classes

struct  Duplicates
struct  FileFormat

Public Types

enum  LocationsType { DefaultLocations , NoLocations , RelativeLocations , AbsoluteLocations }
using DuplicateEntries = QHash<int, QVector<int>>
typedef TranslatorMessage::ExtraData ExtraData
typedef bool(* SaveFunction) (const Translator &, QIODevice &out, ConversionData &data)
typedef bool(* LoadFunction) (Translator &, QIODevice &in, ConversionData &data)

Public Member Functions

 Translator ()
bool load (const QString &filename, ConversionData &err, const QString &format)
bool save (const QString &filename, ConversionData &err, const QString &format) const
int find (const TranslatorMessage &msg) const
int find (const QString &context, const QString &comment, const TranslatorMessage::References &refs) const
int find (const QString &context) const
void replaceSorted (const TranslatorMessage &msg)
void extend (const TranslatorMessage &msg, ConversionData &cd)
void append (const TranslatorMessage &msg)
void appendSorted (const TranslatorMessage &msg)
void stripObsoleteMessages ()
void stripFinishedMessages ()
void stripUntranslatedMessages ()
void stripEmptyContexts ()
void stripNonPluralForms ()
void stripIdenticalSourceTranslations ()
void dropTranslations ()
void dropUiLines ()
void makeFileNamesAbsolute (const QDir &originalPath)
bool translationsExist () const
bool unfinishedTranslationsExist () const
Duplicates resolveDuplicates ()
void reportDuplicates (const Duplicates &dupes, const QString &fileName, bool verbose)
void reportDuplicatesLines (const TranslatorMessage &msg, const DuplicateEntries::value_type &dups) const
QString languageCode () const
QString sourceLanguageCode () const
void setLocationsType (LocationsType lt)
LocationsType locationsType () const
void setLanguageCode (const QString &languageCode)
void setSourceLanguageCode (const QString &languageCode)
const QList< TranslatorMessage > & messages () const
void normalizeTranslations (ConversionData &cd)
QStringList normalizedTranslations (const TranslatorMessage &m, ConversionData &cd, bool *ok) const
int messageCount () const
TranslatorMessage & message (int i)
const TranslatorMessage & message (int i) const
const TranslatorMessage & constMessage (int i) const
void dump () const
void appendDependencies (const QStringList &dependencies)
void setDependencies (const QStringList &dependencies)
QStringList dependencies () const
void satisfyDependency (const QString &file, const QString &format)
QString extra (const QString &ba) const
void setExtra (const QString &ba, const QString &var)
bool hasExtra (const QString &ba) const
const ExtraData & extras () const
void setExtras (const ExtraData &extras)

Static Public Member Functions

static QString makeLanguageCode (QLocale::Language language, QLocale::Territory territory)
static void languageAndTerritory (QStringView languageCode, QLocale::Language *langPtr, QLocale::Territory *territoryPtr)
static QString guessLanguageCodeFromFileName (const QString &fileName)
static QStringList normalizedTranslations (const TranslatorMessage &m, int numPlurals)
static void registerFileFormat (const FileFormat &format)
static QList< FileFormat > & registeredFileFormats ()

Static Public Attributes

static constexpr QChar TextVariantSeparator {0x2762}
static constexpr QChar BinaryVariantSeparator {0x9c}

Detailed Description

Definition at line 78 of file translator.h.

Member Typedef Documentation

◆ DuplicateEntries

using Translator::DuplicateEntries = QHash<int, QVector<int>>

Definition at line 109 of file translator.h.

◆ ExtraData

typedef TranslatorMessage::ExtraData Translator::ExtraData

Definition at line 151 of file translator.h.

◆ LoadFunction

typedef bool(* Translator::LoadFunction) (Translator &, QIODevice &in, ConversionData &data)

Definition at line 160 of file translator.h.

◆ SaveFunction

typedef bool(* Translator::SaveFunction) (const Translator &, QIODevice &out, ConversionData &data)

Definition at line 159 of file translator.h.

Member Enumeration Documentation

◆ LocationsType

enum Translator::LocationsType
Enumerator
DefaultLocations 
NoLocations 
RelativeLocations 
AbsoluteLocations 

Definition at line 122 of file translator.h.

Constructor & Destructor Documentation

◆ Translator()

Translator::Translator ( )

Definition at line 49 of file translator.cpp.

References AbsoluteLocations.

Member Function Documentation

◆ append()

void Translator::append ( const TranslatorMessage & msg)

Definition at line 184 of file translator.cpp.

Referenced by appendSorted(), extend(), loadPO(), loadQM(), QPHReader::read(), TSReader::read(), and DataModel::release().

Here is the caller graph for this function:

◆ appendDependencies()

void Translator::appendDependencies ( const QStringList & dependencies)

Definition at line 784 of file translator.cpp.

◆ appendSorted()

void Translator::appendSorted ( const TranslatorMessage & msg)

Definition at line 189 of file translator.cpp.

References append(), and TranslatorMessage::lineNumber().

Referenced by replaceSorted().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ constMessage()

const TranslatorMessage & Translator::constMessage ( int i) const
inline

Definition at line 140 of file translator.h.

◆ dependencies()

QStringList Translator::dependencies ( ) const
inline

Definition at line 145 of file translator.h.

◆ dropTranslations()

void Translator::dropTranslations ( )

Definition at line 507 of file translator.cpp.

Referenced by main(), and savePOT().

Here is the caller graph for this function:

◆ dropUiLines()

void Translator::dropUiLines ( )

Definition at line 516 of file translator.cpp.

Referenced by main().

Here is the caller graph for this function:

◆ dump()

void Translator::dump ( ) const

Definition at line 820 of file translator.cpp.

References TranslatorMessage::dump(), message(), and messageCount().

Here is the call graph for this function:

◆ extend()

void Translator::extend ( const TranslatorMessage & msg,
ConversionData & cd )

Definition at line 128 of file translator.cpp.

References append(), TranslatorMessage::endOffset(), TranslatorMessage::extras(), find(), TranslatorMessage::lineNumber(), TranslatorMessage::setExtras(), and TranslatorMessage::startOffset().

Referenced by FindTrCalls::endVisit(), and recordMessage().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ extra()

QString Translator::extra ( const QString & ba) const

Definition at line 810 of file translator.cpp.

◆ extras()

const ExtraData & Translator::extras ( ) const
inline

Definition at line 155 of file translator.h.

Referenced by DataModel::load(), savePO(), saveTS(), and saveXLIFF().

Here is the caller graph for this function:

◆ find() [1/3]

int Translator::find ( const QString & context) const

◆ find() [2/3]

int Translator::find ( const QString & context,
const QString & comment,
const TranslatorMessage::References & refs ) const

Definition at line 415 of file translator.cpp.

◆ find() [3/3]

int Translator::find ( const TranslatorMessage & msg) const

Definition at line 402 of file translator.cpp.

Referenced by extend(), and replaceSorted().

Here is the caller graph for this function:

◆ guessLanguageCodeFromFileName()

QString Translator::guessLanguageCodeFromFileName ( const QString & fileName)
static

Definition at line 758 of file translator.cpp.

◆ hasExtra()

bool Translator::hasExtra ( const QString & ba) const

Definition at line 805 of file translator.cpp.

◆ languageAndTerritory()

void Translator::languageAndTerritory ( QStringView languageCode,
QLocale::Language * langPtr,
QLocale::Territory * territoryPtr )
static

Definition at line 378 of file translator.cpp.

◆ languageCode()

QString Translator::languageCode ( ) const
inline

Definition at line 119 of file translator.h.

◆ load()

bool Translator::load ( const QString & filename,
ConversionData & err,
const QString & format )

Definition at line 275 of file translator.cpp.

◆ locationsType()

LocationsType Translator::locationsType ( ) const
inline

Definition at line 124 of file translator.h.

Referenced by DataModel::load(), and merge().

Here is the caller graph for this function:

◆ makeFileNamesAbsolute()

void Translator::makeFileNamesAbsolute ( const QDir & originalPath)

Definition at line 688 of file translator.cpp.

◆ makeLanguageCode()

QString Translator::makeLanguageCode ( QLocale::Language language,
QLocale::Territory territory )
static

Definition at line 368 of file translator.cpp.

◆ message() [1/2]

TranslatorMessage & Translator::message ( int i)
inline

Definition at line 138 of file translator.h.

Referenced by applySameTextHeuristic(), and main().

Here is the caller graph for this function:

◆ message() [2/2]

const TranslatorMessage & Translator::message ( int i) const
inline

Definition at line 139 of file translator.h.

Referenced by dump(), TranslatorMessagePtrBase::operator->(), and saveQM().

Here is the caller graph for this function:

◆ messageCount()

int Translator::messageCount ( ) const
inline

Definition at line 137 of file translator.h.

Referenced by applySameTextHeuristic(), dump(), DataModel::load(), main(), TSReader::read(), CppParser::recordResults(), saveQM(), and FileVerifier::verifyTs().

Here is the caller graph for this function:

◆ messages()

const QList< TranslatorMessage > & Translator::messages ( ) const

Definition at line 703 of file translator.cpp.

◆ normalizedTranslations() [1/2]

QStringList Translator::normalizedTranslations ( const TranslatorMessage & m,
ConversionData & cd,
bool * ok ) const

◆ normalizedTranslations() [2/2]

QStringList Translator::normalizedTranslations ( const TranslatorMessage & m,
int numPlurals )
static

Definition at line 708 of file translator.cpp.

References TranslatorMessage::isPlural().

Here is the call graph for this function:

◆ normalizeTranslations()

void Translator::normalizeTranslations ( ConversionData & cd)

Definition at line 725 of file translator.cpp.

References TranslatorMessage::isPlural().

Referenced by main(), and releaseTranslator().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ registeredFileFormats()

QList< Translator::FileFormat > & Translator::registeredFileFormats ( )
static

Definition at line 67 of file translator.cpp.

◆ registerFileFormat()

void Translator::registerFileFormat ( const FileFormat & format)
static

Definition at line 55 of file translator.cpp.

References Translator::FileFormat::priority.

Referenced by initPO(), initQM(), initQPH(), initTS(), and initXLIFF().

Here is the caller graph for this function:

◆ replaceSorted()

void Translator::replaceSorted ( const TranslatorMessage & msg)

Definition at line 103 of file translator.cpp.

References appendSorted(), and find().

Referenced by main().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ reportDuplicates()

void Translator::reportDuplicates ( const Duplicates & dupes,
const QString & fileName,
bool verbose )

Definition at line 648 of file translator.cpp.

◆ reportDuplicatesLines()

void Translator::reportDuplicatesLines ( const TranslatorMessage & msg,
const DuplicateEntries::value_type & dups ) const

Definition at line 675 of file translator.cpp.

References TranslatorMessage::tsLineNumber().

Here is the call graph for this function:

◆ resolveDuplicates()

Translator::Duplicates Translator::resolveDuplicates ( )

Definition at line 598 of file translator.cpp.

References TranslatorMessage::isTranslated(), and TranslatorMessage::tsLineNumber().

Referenced by DataModel::load(), main(), and releaseTranslator().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ satisfyDependency()

void Translator::satisfyDependency ( const QString & file,
const QString & format )

Definition at line 796 of file translator.cpp.

◆ save()

bool Translator::save ( const QString & filename,
ConversionData & err,
const QString & format ) const

Definition at line 316 of file translator.cpp.

◆ setDependencies()

void Translator::setDependencies ( const QStringList & dependencies)
inline

Definition at line 144 of file translator.h.

◆ setExtra()

void Translator::setExtra ( const QString & ba,
const QString & var )

Definition at line 815 of file translator.cpp.

◆ setExtras()

void Translator::setExtras ( const ExtraData & extras)
inline

Definition at line 156 of file translator.h.

◆ setLanguageCode()

void Translator::setLanguageCode ( const QString & languageCode)
inline

Definition at line 129 of file translator.h.

◆ setLocationsType()

void Translator::setLocationsType ( LocationsType lt)
inline

Definition at line 123 of file translator.h.

Referenced by loadQPH(), main(), merge(), and TSReader::read().

Here is the caller graph for this function:

◆ setSourceLanguageCode()

void Translator::setSourceLanguageCode ( const QString & languageCode)
inline

Definition at line 130 of file translator.h.

◆ sourceLanguageCode()

QString Translator::sourceLanguageCode ( ) const
inline

Definition at line 120 of file translator.h.

◆ stripEmptyContexts()

void Translator::stripEmptyContexts ( )

Definition at line 475 of file translator.cpp.

◆ stripFinishedMessages()

void Translator::stripFinishedMessages ( )

Definition at line 443 of file translator.cpp.

References TranslatorMessage::Finished.

Referenced by main().

Here is the caller graph for this function:

◆ stripIdenticalSourceTranslations()

void Translator::stripIdenticalSourceTranslations ( )

Definition at line 495 of file translator.cpp.

Referenced by releaseTranslator().

Here is the caller graph for this function:

◆ stripNonPluralForms()

void Translator::stripNonPluralForms ( )

Definition at line 485 of file translator.cpp.

Referenced by main().

Here is the caller graph for this function:

◆ stripObsoleteMessages()

void Translator::stripObsoleteMessages ( )

Definition at line 433 of file translator.cpp.

References TranslatorMessage::Obsolete, and TranslatorMessage::Vanished.

Referenced by main().

Here is the caller graph for this function:

◆ stripUntranslatedMessages()

void Translator::stripUntranslatedMessages ( )

Definition at line 453 of file translator.cpp.

Referenced by main().

Here is the caller graph for this function:

◆ translationsExist()

bool Translator::translationsExist ( ) const

Definition at line 463 of file translator.cpp.

◆ unfinishedTranslationsExist()

bool Translator::unfinishedTranslationsExist ( ) const

Definition at line 469 of file translator.cpp.

Referenced by releaseTranslator().

Here is the caller graph for this function:

Member Data Documentation

◆ BinaryVariantSeparator

QChar Translator::BinaryVariantSeparator {0x9c}
staticconstexpr

Definition at line 176 of file translator.h.

◆ TextVariantSeparator

QChar Translator::TextVariantSeparator {0x2762}
staticconstexpr

Definition at line 175 of file translator.h.

The documentation for this class was generated from the following files: