OpenShot Audio Library | OpenShotAudio  0.3.0
juce_LocalisedStrings.cpp
1 /*
2  ==============================================================================
3 
4  This file is part of the JUCE library.
5  Copyright (c) 2017 - ROLI Ltd.
6 
7  JUCE is an open source library subject to commercial or open-source
8  licensing.
9 
10  The code included in this file is provided under the terms of the ISC license
11  http://www.isc.org/downloads/software-support-policy/isc-license. Permission
12  To use, copy, modify, and/or distribute this software for any purpose with or
13  without fee is hereby granted provided that the above copyright notice and
14  this permission notice appear in all copies.
15 
16  JUCE IS PROVIDED "AS IS" WITHOUT ANY WARRANTY, AND ALL WARRANTIES, WHETHER
17  EXPRESSED OR IMPLIED, INCLUDING MERCHANTABILITY AND FITNESS FOR PURPOSE, ARE
18  DISCLAIMED.
19 
20  ==============================================================================
21 */
22 
23 namespace juce
24 {
25 
26 LocalisedStrings::LocalisedStrings (const String& fileContents, bool ignoreCase)
27 {
28  loadFromText (fileContents, ignoreCase);
29 }
30 
31 LocalisedStrings::LocalisedStrings (const File& fileToLoad, bool ignoreCase)
32 {
33  loadFromText (fileToLoad.loadFileAsString(), ignoreCase);
34 }
35 
37  : languageName (other.languageName), countryCodes (other.countryCodes),
38  translations (other.translations), fallback (createCopyIfNotNull (other.fallback.get()))
39 {
40 }
41 
42 LocalisedStrings& LocalisedStrings::operator= (const LocalisedStrings& other)
43 {
44  languageName = other.languageName;
45  countryCodes = other.countryCodes;
46  translations = other.translations;
47  fallback.reset (createCopyIfNotNull (other.fallback.get()));
48  return *this;
49 }
50 
52 {
53 }
54 
55 //==============================================================================
57 {
58  if (fallback != nullptr && ! translations.containsKey (text))
59  return fallback->translate (text);
60 
61  return translations.getValue (text, text);
62 }
63 
64 String LocalisedStrings::translate (const String& text, const String& resultIfNotFound) const
65 {
66  if (fallback != nullptr && ! translations.containsKey (text))
67  return fallback->translate (text, resultIfNotFound);
68 
69  return translations.getValue (text, resultIfNotFound);
70 }
71 
72 namespace
73 {
74  #if JUCE_CHECK_MEMORY_LEAKS
75  // By using this object to force a LocalisedStrings object to be created
76  // before the currentMappings object, we can force the static order-of-destruction to
77  // delete the currentMappings object first, which avoids a bogus leak warning.
78  // (Oddly, just creating a LocalisedStrings on the stack doesn't work in gcc, it
79  // has to be created with 'new' for this to work..)
80  struct LeakAvoidanceTrick
81  {
82  LeakAvoidanceTrick()
83  {
84  const std::unique_ptr<LocalisedStrings> dummy (new LocalisedStrings (String(), false));
85  }
86  };
87 
88  LeakAvoidanceTrick leakAvoidanceTrick;
89  #endif
90 
91  SpinLock currentMappingsLock;
92  std::unique_ptr<LocalisedStrings> currentMappings;
93 
94  static int findCloseQuote (const String& text, int startPos)
95  {
96  juce_wchar lastChar = 0;
97  auto t = text.getCharPointer() + startPos;
98 
99  for (;;)
100  {
101  auto c = t.getAndAdvance();
102 
103  if (c == 0 || (c == '"' && lastChar != '\\'))
104  break;
105 
106  lastChar = c;
107  ++startPos;
108  }
109 
110  return startPos;
111  }
112 
113  static String unescapeString (const String& s)
114  {
115  return s.replace ("\\\"", "\"")
116  .replace ("\\\'", "\'")
117  .replace ("\\t", "\t")
118  .replace ("\\r", "\r")
119  .replace ("\\n", "\n");
120  }
121 }
122 
123 void LocalisedStrings::loadFromText (const String& fileContents, bool ignoreCase)
124 {
125  translations.setIgnoresCase (ignoreCase);
126 
127  StringArray lines;
128  lines.addLines (fileContents);
129 
130  for (auto& l : lines)
131  {
132  auto line = l.trim();
133 
134  if (line.startsWithChar ('"'))
135  {
136  auto closeQuote = findCloseQuote (line, 1);
137  auto originalText = unescapeString (line.substring (1, closeQuote));
138 
139  if (originalText.isNotEmpty())
140  {
141  auto openingQuote = findCloseQuote (line, closeQuote + 1);
142  closeQuote = findCloseQuote (line, openingQuote + 1);
143  auto newText = unescapeString (line.substring (openingQuote + 1, closeQuote));
144 
145  if (newText.isNotEmpty())
146  translations.set (originalText, newText);
147  }
148  }
149  else if (line.startsWithIgnoreCase ("language:"))
150  {
151  languageName = line.substring (9).trim();
152  }
153  else if (line.startsWithIgnoreCase ("countries:"))
154  {
155  countryCodes.addTokens (line.substring (10).trim(), true);
156  countryCodes.trim();
157  countryCodes.removeEmptyStrings();
158  }
159  }
160 
161  translations.minimiseStorageOverheads();
162 }
163 
165 {
166  jassert (languageName == other.languageName);
167  jassert (countryCodes == other.countryCodes);
168 
169  translations.addArray (other.translations);
170 }
171 
173 {
174  fallback.reset (f);
175 }
176 
177 //==============================================================================
179 {
180  const SpinLock::ScopedLockType sl (currentMappingsLock);
181  currentMappings.reset (newTranslations);
182 }
183 
185 {
186  return currentMappings.get();
187 }
188 
189 String LocalisedStrings::translateWithCurrentMappings (const String& text) { return juce::translate (text); }
190 String LocalisedStrings::translateWithCurrentMappings (const char* text) { return juce::translate (text); }
191 
192 JUCE_API String translate (const String& text) { return juce::translate (text, text); }
193 JUCE_API String translate (const char* text) { return juce::translate (String (text)); }
194 JUCE_API String translate (CharPointer_UTF8 text) { return juce::translate (String (text)); }
195 
196 JUCE_API String translate (const String& text, const String& resultIfNotFound)
197 {
198  const SpinLock::ScopedLockType sl (currentMappingsLock);
199 
200  if (auto* mappings = LocalisedStrings::getCurrentMappings())
201  return mappings->translate (text, resultIfNotFound);
202 
203  return resultIfNotFound;
204 }
205 
206 } // namespace juce
String translate(const String &text) const
void setFallback(LocalisedStrings *fallbackStrings)
static void setCurrentMappings(LocalisedStrings *newTranslations)
CharPointerType getCharPointer() const noexcept
Definition: juce_String.h:1198
int addLines(StringRef stringToBreakUp)
String getValue(StringRef, const String &defaultReturnValue) const
LocalisedStrings(const String &fileContents, bool ignoreCaseOfKeys)
static LocalisedStrings * getCurrentMappings()
String loadFileAsString() const
Definition: juce_File.cpp:550
static String translateWithCurrentMappings(const String &text)
void addStrings(const LocalisedStrings &)
String replace(StringRef stringToReplace, StringRef stringToInsertInstead, bool ignoreCase=false) const
bool containsKey(StringRef key) const noexcept