ICU 57.1  57.1
plurrule.h
Go to the documentation of this file.
1 /*
2 *******************************************************************************
3 * Copyright (C) 2008-2015, International Business Machines Corporation and
4 * others. All Rights Reserved.
5 *******************************************************************************
6 *
7 *
8 * File PLURRULE.H
9 *
10 * Modification History:*
11 * Date Name Description
12 *
13 ********************************************************************************
14 */
15 
16 #ifndef PLURRULE
17 #define PLURRULE
18 
19 #include "unicode/utypes.h"
20 
26 #if !UCONFIG_NO_FORMATTING
27 
28 #include "unicode/format.h"
29 #include "unicode/upluralrules.h"
30 
36 #define UPLRULES_NO_UNIQUE_VALUE ((double)-0.00123456777)
37 
39 
40 class Hashtable;
41 class FixedDecimal;
42 class VisibleDigitsWithExponent;
43 class RuleChain;
44 class PluralRuleParser;
45 class PluralKeywordEnumeration;
46 class AndConstraint;
47 class SharedPluralRules;
48 
193 public:
194 
203 
208  PluralRules(const PluralRules& other);
209 
214  virtual ~PluralRules();
215 
220  PluralRules* clone() const;
221 
227 
238  static PluralRules* U_EXPORT2 createRules(const UnicodeString& description,
239  UErrorCode& status);
240 
249  static PluralRules* U_EXPORT2 createDefaultRules(UErrorCode& status);
250 
267  static PluralRules* U_EXPORT2 forLocale(const Locale& locale, UErrorCode& status);
268 
285  static PluralRules* U_EXPORT2 forLocale(const Locale& locale, UPluralType type, UErrorCode& status);
286 
287 #ifndef U_HIDE_INTERNAL_API
294 
301  static UBool hasOverride(const Locale &locale);
302 
308  static PluralRules* U_EXPORT2 internalForLocale(const Locale& locale, UPluralType type, UErrorCode& status);
309 
317  static const SharedPluralRules* U_EXPORT2 createSharedInstance(
318  const Locale& locale, UPluralType type, UErrorCode& status);
319 
320 
321 #endif /* U_HIDE_INTERNAL_API */
322 
332  UnicodeString select(int32_t number) const;
333 
343  UnicodeString select(double number) const;
344 
345 #ifndef U_HIDE_INTERNAL_API
349  UnicodeString select(const FixedDecimal &number) const;
353  UnicodeString select(const VisibleDigitsWithExponent &number) const;
354 #endif /* U_HIDE_INTERNAL_API */
355 
367 
368 #ifndef U_HIDE_DEPRECATED_API
379  double getUniqueKeywordValue(const UnicodeString& keyword);
380 
401  int32_t getAllKeywordValues(const UnicodeString &keyword,
402  double *dest, int32_t destCapacity,
403  UErrorCode& status);
404 #endif /* U_HIDE_DEPRECATED_API */
405 
424  int32_t getSamples(const UnicodeString &keyword,
425  double *dest, int32_t destCapacity,
426  UErrorCode& status);
427 
437  UBool isKeyword(const UnicodeString& keyword) const;
438 
439 
447 
448 #ifndef U_HIDE_INTERNAL_API
454 #endif /* U_HIDE_INTERNAL_API */
455 
464  virtual UBool operator==(const PluralRules& other) const;
465 
474  UBool operator!=(const PluralRules& other) const {return !operator==(other);}
475 
476 
483  static UClassID U_EXPORT2 getStaticClassID(void);
484 
490  virtual UClassID getDynamicClassID() const;
491 
492 
493 private:
494  RuleChain *mRules;
495 
496  PluralRules(); // default constructor not implemented
497  void parseDescription(const UnicodeString& ruleData, UErrorCode &status);
498  int32_t getNumberValue(const UnicodeString& token) const;
499  UnicodeString getRuleFromResource(const Locale& locale, UPluralType type, UErrorCode& status);
500  RuleChain *rulesForKeyword(const UnicodeString &keyword) const;
501 
502  friend class PluralRuleParser;
503 };
504 
506 
507 #endif /* #if !UCONFIG_NO_FORMATTING */
508 
509 #endif // _PLURRULE
510 //eof
A Locale object represents a specific geographical, political, or cultural region.
Definition: locid.h:185
Defines rules for mapping non-negative numeric values onto a small set of keywords.
Definition: plurrule.h:192
static const SharedPluralRules * createSharedInstance(const Locale &locale, UPluralType type, UErrorCode &status)
For ICU use only.
UnicodeString select(const FixedDecimal &number) const
UBool operator!=(const PluralRules &other) const
Compares the inequality of two PluralRules objects.
Definition: plurrule.h:474
virtual UBool operator==(const PluralRules &other) const
Compares the equality of two PluralRules objects.
UnicodeString getKeywordOther() const
Returns keyword for default plural form.
double getUniqueKeywordValue(const UnicodeString &keyword)
Deprecated Function, does not return useful results.
StringEnumeration * getKeywords(UErrorCode &status) const
Returns a list of all rule keywords used in this PluralRules object.
static PluralRules * forLocale(const Locale &locale, UPluralType type, UErrorCode &status)
Provides access to the predefined PluralRules for a given locale and the plural type.
UnicodeString select(const VisibleDigitsWithExponent &number) const
virtual UClassID getDynamicClassID() const
ICU "poor man's RTTI", returns a UClassID for the actual class.
int32_t getAllKeywordValues(const UnicodeString &keyword, double *dest, int32_t destCapacity, UErrorCode &status)
Deprecated Function, does not produce useful results.
static UBool hasOverride(const Locale &locale)
Returns whether or not there are overrides.
PluralRules(UErrorCode &status)
Constructor.
UnicodeString select(int32_t number) const
Given a number, returns the keyword of the first rule that applies to the number.
virtual ~PluralRules()
Destructor.
UnicodeString select(double number) const
Given a number, returns the keyword of the first rule that applies to the number.
static StringEnumeration * getAvailableLocales(UErrorCode &status)
Return a StringEnumeration over the locales for which there is plurals data.
static UClassID getStaticClassID(void)
ICU "poor man's RTTI", returns a UClassID for this class.
PluralRules & operator=(const PluralRules &)
Assignment operator.
UBool isKeyword(const UnicodeString &keyword) const
Returns TRUE if the given keyword is defined in this PluralRules object.
UnicodeString getRules() const
static PluralRules * forLocale(const Locale &locale, UErrorCode &status)
Provides access to the predefined cardinal-number PluralRules for a given locale.
static PluralRules * createDefaultRules(UErrorCode &status)
The default rules that accept any number.
PluralRules(const PluralRules &other)
Copy constructor.
int32_t getSamples(const UnicodeString &keyword, double *dest, int32_t destCapacity, UErrorCode &status)
Returns sample values for which select() would return the keyword.
static PluralRules * internalForLocale(const Locale &locale, UPluralType type, UErrorCode &status)
For ICU use only.
static PluralRules * createRules(const UnicodeString &description, UErrorCode &status)
Creates a PluralRules from a description if it is parsable, otherwise returns NULL.
PluralRules * clone() const
Clone.
Base class for 'pure' C++ implementations of uenum api.
Definition: strenum.h:55
UObject is the common ICU "boilerplate" class.
Definition: uobject.h:221
UnicodeString is a string class that stores Unicode characters directly and provides similar function...
Definition: unistr.h:294
C++ API: Base class for all formats.
U_EXPORT UBool operator==(const StringPiece &x, const StringPiece &y)
Global operator == for StringPiece.
int8_t UBool
The ICU boolean type.
Definition: umachine.h:234
void * UClassID
UClassID is used to identify classes without using the compiler's RTTI.
Definition: uobject.h:91
C API: Plural rules, select plural keywords for numeric values.
UPluralType
Type of plurals and PluralRules.
Definition: upluralrules.h:44
Basic definitions for ICU, for both C and C++ APIs.
UErrorCode
Error code to replace exception handling, so that the code is compatible with all C++ compilers,...
Definition: utypes.h:476
#define U_I18N_API
Set to export library symbols from inside the i18n library, and to import them from outside.
Definition: utypes.h:358
#define U_NAMESPACE_END
This is used to end a declaration of a public ICU C++ API.
Definition: uversion.h:130
#define U_NAMESPACE_BEGIN
This is used to begin a declaration of a public ICU C++ API.
Definition: uversion.h:129