diff options
author | mcheshkov <mcheshkov@yandex-team.ru> | 2022-02-10 16:46:15 +0300 |
---|---|---|
committer | Daniil Cherednik <dcherednik@yandex-team.ru> | 2022-02-10 16:46:15 +0300 |
commit | e9d19cec64684c9c1e6b0c98297e5b895cf904fe (patch) | |
tree | 2768b1223e96a8a0610a93d18425d9647c1123c8 /contrib/libs/icu/include/unicode/upluralrules.h | |
parent | 60040c91ffe701a84689b2c6310ff845e65cff42 (diff) | |
download | ydb-e9d19cec64684c9c1e6b0c98297e5b895cf904fe.tar.gz |
Restoring authorship annotation for <mcheshkov@yandex-team.ru>. Commit 1 of 2.
Diffstat (limited to 'contrib/libs/icu/include/unicode/upluralrules.h')
-rw-r--r-- | contrib/libs/icu/include/unicode/upluralrules.h | 168 |
1 files changed, 84 insertions, 84 deletions
diff --git a/contrib/libs/icu/include/unicode/upluralrules.h b/contrib/libs/icu/include/unicode/upluralrules.h index 9c09dfab8b..b5e77d07a5 100644 --- a/contrib/libs/icu/include/unicode/upluralrules.h +++ b/contrib/libs/icu/include/unicode/upluralrules.h @@ -1,4 +1,4 @@ -// © 2016 and later: Unicode, Inc. and others. +// © 2016 and later: Unicode, Inc. and others. // License & terms of use: http://www.unicode.org/copyright.html /* ***************************************************************************************** @@ -15,14 +15,14 @@ #if !UCONFIG_NO_FORMATTING #include "unicode/localpointer.h" -#include "unicode/uenum.h" -#ifndef U_HIDE_INTERNAL_API -#include "unicode/unum.h" -#endif /* U_HIDE_INTERNAL_API */ - -// Forward-declaration -struct UFormattedNumber; - +#include "unicode/uenum.h" +#ifndef U_HIDE_INTERNAL_API +#include "unicode/unum.h" +#endif /* U_HIDE_INTERNAL_API */ + +// Forward-declaration +struct UFormattedNumber; + /** * \file * \brief C API: Plural rules, select plural keywords for numeric values. @@ -67,7 +67,7 @@ enum UPluralType { * @deprecated ICU 58 The numeric value may change over time, see ICU ticket #12420. */ UPLURAL_TYPE_COUNT -#endif /* U_HIDE_DEPRECATED_API */ +#endif /* U_HIDE_DEPRECATED_API */ }; /** * @stable ICU 50 @@ -90,7 +90,7 @@ typedef struct UPluralRules UPluralRules; /**< C typedef for struct UPluralRule * @return A UPluralRules for the specified locale, or NULL if an error occurred. * @stable ICU 4.8 */ -U_CAPI UPluralRules* U_EXPORT2 +U_CAPI UPluralRules* U_EXPORT2 uplrules_open(const char *locale, UErrorCode *status); /** @@ -102,7 +102,7 @@ uplrules_open(const char *locale, UErrorCode *status); * @return A UPluralRules for the specified locale, or NULL if an error occurred. * @stable ICU 50 */ -U_CAPI UPluralRules* U_EXPORT2 +U_CAPI UPluralRules* U_EXPORT2 uplrules_openForType(const char *locale, UPluralType type, UErrorCode *status); /** @@ -110,7 +110,7 @@ uplrules_openForType(const char *locale, UPluralType type, UErrorCode *status); * @param uplrules The UPluralRules object to close. * @stable ICU 4.8 */ -U_CAPI void U_EXPORT2 +U_CAPI void U_EXPORT2 uplrules_close(UPluralRules *uplrules); @@ -135,88 +135,88 @@ U_NAMESPACE_END /** - * Given a floating-point number, returns the keyword of the first rule that + * Given a floating-point number, returns the keyword of the first rule that * applies to the number, according to the supplied UPluralRules object. * @param uplrules The UPluralRules object specifying the rules. * @param number The number for which the rule has to be determined. - * @param keyword An output buffer to write the keyword of the rule that - * applies to number. - * @param capacity The capacity of the keyword buffer. + * @param keyword An output buffer to write the keyword of the rule that + * applies to number. + * @param capacity The capacity of the keyword buffer. * @param status A pointer to a UErrorCode to receive any errors. - * @return The length of the keyword. + * @return The length of the keyword. * @stable ICU 4.8 */ -U_CAPI int32_t U_EXPORT2 +U_CAPI int32_t U_EXPORT2 uplrules_select(const UPluralRules *uplrules, double number, UChar *keyword, int32_t capacity, UErrorCode *status); -/** - * Given a formatted number, returns the keyword of the first rule - * that applies to the number, according to the supplied UPluralRules object. - * - * A UFormattedNumber allows you to specify an exponent or trailing zeros, - * which can affect the plural category. To get a UFormattedNumber, see - * {@link UNumberFormatter}. - * - * @param uplrules The UPluralRules object specifying the rules. - * @param number The formatted number for which the rule has to be determined. - * @param keyword The destination buffer for the keyword of the rule that - * applies to number. - * @param capacity The capacity of the keyword buffer. - * @param status A pointer to a UErrorCode to receive any errors. - * @return The length of the keyword. - * @stable ICU 64 - */ -U_CAPI int32_t U_EXPORT2 -uplrules_selectFormatted(const UPluralRules *uplrules, - const struct UFormattedNumber* number, - UChar *keyword, int32_t capacity, - UErrorCode *status); - -#ifndef U_HIDE_INTERNAL_API -/** - * Given a number, returns the keyword of the first rule that applies to the - * number, according to the UPluralRules object and given the number format - * specified by the UNumberFormat object. - * Note: This internal preview interface may be removed in the future if - * an architecturally cleaner solution reaches stable status. - * @param uplrules The UPluralRules object specifying the rules. - * @param number The number for which the rule has to be determined. - * @param fmt The UNumberFormat specifying how the number will be formatted - * (this can affect the plural form, e.g. "1 dollar" vs "1.0 dollars"). - * If this is NULL, the function behaves like uplrules_select. - * @param keyword An output buffer to write the keyword of the rule that - * applies to number. - * @param capacity The capacity of the keyword buffer. - * @param status A pointer to a UErrorCode to receive any errors. - * @return The length of keyword. - * @internal ICU 59 technology preview, may be removed in the future - */ -U_INTERNAL int32_t U_EXPORT2 -uplrules_selectWithFormat(const UPluralRules *uplrules, - double number, - const UNumberFormat *fmt, - UChar *keyword, int32_t capacity, - UErrorCode *status); - -#endif /* U_HIDE_INTERNAL_API */ - -/** - * Creates a string enumeration of all plural rule keywords used in this - * UPluralRules object. The rule "other" is always present by default. - * @param uplrules The UPluralRules object specifying the rules for - * a given locale. - * @param status A pointer to a UErrorCode to receive any errors. - * @return a string enumeration over plural rule keywords, or NULL - * upon error. The caller is responsible for closing the result. - * @stable ICU 59 - */ -U_STABLE UEnumeration* U_EXPORT2 -uplrules_getKeywords(const UPluralRules *uplrules, - UErrorCode *status); - +/** + * Given a formatted number, returns the keyword of the first rule + * that applies to the number, according to the supplied UPluralRules object. + * + * A UFormattedNumber allows you to specify an exponent or trailing zeros, + * which can affect the plural category. To get a UFormattedNumber, see + * {@link UNumberFormatter}. + * + * @param uplrules The UPluralRules object specifying the rules. + * @param number The formatted number for which the rule has to be determined. + * @param keyword The destination buffer for the keyword of the rule that + * applies to number. + * @param capacity The capacity of the keyword buffer. + * @param status A pointer to a UErrorCode to receive any errors. + * @return The length of the keyword. + * @stable ICU 64 + */ +U_CAPI int32_t U_EXPORT2 +uplrules_selectFormatted(const UPluralRules *uplrules, + const struct UFormattedNumber* number, + UChar *keyword, int32_t capacity, + UErrorCode *status); + +#ifndef U_HIDE_INTERNAL_API +/** + * Given a number, returns the keyword of the first rule that applies to the + * number, according to the UPluralRules object and given the number format + * specified by the UNumberFormat object. + * Note: This internal preview interface may be removed in the future if + * an architecturally cleaner solution reaches stable status. + * @param uplrules The UPluralRules object specifying the rules. + * @param number The number for which the rule has to be determined. + * @param fmt The UNumberFormat specifying how the number will be formatted + * (this can affect the plural form, e.g. "1 dollar" vs "1.0 dollars"). + * If this is NULL, the function behaves like uplrules_select. + * @param keyword An output buffer to write the keyword of the rule that + * applies to number. + * @param capacity The capacity of the keyword buffer. + * @param status A pointer to a UErrorCode to receive any errors. + * @return The length of keyword. + * @internal ICU 59 technology preview, may be removed in the future + */ +U_INTERNAL int32_t U_EXPORT2 +uplrules_selectWithFormat(const UPluralRules *uplrules, + double number, + const UNumberFormat *fmt, + UChar *keyword, int32_t capacity, + UErrorCode *status); + +#endif /* U_HIDE_INTERNAL_API */ + +/** + * Creates a string enumeration of all plural rule keywords used in this + * UPluralRules object. The rule "other" is always present by default. + * @param uplrules The UPluralRules object specifying the rules for + * a given locale. + * @param status A pointer to a UErrorCode to receive any errors. + * @return a string enumeration over plural rule keywords, or NULL + * upon error. The caller is responsible for closing the result. + * @stable ICU 59 + */ +U_STABLE UEnumeration* U_EXPORT2 +uplrules_getKeywords(const UPluralRules *uplrules, + UErrorCode *status); + #endif /* #if !UCONFIG_NO_FORMATTING */ #endif |