Doxygen
Loading...
Searching...
No Matches
translator.h
Go to the documentation of this file.
1/******************************************************************************
2 *
3 * Copyright (C) 1997-2015 by Dimitri van Heesch.
4 *
5 * Permission to use, copy, modify, and distribute this software and its
6 * documentation under the terms of the GNU General Public License is hereby
7 * granted. No representations are made about the suitability of this software
8 * for any purpose. It is provided "as is" without express or implied warranty.
9 * See the GNU General Public License for more details.
10 *
11 * Documents produced by Doxygen are derivative works derived from the
12 * input used in their production; they are not affected by this license.
13 *
14 */
15
16#ifndef TRANSLATOR_H
17#define TRANSLATOR_H
18
19#include "classdef.h"
20#include "config.h"
21#include "construct.h"
22#include "datetime.h"
23#include "index.h"
24
25/** Abstract base class for all translatable text fragments. */
27{
28 public:
30
31 /*! This method is used to provide warning message that is displayed
32 * if the user chooses a language whose translation is not up to date.
33 * It is implemented by the adapter classes.
34 */
35 virtual DString updateNeededMessage() { return DString(); }
36
37 // Please, have a look at comments inside the translator_en.h file
38 // to learn the meaning of the following methods. The translator_en.h
39 // file contains the TranslatorEnglish implementation, which is
40 // always up-to-date (by definition).
41
42 // --- Language control methods -------------------
43
44 virtual DString idLanguage() = 0;
46 /*!
47 * Sets the LaTeX font encoding to be used. The default is set to `T1`,
48 * in case another font encoding has to be used this can be specified with
49 * this routine. In case no font encoding is required the empty string
50 * can be returned.
51 */
52 virtual DString latexFontenc() { return DString("T1"); }
53 virtual DString latexFont() {
54 return DString("\\usepackage[scaled=.90]{helvet}\n"
55 "\\usepackage{courier}\n"
56 "\\renewcommand{\\familydefault}{\\sfdefault}\n");
57 }
58 /*!
59 * Sets the commands to be inserted directly after the `\\begin{document}`
60 * in the LaTeX document.
61 */
62 virtual DString latexDocumentPre() { return DString(""); }
63 /*!
64 * Sets the commands to be inserted directly before the `\\end{document}`
65 * in the LaTeX document.
66 */
67 virtual DString latexDocumentPost() { return DString(""); }
68 /*!
69 * Set the name to be used as latex command.
70 */
72 {
73 return p_latexCommandName("pdflatex");
74 }
75 virtual DString trISOLang() = 0;
76
77 /** language codes for Html help
78
79 <pre>
80 0x402 Bulgarian
81 0x405 Czech
82 0x406 Danish
83 0x413 Dutch
84 0xC09 English (Australia)
85 0x809 English (Britain)
86 0x1009 English (Canada)
87 0x1809 English (Ireland)
88 0x1409 English (New Zealand)
89 0x1C09 English (South Africa)
90 0x409 English (United States)
91 0x40B Finnish
92 0x40C French
93 0x407 German
94 0x408 Greece
95 0x439 Hindi
96 0x40E Hungarian
97 0x410 Italian
98 0x814 Norwegian
99 0x415 Polish
100 0x816 Portuguese(Portugal)
101 0x416 Portuguese(Brazil)
102 0x419 Russian
103 0x80A Spanish(Mexico)
104 0xC0A Spanish(Modern Sort)
105 0x40A Spanish(Traditional Sort)
106 0x41D Swedish
107 0x41F Turkey
108 0x411 Japanese
109 0x412 Korean
110 0x804 Chinese (PRC)
111 0x404 Chinese (Taiwan)
112 </pre>
113
114 New LCIDs:
115 <pre>
116 0x421 Indonesian
117 0x41A Croatian
118 0x418 Romanian
119 0x424 Slovenian
120 0x41B Slovak
121 0x422 Ukrainian
122 0x81A Serbian (Serbia, Latin)
123 0x403 Catalan
124 0x426 Latvian
125 0x427 Lithuanian
126 0x436 Afrikaans
127 0x42A Vietnamese
128 0x429 Persian (Iran)
129 0xC01 Arabic (Egypt) - I don't know which version of arabic is used inside translator_ar.h ,
130 so I have chosen Egypt at random
131 </pre>
132
133 Code for Esperanto should be as shown below but the htmlhelp compiler 1.3 does not support this
134 (and no newer version is available).
135 <pre>
136 0x48f Esperanto
137 </pre>
138 So do a fallback to the default language
139 <pre>
140 0x409 English (United States)
141 </pre>
142
143 <pre>
144 0xC1A Serbian (Serbia, Cyrillic)
145 </pre>
146 */
148
149 /**
150 * add punctuation at the end of a brief description when needed and supported by the language
151 */
152 virtual bool needsPunctuation() { return true; }
153
154 // --- Language translation methods -------------------
155
159 virtual DString trDetails() = 0;
164 virtual DString trMore() = 0;
166 virtual DString trMemberList() = 0;
170 virtual DString trEnumName() = 0;
171 virtual DString trEnumValue() = 0;
172 virtual DString trDefinedIn() = 0;
173
174 // quick reference sections
175
176 virtual DString trModules() = 0;
178 virtual DString trCompoundList() = 0;
179 virtual DString trFileList() = 0;
181 virtual DString trFileMembers() = 0;
182 virtual DString trRelatedPages() = 0;
183 virtual DString trExamples() = 0;
184 virtual DString trSearch() = 0;
186 virtual DString trFileListDescription(bool extractAll) = 0;
188 virtual DString trCompoundMembersDescription(bool extractAll) = 0;
189 virtual DString trFileMembersDescription(bool extractAll) = 0;
193
194 // index titles (the project name is prepended for these)
195
196 virtual DString trDocumentation(const DString &projName) = 0;
197 virtual DString trModuleIndex() = 0;
200 virtual DString trFileIndex() = 0;
205 virtual DString trDefines() = 0;
206 virtual DString trTypedefs() = 0;
207 virtual DString trEnumerations() = 0;
208 virtual DString trFunctions() = 0;
209 virtual DString trVariables() = 0;
216 virtual DString trCompounds() = 0;
217 virtual DString trGeneratedAt(const DString &date,const DString &projName) = 0;
218 virtual DString trClassDiagram(const DString &clName) = 0;
219 virtual DString trWarning() = 0;
220 virtual DString trVersion() = 0;
221 virtual DString trDate() = 0;
222 virtual DString trReturns() = 0;
223 virtual DString trSeeAlso() = 0;
224 virtual DString trParameters() = 0;
225 virtual DString trExceptions() = 0;
226 virtual DString trGeneratedBy() = 0;
227
228//////////////////////////////////////////////////////////////////////////
229// new since 0.49-990307
230//////////////////////////////////////////////////////////////////////////
231
233 virtual DString trNamespaceListDescription(bool extractAll) = 0;
234 virtual DString trFriends() = 0;
235
236//////////////////////////////////////////////////////////////////////////
237// new since 0.49-990405
238//////////////////////////////////////////////////////////////////////////
239
241
242//////////////////////////////////////////////////////////////////////////
243// new since 0.49-990425
244//////////////////////////////////////////////////////////////////////////
245
246 virtual DString trCompoundReference(const DString &clName,
247 ClassDef::CompoundType compType,
248 bool isTemplate) = 0;
249
250 virtual DString trFileReference(const DString &fileName) = 0;
251 virtual DString trNamespaceReference(const DString &namespaceName) = 0;
252
254 virtual DString trPublicSlots() = 0;
255 virtual DString trSignals() = 0;
261 virtual DString trPrivateSlots() = 0;
263 virtual DString trWriteList(int numEntries) = 0;
264 virtual DString trInheritsList(int numEntries) = 0;
265 virtual DString trInheritedByList(int numEntries) = 0;
266 virtual DString trReimplementedFromList(int numEntries) = 0;
267 virtual DString trReimplementedInList(int numEntries) = 0;
269 virtual DString trNamespaceMemberDescription(bool extractAll) = 0;
272
273//////////////////////////////////////////////////////////////////////////
274// new since 0.49-990522
275//////////////////////////////////////////////////////////////////////////
276
277 virtual DString trNamespaces() = 0;
278
279//////////////////////////////////////////////////////////////////////////
280// new since 0.49-990728
281//////////////////////////////////////////////////////////////////////////
282
284 bool single) = 0;
285
286//////////////////////////////////////////////////////////////////////////
287// new since 0.49-990901
288//////////////////////////////////////////////////////////////////////////
289
290 virtual DString trReturnValues() = 0;
291 virtual DString trMainPage() = 0;
293
294//////////////////////////////////////////////////////////////////////////
295// new since 0.49-991003
296//////////////////////////////////////////////////////////////////////////
297
300
301//////////////////////////////////////////////////////////////////////////
302// new since 0.49-991205
303//////////////////////////////////////////////////////////////////////////
304
305 virtual DString trDeprecated() = 0;
306
307//////////////////////////////////////////////////////////////////////////
308// new since 1.0.0
309//////////////////////////////////////////////////////////////////////////
310
311 virtual DString trCollaborationDiagram(const DString &clName) = 0;
312 virtual DString trInclDepGraph(const DString &fName) = 0;
316 virtual DString trPrecondition() = 0;
318 virtual DString trInvariant() = 0;
319 virtual DString trInitialValue() = 0;
320 virtual DString trCode() = 0;
321
325 virtual DString trPageIndex() = 0;
326
327//////////////////////////////////////////////////////////////////////////
328// new since 1.1.0
329//////////////////////////////////////////////////////////////////////////
330
331 virtual DString trNote() = 0;
332 virtual DString trPublicTypes() = 0;
338 virtual DString trPrivateTypes() = 0;
341
342//////////////////////////////////////////////////////////////////////////
343// new since 1.1.3
344//////////////////////////////////////////////////////////////////////////
345
346 virtual DString trTodo() = 0;
347 virtual DString trTodoList() = 0;
348
349//////////////////////////////////////////////////////////////////////////
350// new since 1.1.4
351//////////////////////////////////////////////////////////////////////////
352
353 virtual DString trReferencedBy() = 0;
354 virtual DString trRemarks() = 0;
355 virtual DString trAttention() = 0;
357 virtual DString trSince() = 0;
358
359//////////////////////////////////////////////////////////////////////////
360// new since 1.1.5
361//////////////////////////////////////////////////////////////////////////
362
363 virtual DString trLegendTitle() = 0;
364 virtual DString trLegendDocs() = 0;
365 virtual DString trLegend() = 0;
366
367//////////////////////////////////////////////////////////////////////////
368// new since 1.2.0
369//////////////////////////////////////////////////////////////////////////
370
371 virtual DString trTest() = 0;
372 virtual DString trTestList() = 0;
373
374//////////////////////////////////////////////////////////////////////////
375// new since 1.2.2
376//////////////////////////////////////////////////////////////////////////
377
378 virtual DString trProperties() = 0;
380
381//////////////////////////////////////////////////////////////////////////
382// new since 1.2.4
383//////////////////////////////////////////////////////////////////////////
384
385 virtual DString trClasses() = 0;
386 virtual DString trPackage(const DString &name) = 0;
388 virtual DString trPackages() = 0;
389 virtual DString trDefineValue() = 0;
390
391//////////////////////////////////////////////////////////////////////////
392// new since 1.2.5
393//////////////////////////////////////////////////////////////////////////
394
395 virtual DString trBug() = 0;
396 virtual DString trBugList() = 0;
397
398//////////////////////////////////////////////////////////////////////////
399// new since 1.2.6
400//////////////////////////////////////////////////////////////////////////
401
402
403 /*! Used as ansicpg for RTF file
404 *
405 * The following table shows the correlation of Charset name, Charset Value and
406 * <pre>
407 * Codepage number:
408 * Charset Name Charset Value(hex) Codepage number
409 * ------------------------------------------------------
410 * DEFAULT_CHARSET 1 (x01)
411 * SYMBOL_CHARSET 2 (x02)
412 * OEM_CHARSET 255 (xFF)
413 * ANSI_CHARSET 0 (x00) 1252
414 * RUSSIAN_CHARSET 204 (xCC) 1251
415 * EE_CHARSET 238 (xEE) 1250
416 * GREEK_CHARSET 161 (xA1) 1253
417 * TURKISH_CHARSET 162 (xA2) 1254
418 * BALTIC_CHARSET 186 (xBA) 1257
419 * HEBREW_CHARSET 177 (xB1) 1255
420 * ARABIC _CHARSET 178 (xB2) 1256
421 * SHIFTJIS_CHARSET 128 (x80) 932
422 * HANGEUL_CHARSET 129 (x81) 949
423 * GB2313_CHARSET 134 (x86) 936
424 * CHINESEBIG5_CHARSET 136 (x88) 950
425 * </pre>
426 *
427 */
428 virtual DString trRTFansicp() = 0;
429
430 /*! Character sets
431 * <pre>
432 * 0 — ANSI
433 * 1 — Default
434 * 2 — Symbol
435 * 3 — Invalid
436 * 77 — Mac
437 * 128 — Shift Jis
438 * 129 — Hangul
439 * 130 — Johab
440 * 134 — GB2312
441 * 136 — Big5
442 * 161 — Greek
443 * 162 — Turkish
444 * 163 — Vietnamese
445 * 177 — Hebrew
446 * 178 — Arabic
447 * 179 — Arabic Traditional
448 * 180 — Arabic user
449 * 181 — Hebrew user
450 * 186 — Baltic
451 * 204 — Russian
452 * 222 — Thai
453 * 238 — Eastern European
454 * 254 — PC 437
455 * 255 — OEM
456 * </pre>
457 */
458 virtual DString trRTFCharSet() = 0;
460
461 // Translation of the word
462
463 virtual DString trClass(bool first_capital, bool singular) = 0;
464 virtual DString trFile(bool first_capital, bool singular) = 0;
465 virtual DString trNamespace(bool first_capital, bool singular) = 0;
466 virtual DString trGroup(bool first_capital, bool singular) = 0;
467 virtual DString trPage(bool first_capital, bool singular) = 0;
468 virtual DString trMember(bool first_capital, bool singular) = 0;
469 virtual DString trGlobal(bool first_capital, bool singular) = 0;
470
471//////////////////////////////////////////////////////////////////////////
472// new since 1.2.7
473//////////////////////////////////////////////////////////////////////////
474
475 virtual DString trAuthor(bool first_capital, bool singular) = 0;
476
477//////////////////////////////////////////////////////////////////////////
478// new since 1.2.11
479//////////////////////////////////////////////////////////////////////////
480
481 virtual DString trReferences() = 0;
482
483//////////////////////////////////////////////////////////////////////////
484// new since 1.2.13
485//////////////////////////////////////////////////////////////////////////
486
487 virtual DString trImplementedFromList(int numEntries) = 0;
488 virtual DString trImplementedInList(int numEntries) = 0;
489
490//////////////////////////////////////////////////////////////////////////
491// new since 1.2.16
492//////////////////////////////////////////////////////////////////////////
493
495
496//////////////////////////////////////////////////////////////////////////
497// new since 1.2.17
498//////////////////////////////////////////////////////////////////////////
499
501
502//////////////////////////////////////////////////////////////////////////
503// new since 1.2.18
504//////////////////////////////////////////////////////////////////////////
505
506 virtual DString trEvents() = 0;
508
509//////////////////////////////////////////////////////////////////////////
510// new since 1.3
511//////////////////////////////////////////////////////////////////////////
512
513 virtual DString trPackageTypes() = 0;
519
520//////////////////////////////////////////////////////////////////////////
521// new since 1.3.1
522//////////////////////////////////////////////////////////////////////////
523
524 virtual DString trAll() = 0;
525 virtual DString trCallGraph() = 0;
526
527//////////////////////////////////////////////////////////////////////////
528// new since 1.3.3
529//////////////////////////////////////////////////////////////////////////
530
532 virtual DString trSearchResults(int numDocuments) = 0;
534
535//////////////////////////////////////////////////////////////////////////
536// new since 1.3.8
537//////////////////////////////////////////////////////////////////////////
538
539 virtual DString trSourceFile(const DString& filename) = 0;
540
541//////////////////////////////////////////////////////////////////////////
542// new since 1.3.9
543//////////////////////////////////////////////////////////////////////////
544
545 virtual DString trDirIndex() = 0;
547 virtual DString trDirectories() = 0;
548 virtual DString trDirReference(const DString &dirName) = 0;
549 virtual DString trDir(bool first_capital, bool singular) = 0;
550
551//////////////////////////////////////////////////////////////////////////
552// new since 1.4.1
553//////////////////////////////////////////////////////////////////////////
554
555 virtual DString trOverloadText() = 0;
556
557//////////////////////////////////////////////////////////////////////////
558// new since 1.4.6
559//////////////////////////////////////////////////////////////////////////
560
561 virtual DString trCallerGraph() = 0;
563
564//////////////////////////////////////////////////////////////////////////
565// new since 1.5.4
566//////////////////////////////////////////////////////////////////////////
567
572 virtual DString trCompoundMembersDescriptionFortran(bool extractAll) = 0;
575 virtual DString trSubprograms() = 0;
577 virtual DString trDataTypes() = 0;
578 virtual DString trModulesList() = 0;
579 virtual DString trModulesListDescription(bool extractAll) = 0;
581 ClassDef::CompoundType compType,
582 bool isTemplate) = 0;
583 virtual DString trModuleReference(const DString &namespaceName) = 0;
585 virtual DString trModulesMemberDescription(bool extractAll) = 0;
586 virtual DString trModulesIndex() = 0;
587 virtual DString trModule(bool first_capital, bool singular) = 0;
589 bool single) = 0;
590 virtual DString trType(bool first_capital, bool singular) = 0;
591 virtual DString trSubprogram(bool first_capital, bool singular) = 0;
593
594//////////////////////////////////////////////////////////////////////////
595// new since 1.6.0
596//////////////////////////////////////////////////////////////////////////
597
598 virtual DString trDirRelation(const DString &name) = 0;
599 virtual DString trLoading() = 0;
601 virtual DString trSearching() = 0;
602 virtual DString trNoMatches() = 0;
603
604//////////////////////////////////////////////////////////////////////////
605// new since 1.6.3
606//////////////////////////////////////////////////////////////////////////
607
608 virtual DString trFileIn(const DString &name) = 0;
609 virtual DString trIncludesFileIn(const DString &name) = 0;
610 virtual DString trDateTime(int year,int month,int day,int dayOfWeek,
611 int hour,int minutes,int seconds,
612 DateTimeType includeTime) = 0;
613 virtual DString trDayOfWeek(int dayOfWeek, bool first_capital, bool full) = 0;
614 virtual DString trMonth(int month, bool first_capital, bool full) = 0;
615 virtual DString trDayPeriod(bool period) = 0;
616
617//////////////////////////////////////////////////////////////////////////
618// new since 1.7.5
619//////////////////////////////////////////////////////////////////////////
620
622 virtual DString trCopyright() = 0;
623 virtual DString trDirDepGraph(const DString &name) = 0;
624
625//////////////////////////////////////////////////////////////////////////
626// new since 1.8.0
627//////////////////////////////////////////////////////////////////////////
628
629 virtual DString trDetailLevel() = 0;
631 virtual DString trAndMore(const DString &number) = 0;
632 virtual DString trEnumGeneratedFromFiles(bool single) = 0;
633 virtual DString trEnumReference(const DString &name) = 0;
634 virtual DString trInheritedFrom(const DString &members,const DString &what) = 0;
636
637//////////////////////////////////////////////////////////////////////////
638// new since 1.8.2
639//////////////////////////////////////////////////////////////////////////
640
641 virtual DString trPanelSynchronisationTooltip(bool enable) = 0;
643 virtual DString trExtendsClass() = 0;
644 virtual DString trClassMethods() = 0;
647
648//////////////////////////////////////////////////////////////////////////
649// new since 1.8.4
650//////////////////////////////////////////////////////////////////////////
651
652 virtual DString trInterfaces() = 0;
653 virtual DString trServices() = 0;
655 virtual DString trConstantGroupReference(const DString &namespaceName) = 0;
656 virtual DString trServiceReference(const DString &sName) = 0;
657 virtual DString trSingletonReference(const DString &sName) = 0;
658 virtual DString trServiceGeneratedFromFiles(bool single) = 0;
659 virtual DString trSingletonGeneratedFromFiles(bool single) = 0;
660
661//////////////////////////////////////////////////////////////////////////
662// new since 1.8.15
663//////////////////////////////////////////////////////////////////////////
664
670 virtual DString trDesignUnits() = 0;
672 virtual DString trVhdlType(VhdlSpecifier type,bool single) = 0;
673 virtual DString trCustomReference(const DString &name) = 0;
674
675 virtual DString trConstants() = 0;
677 virtual DString trSequences() = 0;
679 virtual DString trDictionaries() = 0;
688 virtual DString trStructs() = 0;
689 virtual DString trStructIndex() = 0;
690 virtual DString trStructList() = 0;
699 virtual DString trCompoundReferenceSlice(const DString &clName, ClassDef::CompoundType compType, bool isLocal) = 0;
700 virtual DString trOperations() = 0;
702 virtual DString trDataMembers() = 0;
704
705//////////////////////////////////////////////////////////////////////////
706// new since 1.8.19
707//////////////////////////////////////////////////////////////////////////
708
710
711//////////////////////////////////////////////////////////////////////////
712// new since 1.9.2
713//////////////////////////////////////////////////////////////////////////
714
715 virtual DString trConcept(bool first_capital, bool singular) = 0;
716 virtual DString trConceptReference(const DString &conceptName) = 0;
717 virtual DString trConceptList() = 0;
718 virtual DString trConceptIndex() = 0;
720 virtual DString trConceptListDescription(bool extractAll) = 0;
722
723//////////////////////////////////////////////////////////////////////////
724// new since 1.9.4
725//////////////////////////////////////////////////////////////////////////
726 virtual DString trPackageList() = 0;
727
728//////////////////////////////////////////////////////////////////////////
729// new since 1.9.6
730//////////////////////////////////////////////////////////////////////////
731 virtual DString trFlowchart() = 0;
732
733//////////////////////////////////////////////////////////////////////////
734// new since 1.9.7
735//////////////////////////////////////////////////////////////////////////
739
741
745 virtual DString trDefinition() = 0;
746 virtual DString trDeclaration() = 0;
747//////////////////////////////////////////////////////////////////////////
748// new since 1.9.8
749//////////////////////////////////////////////////////////////////////////
750 virtual DString trTopics() = 0;
752 virtual DString trTopicList() = 0;
753 virtual DString trTopicIndex() = 0;
757//////////////////////////////////////////////////////////////////////////
758// new since 1.10.0
759//////////////////////////////////////////////////////////////////////////
761//////////////////////////////////////////////////////////////////////////
762// new since 1.11.0
763//////////////////////////////////////////////////////////////////////////
764 virtual DString trImportant() = 0;
765
766//////////////////////////////////////////////////////////////////////////
767// new since 1.16.0
768//////////////////////////////////////////////////////////////////////////
769 virtual DString trRequirements() = 0;
771 virtual DString trSatisfies(bool singular) = 0;
772 virtual DString trSatisfiedBy(const DString &list) = 0;
774 virtual DString trUnsatisfiedRequirementsText(bool singular,const DString &list) = 0;
775 virtual DString trVerifies(bool singular) = 0;
776 virtual DString trVerifiedBy(const DString &list) = 0;
778 virtual DString trUnverifiedRequirementsText(bool singular,const DString &list) = 0;
779
780
781
782//////////////////////////////////////////////////////////////////////////
783// helpers
784//////////////////////////////////////////////////////////////////////////
785 protected:
787 {
788 DString latex_command = Config_getString(LATEX_CMD_NAME);
789 if (latex_command.empty()) latex_command = "latex";
790 if (Config_getBool(USE_PDFLATEX))
791 {
792 if (latex_command == "latex") latex_command = latexCmd;
793 }
794 return latex_command;
795 }
796 /*! For easy flexible-noun implementation.
797 * \internal
798 */
799 DString createNoun(bool first_capital, bool singular,
800 const DString &base,
801 const DString &plurSuffix, const DString &singSuffix = "" )
802 {
803 DString result;
804 if (first_capital)
805 {
806 DString lc = getUTF8CharAt(base.str(),0);
807 DString uc = convertUTF8ToUpper(lc.str());
808 result = uc + base.mid(lc.length());
809 }
810 else
811 {
812 result = base;
813 }
814 result += (singular ? singSuffix : plurSuffix);
815 return result;
816 }
817
818};
819
820#endif
CompoundType
The various compound types.
Definition classdef.h:105
A String class for use with Doxygen wrapping std::string and adding some additional functionality off...
Definition dstring.h:84
DString mid(size_t index, size_t len=npos) const
Definition dstring.h:318
bool empty() const
Returns true iff the string is empty (std::string compatible alias for isEmpty()).
Definition dstring.h:148
const std::string & str() const
Definition dstring.h:645
size_t length() const
Returns the length of the string, not counting the 0-terminator.
Definition dstring.h:151
Abstract base class for all translatable text fragments.
Definition translator.h:27
virtual DString trCompoundMembers()=0
virtual DString trFileDocumentation()=0
virtual DString trFunctionAndProc()=0
virtual DString latexDocumentPost()
Definition translator.h:67
virtual DString trConceptReference(const DString &conceptName)=0
virtual DString trStaticProtectedAttribs()=0
virtual DString trVerifies(bool singular)=0
virtual DString trTypeConstraints()=0
virtual DString trProtectedTypes()=0
virtual DString trTypedefs()=0
virtual DString trConceptList()=0
virtual DString trTestList()=0
virtual DString trGraphicalHierarchy()=0
virtual DString trBugList()=0
virtual DString trUnsatisfiedRequirements()=0
virtual DString trTopics()=0
virtual DString trModulesMembers()=0
virtual DString trReferences()=0
virtual DString trCompoundMembersFortran()=0
virtual DString trCompoundReference(const DString &clName, ClassDef::CompoundType compType, bool isTemplate)=0
virtual DString trStaticProtectedMembers()=0
virtual DString trPublicAttribs()=0
virtual DString trExceptions()=0
virtual DString trModulesList()=0
virtual DString trEnumerations()=0
virtual DString trDirDepGraph(const DString &name)=0
virtual DString trReturns()=0
virtual DString trRelatedSymbolDocumentation()=0
virtual DString trBug()=0
virtual DString trProvidedByCategory()=0
virtual DString trIncludingInheritedMembers()=0
virtual DString trClasses()=0
virtual DString trDetailedDescription()=0
virtual DString trParameters()=0
virtual DString trDataMemberDocumentation()=0
virtual DString trRequirements()=0
virtual DString trFileMembersDescriptionTotal(FileMemberHighlight::Enum hl)=0
virtual DString trExceptionDocumentation()=0
virtual DString trInterfaceIndex()=0
virtual DString trNamespaceMembers()=0
virtual DString trCopyright()=0
virtual DString trLegend()=0
virtual DString trVariableDocumentation()=0
virtual DString trNamespaceMemberDescription(bool extractAll)=0
virtual DString trSearching()=0
virtual DString trFileMembersDescription(bool extractAll)=0
virtual DString trGroup(bool first_capital, bool singular)=0
virtual DString trPackageMembers()=0
virtual DString trNamespaceList()=0
DString createNoun(bool first_capital, bool singular, const DString &base, const DString &plurSuffix, const DString &singSuffix="")
Definition translator.h:799
virtual DString trRelatedFunctionDocumentation()=0
virtual DString trRTFCharSet()=0
virtual DString trWarning()=0
virtual DString idLanguage()=0
virtual DString trPrivateAttribs()=0
virtual DString trExceptionList()=0
virtual DString trServiceGeneratedFromFiles(bool single)=0
virtual DString trGeneratedAt(const DString &date, const DString &projName)=0
virtual DString trMemberList()=0
virtual DString trSequenceDocumentation()=0
virtual DString trIncludesFileIn(const DString &name)=0
virtual DString latexFontenc()
Definition translator.h:52
virtual DString trSince()=0
virtual DString trInheritedFrom(const DString &members, const DString &what)=0
virtual DString trTypedefDocumentation()=0
virtual DString trPackage(const DString &name)=0
virtual DString trPrivateSlots()=0
virtual DString trAdditionalInheritedMembers()=0
virtual DString trReimplementedFromList(int numEntries)=0
virtual DString trNamespace(bool first_capital, bool singular)=0
virtual DString trNote()=0
virtual DString updateNeededMessage()
Definition translator.h:35
virtual DString trCode()=0
virtual DString trDefineValue()=0
virtual DString trCompoundReferenceSlice(const DString &clName, ClassDef::CompoundType compType, bool isLocal)=0
virtual DString trStructs()=0
virtual DString trType(bool first_capital, bool singular)=0
virtual DString trAuthor(bool first_capital, bool singular)=0
virtual DString trPrivateTypes()=0
virtual DString trClassDocumentation()=0
virtual DString trHierarchicalIndex()=0
virtual DString trSubprogram(bool first_capital, bool singular)=0
virtual DString trExceptionHierarchyDescription()=0
virtual DString trReturnValues()=0
virtual DString trRelatedSubscript()=0
virtual DString trCiteReferences()=0
virtual DString trOperationDocumentation()=0
virtual DString trOverloadText()=0
virtual DString trFileReference(const DString &fileName)=0
virtual DString trDirRelation(const DString &name)=0
virtual DString latexLanguageSupportCommand()=0
virtual DString trInterfaceList()=0
virtual DString trSequences()=0
virtual DString trClassMethods()=0
virtual DString trServiceReference(const DString &sName)=0
virtual DString trVersion()=0
virtual DString trFunctions()=0
virtual DString trReferenceManual()=0
virtual DString trClassDiagram(const DString &clName)=0
virtual DString trImplementedInList(int numEntries)=0
virtual DString trMemberEnumerationDocumentation()=0
virtual DString trProtectedSlots()=0
virtual DString trInterfaceListDescription()=0
virtual DString trTemplateParameters()=0
virtual DString trReferencedBy()=0
virtual DString trFriends()=0
virtual DString trCustomReference(const DString &name)=0
virtual DString trConceptIndex()=0
virtual DString trCompoundType(ClassDef::CompoundType compType, SrcLangExt lang)=0
virtual DString trPropertyDocumentation()=0
virtual DString trTopicIndex()=0
virtual DString trInstanceMethods()=0
virtual DString trGotoTextualHierarchy()=0
virtual DString trGotoDocumentation()=0
virtual DString trExceptionHierarchy()=0
virtual DString trCompoundList()=0
virtual DString trModuleIndex()=0
virtual DString trCollaborationDiagram(const DString &clName)=0
virtual DString trPackageAttribs()=0
virtual DString trDetailLevel()=0
virtual DString trInitialValue()=0
virtual DString trEnumerationTypeDocumentation()=0
virtual DString trImplementedFromList(int numEntries)=0
virtual DString trInterfaceHierarchy()=0
virtual DString trDir(bool first_capital, bool singular)=0
virtual DString trSearchResults(int numDocuments)=0
virtual DString trTypeDocumentation()=0
virtual DString trPackageList()=0
virtual DString trInterfaceDocumentation()=0
virtual DString trMemberTypedefDocumentation()=0
virtual DString trEnumerationValueDocumentation()=0
virtual DString trModulesDescription()=0
virtual DString trStaticPackageAttribs()=0
virtual DString trStructListDescription()=0
virtual DString trOperations()=0
virtual DString trGlobalNamespace()=0
virtual DString trConceptDefinition()=0
virtual DString trDefineDocumentation()=0
DString p_latexCommandName(const DString &latexCmd)
Definition translator.h:786
virtual DString trDesignUnitListDescription()=0
virtual DString trDocumentation(const DString &projName)=0
virtual DString trExamplesDescription()=0
virtual DString trImportant()=0
virtual DString trNamespaceDocumentation()=0
virtual DString trCompounds()=0
virtual DString trFileList()=0
virtual DString trDateTime(int year, int month, int day, int dayOfWeek, int hour, int minutes, int seconds, DateTimeType includeTime)=0
virtual DString trModules()=0
virtual DString trRequirementID()=0
virtual DString trLegendDocs()=0
virtual DString trTodoList()=0
virtual DString trInheritedByList(int numEntries)=0
virtual DString trDefines()=0
virtual DString trRelatedPages()=0
virtual DString trInclDepGraph(const DString &fName)=0
virtual DString trUnverifiedRequirementsText(bool singular, const DString &list)=0
virtual DString trMore()=0
virtual DString trLegendTitle()=0
virtual DString trEnumName()=0
virtual DString trDefinedIn()=0
virtual DString trPublicMembers()=0
virtual DString trSubprogramDocumentation()=0
virtual DString trCompoundListDescriptionFortran()=0
virtual DString trVhdlType(VhdlSpecifier type, bool single)=0
virtual DString trInterfaces()=0
virtual DString trRelatedSymbols()=0
virtual DString trFileMembers()=0
virtual DString trDesignUnitHierarchy()=0
virtual DString trDesignUnits()=0
virtual DString trProtectedMembers()=0
virtual DString trDirectories()=0
virtual DString trInterfaceHierarchyDescription()=0
virtual DString trStaticPrivateAttribs()=0
virtual DString trSatisfiedBy(const DString &list)=0
virtual DString trStructIndex()=0
virtual DString trExceptionIndex()=0
virtual DString trConstructorDocumentation()=0
virtual DString trThisIsTheListOfAllMembers()=0
virtual DString trEnumGeneratedFromFiles(bool single)=0
virtual DString trPackageTypes()=0
virtual DString trExportedModules()=0
virtual DString trModule(bool first_capital, bool singular)=0
virtual DString trSingletonReference(const DString &sName)=0
virtual DString trDictionaryDocumentation()=0
virtual DString trProtectedAttribs()=0
virtual DString trPageIndex()=0
virtual DString trISOLang()=0
virtual DString trDeclaration()=0
virtual DString trPrecondition()=0
virtual DString trModuleDocumentation()=0
virtual DString trSearchMatches()=0
virtual DString trDesignUnitMembers()=0
virtual DString latexFont()
Definition translator.h:53
virtual DString latexDocumentPre()
Definition translator.h:62
virtual DString trModuleReference(const DString &namespaceName)=0
virtual DString trFlowchart()=0
virtual DString trRTFansicp()=0
virtual DString trConstantGroups()=0
virtual DString trDefinedAtLineInSourceFile()=0
virtual DString getLanguageString()=0
language codes for Html help
virtual DString trDayOfWeek(int dayOfWeek, bool first_capital, bool full)=0
virtual DString trAttention()=0
virtual DString trExceptionListDescription()=0
virtual DString trProperties()=0
virtual DString trPageAbbreviation()=0
virtual DString trRelatedPagesDescription()=0
virtual DString trInvariant()=0
virtual DString trDesignUnitList()=0
virtual DString trModulesMemberDescription(bool extractAll)=0
virtual DString trClass(bool first_capital, bool singular)=0
virtual DString trReimplementedInList(int numEntries)=0
virtual DString trCompoundIndexFortran()=0
virtual DString trDataTypes()=0
virtual DString trCompoundListDescription()=0
virtual DString trConcept(bool first_capital, bool singular)=0
virtual DString trTopicListDescription()=0
virtual DString trModulesIndex()=0
virtual DString trFileIn(const DString &name)=0
virtual DString trModuleMembersDescriptionTotal(ModuleMemberHighlight::Enum hl)=0
virtual DString trUnsatisfiedRequirementsText(bool singular, const DString &list)=0
virtual DString trDataMembers()=0
virtual DString trFileListDescription(bool extractAll)=0
virtual DString trClassHierarchyDescription()=0
virtual DString trSliceInterfaces()=0
virtual DString trConceptListDescription(bool extractAll)=0
virtual DString trFunctionDocumentation()=0
virtual DString trInclByDepGraph()=0
virtual DString trPanelSynchronisationTooltip(bool enable)=0
virtual DString trSubprograms()=0
virtual DString trVerifiedBy(const DString &list)=0
virtual DString trDetails()=0
virtual DString trExtendsClass()=0
virtual DString trAll()=0
virtual DString trMemberFunctionDocumentationFortran()=0
virtual DString trMemberFunctionDocumentation()=0
virtual DString trCompoundListFortran()=0
virtual DString trTopicDocumentation()=0
virtual DString trCallerGraph()=0
virtual DString trDeprecatedList()=0
virtual DString trPackageFunctions()=0
virtual bool needsPunctuation()
add punctuation at the end of a brief description when needed and supported by the language
Definition translator.h:152
virtual DString trWriteList(int numEntries)=0
virtual DString trMember(bool first_capital, bool singular)=0
virtual DString trPackages()=0
virtual DString trGeneratedFromFiles(ClassDef::CompoundType compType, bool single)=0
virtual DString trPrivateMembers()=0
virtual DString trSearch()=0
virtual DString trPackageListDescription()=0
virtual DString trGeneratedBy()=0
virtual DString trRTFGeneralIndex()=0
virtual DString trConstantDocumentation()=0
virtual DString trDirReference(const DString &dirName)=0
virtual DString trPublicTypes()=0
virtual DString trDefinition()=0
virtual DString trVariables()=0
virtual DString trStaticPublicMembers()=0
virtual DString trMethodDocumentation()=0
virtual DString trConceptDocumentation()=0
virtual DString trRemarks()=0
virtual DString trDeprecated()=0
virtual DString trDate()=0
virtual DString trEnumerationValues()=0
virtual DString trSourceFile(const DString &filename)=0
virtual DString trRTFTableOfContents()=0
virtual DString trAndMore(const DString &number)=0
virtual DString trListOfAllMembers()=0
virtual DString trSeeAlso()=0
virtual DString trTodo()=0
virtual DString trNoMatches()=0
virtual DString trRelatedSymbolsSubscript()=0
virtual DString trDirDocumentation()=0
virtual DString trStaticPublicAttribs()=0
virtual DString trSatisfies(bool singular)=0
virtual DString trModulesListDescription(bool extractAll)=0
virtual DString trEnumValue()=0
virtual DString trGotoSourceCode()=0
virtual DString trServices()=0
virtual DString trPage(bool first_capital, bool singular)=0
virtual DString trStructList()=0
virtual DString trNamespaceListDescription(bool extractAll)=0
virtual DString trCompoundMembersDescriptionTotal(ClassMemberHighlight::Enum hl)=0
virtual DString trRelatedFunctions()=0
virtual DString trTopicList()=0
virtual DString trInheritsList(int numEntries)=0
virtual DString trSignals()=0
virtual DString trGeneratedAutomatically(const DString &s)=0
virtual DString trClassHierarchy()=0
virtual DString trDirIndex()=0
virtual DString trCopyToClipboard()=0
virtual DString trUnverifiedRequirements()=0
virtual DString trNamespaceReference(const DString &namespaceName)=0
virtual DString trGeneratedFromFilesFortran(ClassDef::CompoundType compType, bool single)=0
virtual DString trPublicSlots()=0
virtual DString trCompoundIndex()=0
virtual DString trFile(bool first_capital, bool singular)=0
virtual DString trTest()=0
virtual DString trDesignUnitIndex()=0
virtual DString trConstants()=0
virtual DString trDesignUnitDocumentation()=0
virtual DString trSearchResultsTitle()=0
virtual DString trConstantGroupReference(const DString &namespaceName)=0
virtual DString trDayPeriod(bool period)=0
virtual DString latexCommandName()
Definition translator.h:71
virtual DString trCompoundMembersDescription(bool extractAll)=0
virtual DString trLoading()=0
virtual DString trEventDocumentation()=0
virtual DString trCompoundReferenceFortran(const DString &clName, ClassDef::CompoundType compType, bool isTemplate)=0
virtual DString trMonth(int month, bool first_capital, bool full)=0
virtual DString trStructDocumentation()=0
virtual DString trMainPage()=0
virtual DString trEnumReference(const DString &name)=0
virtual DString trNamespaces()=0
virtual DString trCompoundMembersDescriptionFortran(bool extractAll)=0
virtual DString trCallGraph()=0
virtual DString trSingletonGeneratedFromFiles(bool single)=0
virtual DString trMemberDataDocumentation()=0
virtual DString trEvents()=0
virtual DString trDictionaries()=0
virtual DString trStaticPackageFunctions()=0
virtual DString trFileIndex()=0
virtual DString trGlobal(bool first_capital, bool singular)=0
virtual DString trPostcondition()=0
virtual DString trExamples()=0
virtual DString trStaticPrivateMembers()=0
virtual DString trNamespaceMembersDescriptionTotal(NamespaceMemberHighlight::Enum hl)=0
virtual DString trDefinedInSourceFile()=0
virtual DString trGotoGraphicalHierarchy()=0
virtual DString trNamespaceIndex()=0
#define Config_getBool(name)
Definition config.h:33
#define Config_getString(name)
Definition config.h:32
#define ABSTRACT_BASE_CLASS(cls)
Macro to implement rule of 5 for an abstract base class.
Definition construct.h:20
DateTimeType
Definition datetime.h:38
SrcLangExt
Definition types.h:207
VhdlSpecifier
Definition types.h:770
std::string convertUTF8ToUpper(const std::string &input)
Converts the input string into a upper case version, also taking into account non-ASCII characters th...
Definition utf8.cpp:196
std::string getUTF8CharAt(const std::string &input, size_t pos)
Returns the UTF8 character found at byte position pos in the input string.
Definition utf8.cpp:131