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

42 lines
801 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>
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
namespace icu {
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 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
status_t Format(BString& buffer, const off_t 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:
status_t _Initialize(const icu::UnicodeString&);
private:
icu::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_