|
ICU 60.2
60.2
|
C API: Format a list in a locale-appropriate way. More...
Go to the source code of this file.
Namespaces | |
| icu | |
| File coll.h. | |
Typedefs | |
| typedef struct UListFormatter | UListFormatter |
| C typedef for struct UListFormatter. More... | |
Functions | |
| U_CAPI UListFormatter * | ulistfmt_open (const char *locale, UErrorCode *status) |
| Open a new UListFormatter object using the rules for a given locale. More... | |
| U_CAPI void | ulistfmt_close (UListFormatter *listfmt) |
| Close a UListFormatter object. More... | |
| U_CAPI int32_t | ulistfmt_format (const UListFormatter *listfmt, const UChar *const strings[], const int32_t *stringLengths, int32_t stringCount, UChar *result, int32_t resultCapacity, UErrorCode *status) |
| Formats a list of strings using the conventions established for the UListFormatter object. More... | |
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.
Definition in file ulistformatter.h.
| typedef struct UListFormatter UListFormatter |
| U_CAPI void ulistfmt_close | ( | UListFormatter * | listfmt | ) |
Close a UListFormatter object.
Once closed it may no longer be used.
| listfmt | The UListFormatter object to close. |
| U_CAPI int32_t ulistfmt_format | ( | const UListFormatter * | listfmt, |
| const UChar *const | strings[], | ||
| const int32_t * | stringLengths, | ||
| int32_t | stringCount, | ||
| UChar * | result, | ||
| int32_t | resultCapacity, | ||
| UErrorCode * | status | ||
| ) |
Formats a list of strings using the conventions established for the UListFormatter object.
| listfmt | The UListFormatter object specifying the list conventions. |
| strings | An array of pointers to UChar strings; the array length is specified by stringCount. Must be non-NULL if stringCount > 0. |
| stringLengths | An array of string lengths corresponding to the strings[] parameter; any individual length value may be negative to indicate that the corresponding strings[] entry is 0-terminated, or stringLengths itself may be NULL if all of the strings are 0-terminated. If non-NULL, the stringLengths array must have stringCount entries. |
| stringCount | the number of entries in strings[], and the number of entries in the stringLengths array if it is not NULL. Must be >= 0. |
| result | A pointer to a buffer to receive the formatted list. |
| resultCapacity | The maximum size of result. |
| 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). |
| U_CAPI UListFormatter* ulistfmt_open | ( | const char * | locale, |
| UErrorCode * | status | ||
| ) |
Open a new UListFormatter object using the rules for a given locale.
| locale | The locale whose rules should be used; may be NULL for default locale. |
| 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). |
1.8.11