Normal   File not found.   File not found.  h1 File not found.  0  h1 BlY> j- @_I|+am_J*j"T;p)F+N// © 2016 and later: Unicode, Inc. and others. // License & terms of use: http://www.unicode.org/copyright.html /* ***************************************************************************************** * Copyright (C) 2015-2016, International Business Machines * Corporation and others. All Rights Reserved. ***************************************************************************************** */ #ifndef ULISTFORMATTER_H #define ULISTFORMATTER_H #include "unicode/utypes.h" #if !UCONFIG_NO_FORMATTING #include "unicode/localpointer.h" #include "unicode/uformattedvalue.h" /** * \file * \brief C API: Format a list in a locale-appropriate way. * * A UListFormatter is used to format a list of items in a locale-appropriate way, * using data from CLDR. * Example: Input data ["Alice", "Bob", "Charlie", "Delta"] will be formatted * as "Alice, Bob, Charlie, and Delta" in English. */ /** * Opaque UListFormatter object for use in C * @stable ICU 55 */ struct UListFormatter; typedef struct UListFormatter UListFormatter; /**< C typedef for struct UListFormatter. @stable ICU 55 */ struct UFormattedList; /** * Opaque struct to contain the results of a UListFormatter operation. * @stable ICU 64 */ typedef struct UFormattedList UFormattedList; /** * FieldPosition and UFieldPosition selectors for format fields * defined by ListFormatter. * @stable ICU 63 */ typedef enum UListFormatterField { /** * The literal text in the result which came from the resources. * @stable ICU 63 */ ULISTFMT_LITERAL_FIELD, /** * The element text in the result which came from the input strings. * @stable ICU 63 */ ULISTFMT_ELEMENT_FIELD } UListFormatterField; #ifndef U_HIDE_DRAFT_API /** * Type of meaning expressed by the list. * * @draft ICU 67 */ typedef enum UListFormatterType { /** * Conjunction formatting, e.g. "Alice, Bob, Charlie, and Delta". * * @draft ICU 67 */ ULISTFMT_TYPE_AND, /** * Disjunction (or alternative, or simply one of) formatting, e.g. * "Alice, Bob, Charlie, or Delta". * * @draft ICU 67 */ ULISTFMT_TYPE_OR, /** * Formatting of a list of values with units, e.g. "5 pounds, 12 ounces". * * @draft ICU 67 */ ULISTFMT_TYPE_UNITS } UListFormatterType; /** * Verbosity level of the list patterns. * * @draft ICU 67 */ typedef enum UListFormatterWidth { /** * Use list formatting with full words (no abbreviations) when possible. * * @draft ICU 67 */ ULISTFMT_WIDTH_WIDE, /** * Use list formatting of typical length. * @draft ICU 67 */ ULISTFMT_WIDTH_SHORT, /** * Use list formatting of the shortest possible length. * @draft ICU 67 */ ULISTFMT_WIDTH_NARROW, } UListFormatterWidth; #endif /* U_HIDE_DRAFT_API */ /** * Open a new UListFormatter object using the rules for a given locale. * The object will be initialized with AND type and WIDE width. * * @param locale * The locale whose rules should be used; may be NULL for * default locale. * @param status * A pointer to a standard ICU UErrorCode (input/output parameter). * Its input value must pass the U_SUCCESS() test, or else the * function returns immediately. The caller should check its output * value with U_FAILURE(), or use with function chaining (see User * Guide for details). * @return * A pointer to a UListFormatter object for the specified locale, * or NULL if an error occurred. * @stable ICU 55 */ U_CAPI UListFormatter* U_EXPORT2 ulistfmt_open(const char* locale, UErrorCode* status); #ifndef U_HIDE_DRAFT_API /** * Open a new UListFormat