Aren/haiku
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
6980817672
haiku/headers/os/locale/MessageFormat.h

45 lines
898 B
C
Raw Normal View History

Add BMessageFormat class. This can be used to format complex messages properly. It moves the complexity of handling plural forms, gender, and anything else needed into the localizable string, rather than hardcoding it in the code. This moves the difficulty of handling these things properly to people doing translations, rather than relying on developers to do it. Fixes #10755, but our localization must now be updated to make use of the feature.
2014-10-07 10:51:23 +04:00
/*
MessageFormat: Use off_t argument instead of int32 Which doubles the maximum width fixing #11809. I wanted to convert this to a variadic functionbut that would require updating all of the instance that use MessageFormat or a clever hack to get around the ambiguity of an off_t argument and an int argument count with 0 arguments. Either way seemed out of the scope of fixing this bug. Fixes #11809 Another Beta1 bug down!
2015-03-04 22:27:00 +03:00
* Copyright 2014-2015 Haiku, Inc. All rights reserved.
Add BMessageFormat class. This can be used to format complex messages properly. It moves the complexity of handling plural forms, gender, and anything else needed into the localizable string, rather than hardcoding it in the code. This moves the difficulty of handling these things properly to people doing translations, rather than relying on developers to do it. Fixes #10755, but our localization must now be updated to make use of the feature.
2014-10-07 10:51:23 +04:00
* Distributed under the terms of the MIT License.
MessageFormat: Use off_t argument instead of int32 Which doubles the maximum width fixing #11809. I wanted to convert this to a variadic functionbut that would require updating all of the instance that use MessageFormat or a clever hack to get around the ambiguity of an off_t argument and an int argument count with 0 arguments. Either way seemed out of the scope of fixing this bug. Fixes #11809 Another Beta1 bug down!
2015-03-04 22:27:00 +03:00
*
* Authors:
* Adrien Destugues, pulkomandy@pulkomandy.tk
* John Scipione, jscipione@gmail.com
Add BMessageFormat class. This can be used to format complex messages properly. It moves the complexity of handling plural forms, gender, and anything else needed into the localizable string, rather than hardcoding it in the code. This moves the difficulty of handling these things properly to people doing translations, rather than relying on developers to do it. Fixes #10755, but our localization must now be updated to make use of the feature.
2014-10-07 10:51:23 +04:00
*/
#ifndef _B_MESSAGE_FORMAT_H_
#define _B_MESSAGE_FORMAT_H_
#include <Format.h>
Update icu x86_64 package with namespace renaming enabled. "Renaming" means the icu namespace is suffixed with the version number, atm icu_55. Using "renaming" allows to use two different versions of ICU, thus easing upgrades. For instance haikuwebkit uses a current version of ICU, while the system uses a newer one after an upgrade. * Replace all uses of the icu namespace in our public headers, with a macro defaulting to icu. As the namespace is only used for private fields pointers, there should be no impact. * Locale kit *.cpp have to import the macro from <unicode/uversion.h> *before* including any locale headers. Ditto for a Time preferences cpp file. This way, the correct current icu namespace is referenced. * Fixes bug #12057.
2015-05-10 22:13:59 +03:00
#ifndef U_ICU_NAMESPACE
#define U_ICU_NAMESPACE icu
#endif
namespace U_ICU_NAMESPACE {
BMessageFormat: parse the pattern at construction * Instead of parsing the pattern everytime Format() is called, parse it only once when the object is created. * Adjust all callers to make use of the feature and reuse the instance as much as possible. This also allows calling B_TRANSLATE only once instead of everytime the formatting needs to be done. We use either a static instance (when the message pattern is constant) or a field (when it is not known to be constant). * Since the BMessageFormat instances are now reused, add locking to avoid race conditions (ICU itself is thread safe, but the format pattern is recreated when the locale is changed)
2014-10-08 17:12:48 +04:00
class MessageFormat;
class UnicodeString;
}
Add BMessageFormat class. This can be used to format complex messages properly. It moves the complexity of handling plural forms, gender, and anything else needed into the localizable string, rather than hardcoding it in the code. This moves the difficulty of handling these things properly to people doing translations, rather than relying on developers to do it. Fixes #10755, but our localization must now be updated to make use of the feature.
2014-10-07 10:51:23 +04:00
class BMessageFormat: public BFormat {
public:
B*Format: make immutable and remove locking The language and formatting conventions can now only be set when creating the objects. This removed the needs for locking them when formatting to avoid some other thread changing the format while it's being used. Adjust tests and DeskBar TimeView to the API changes.
2014-10-27 11:05:48 +03:00
BMessageFormat(const BLanguage& language,
const BString pattern);
BMessageFormat: parse the pattern at construction * Instead of parsing the pattern everytime Format() is called, parse it only once when the object is created. * Adjust all callers to make use of the feature and reuse the instance as much as possible. This also allows calling B_TRANSLATE only once instead of everytime the formatting needs to be done. We use either a static instance (when the message pattern is constant) or a field (when it is not known to be constant). * Since the BMessageFormat instances are now reused, add locking to avoid race conditions (ICU itself is thread safe, but the format pattern is recreated when the locale is changed)
2014-10-08 17:12:48 +04:00
BMessageFormat(const BString pattern);
~BMessageFormat();
status_t InitCheck();
MessageFormat: Use int64 instead of off_t They are effectively the same thing, but int64 is more generic. I used an off_t because that is what Tracker passed in, yet, this could be used in other places where an off_t doesn't make as much sense.
2015-03-04 23:40:55 +03:00
status_t Format(BString& buffer, const int64 arg) const;
BMessageFormat: parse the pattern at construction * Instead of parsing the pattern everytime Format() is called, parse it only once when the object is created. * Adjust all callers to make use of the feature and reuse the instance as much as possible. This also allows calling B_TRANSLATE only once instead of everytime the formatting needs to be done. We use either a static instance (when the message pattern is constant) or a field (when it is not known to be constant). * Since the BMessageFormat instances are now reused, add locking to avoid race conditions (ICU itself is thread safe, but the format pattern is recreated when the locale is changed)
2014-10-08 17:12:48 +04:00
private:
Update icu x86_64 package with namespace renaming enabled. "Renaming" means the icu namespace is suffixed with the version number, atm icu_55. Using "renaming" allows to use two different versions of ICU, thus easing upgrades. For instance haikuwebkit uses a current version of ICU, while the system uses a newer one after an upgrade. * Replace all uses of the icu namespace in our public headers, with a macro defaulting to icu. As the namespace is only used for private fields pointers, there should be no impact. * Locale kit *.cpp have to import the macro from <unicode/uversion.h> *before* including any locale headers. Ditto for a Time preferences cpp file. This way, the correct current icu namespace is referenced. * Fixes bug #12057.
2015-05-10 22:13:59 +03:00
status_t _Initialize(const U_ICU_NAMESPACE::UnicodeString&);
BMessageFormat: parse the pattern at construction * Instead of parsing the pattern everytime Format() is called, parse it only once when the object is created. * Adjust all callers to make use of the feature and reuse the instance as much as possible. This also allows calling B_TRANSLATE only once instead of everytime the formatting needs to be done. We use either a static instance (when the message pattern is constant) or a field (when it is not known to be constant). * Since the BMessageFormat instances are now reused, add locking to avoid race conditions (ICU itself is thread safe, but the format pattern is recreated when the locale is changed)
2014-10-08 17:12:48 +04:00
private:
Update icu x86_64 package with namespace renaming enabled. "Renaming" means the icu namespace is suffixed with the version number, atm icu_55. Using "renaming" allows to use two different versions of ICU, thus easing upgrades. For instance haikuwebkit uses a current version of ICU, while the system uses a newer one after an upgrade. * Replace all uses of the icu namespace in our public headers, with a macro defaulting to icu. As the namespace is only used for private fields pointers, there should be no impact. * Locale kit *.cpp have to import the macro from <unicode/uversion.h> *before* including any locale headers. Ditto for a Time preferences cpp file. This way, the correct current icu namespace is referenced. * Fixes bug #12057.
2015-05-10 22:13:59 +03:00
U_ICU_NAMESPACE::MessageFormat* fFormatter;
Add BMessageFormat class. This can be used to format complex messages properly. It moves the complexity of handling plural forms, gender, and anything else needed into the localizable string, rather than hardcoding it in the code. This moves the difficulty of handling these things properly to people doing translations, rather than relying on developers to do it. Fixes #10755, but our localization must now be updated to make use of the feature.
2014-10-07 10:51:23 +04:00
};
MessageFormat: Add edn header guard comment
2015-03-04 22:22:56 +03:00
#endif // _B_MESSAGE_FORMAT_H_
Reference in New Issue Copy Permalink