From 753e866c7fd9cb56dfc2b78e93e1527d21cc59e5 Mon Sep 17 00:00:00 2001 From: Damian Pietruchowski Date: Wed, 20 Jul 2016 10:07:07 +0200 Subject: [PATCH] [Base-utils] Comments improvement and fixes Change-Id: I09fe84ff3f0fb8cb545fb5b20a6be02d509c6f96 Signed-off-by: Damian Pietruchowski --- .../mobile/utils_i18n_field_position.h | 22 +- src/include/mobile/utils_i18n_format.h | 18 +- src/include/mobile/utils_i18n_formattable.h | 65 +++-- src/include/mobile/utils_i18n_measure.h | 12 +- .../mobile/utils_i18n_measure_format.h | 14 +- src/include/mobile/utils_i18n_measure_unit.h | 260 +++++++++-------- .../mobile/utils_i18n_parse_position.h | 17 +- src/include/mobile/utils_i18n_types.h | 28 +- .../wearable/utils_i18n_field_position.h | 36 ++- src/include/wearable/utils_i18n_format.h | 22 +- src/include/wearable/utils_i18n_formattable.h | 65 +++-- src/include/wearable/utils_i18n_measure.h | 14 +- .../wearable/utils_i18n_measure_format.h | 16 +- .../wearable/utils_i18n_measure_unit.h | 270 +++++++++--------- .../wearable/utils_i18n_parse_position.h | 27 +- src/include/wearable/utils_i18n_types.h | 55 ++-- src/utils_i18n_format.cpp | 2 +- src/utils_i18n_formattable.cpp | 8 +- src/utils_i18n_measure_format.cpp | 2 + src/utils_i18n_measure_unit.cpp | 19 +- 20 files changed, 513 insertions(+), 459 deletions(-) diff --git a/src/include/mobile/utils_i18n_field_position.h b/src/include/mobile/utils_i18n_field_position.h index a80ae77..e349420 100644 --- a/src/include/mobile/utils_i18n_field_position.h +++ b/src/include/mobile/utils_i18n_field_position.h @@ -38,14 +38,12 @@ extern "C" { * \#include * * @section CAPI_BASE_UTILS_I18N_FIELD_POSITION_MODULE_OVERVIEW Overview - * @details Fields are identified by constants, whose names typically end with _FIELD, - * defined in the various subclasses of Format. Field position keeps track of the position - * of the field within the formatted output with two indices: the index of the first - * character of the field and the index of the last character of the field. One version - * of the format method in the various Format classes requires a Field Position object - * as an argument. You use this format method to perform partial formatting or to get - * information about the formatted output (such as the position of a field). - * The FieldPosition class is not suitable for subclassing. + * @details Field position keeps track of the position of the field within the formatted + * output with two indices: the index of the first character of the field and the index + * of the last character of the field. One version of the format function in the various + * Format modules requires a Field Position object as an argument. You use this format + * function to perform partial formatting or to get information about the formatted output + * (such as the position of a field). */ /** @@ -55,9 +53,9 @@ extern "C" { /** * @brief Creates a field position object with a non-specified field. + * @since_tizen 3.0 * @remarks The created object should be released by the caller with the * i18n_field_position_destroy() function. - * @since_tizen 3.0 * * @param[out] field_position The created field position object * @@ -72,9 +70,9 @@ int i18n_field_position_create(i18n_field_position_h *field_position); * @brief Creates a field position object for the given field. * @details Fields are identified by constants, whose names typically end with _FIELD, * in the various subtypes of Format. + * @since_tizen 3.0 * @remarks The created object should be released by the caller with the * i18n_field_position_destroy() function. - * @since_tizen 3.0 * * @param[in] field The field value * @param[out] field_position The created field position object @@ -99,10 +97,10 @@ int i18n_field_position_create_for_field(int32_t field, i18n_field_position_h *f int i18n_field_position_destroy(i18n_field_position_h field_position); /** - * @brief Creates a polymorphic clone of the given @a field_position object. + * @brief Creates a clone of the given @a field_position object. + * @since_tizen 3.0 * @remarks The @a clone object should be released by the caller with the * i18n_field_position_destroy() function. - * @since_tizen 3.0 * * @param[in] field_position The field position object to be cloned * @param[out] clone The created field position object diff --git a/src/include/mobile/utils_i18n_format.h b/src/include/mobile/utils_i18n_format.h index 27c5666..87c3da0 100644 --- a/src/include/mobile/utils_i18n_format.h +++ b/src/include/mobile/utils_i18n_format.h @@ -32,7 +32,7 @@ extern "C" { /** * @ingroup CAPI_BASE_UTILS_I18N_MODULE * @defgroup CAPI_BASE_UTILS_I18N_FORMAT_MODULE Format - * @brief The Format module represents the base class for all formats. + * @brief The Format module represents the base module for all formats. * @section CAPI_BASE_UTILS_I18N_FORMAT_MODULE_HEADER Required Header * \#include * @@ -68,9 +68,9 @@ int i18n_format_destroy(i18n_format_h format); /** * @brief Creates a polymorphic clone of the given @a format object. + * @since_tizen 3.0 * @remarks The cloned object should be released by the caller with the * i18n_format_destroy() function. - * @since_tizen 3.0 * * @param[in] format The format object to be cloned * @param[out] clone The clone of the given @a format object @@ -84,9 +84,9 @@ int i18n_format_clone(i18n_format_h format, i18n_format_h *clone); /** * @brief Formats an object to produce a string. + * @since_tizen 3.0 * @remarks The @a append_to parameter should be released by the caller with the * free() function. - * @since_tizen 3.0 * * @param[in] format The format object * @param[in] formattable The object to format @@ -102,9 +102,9 @@ int i18n_format_format(i18n_format_h format, i18n_formattable_h formattable, cha /** * @brief Formats an object to produce a string. + * @since_tizen 3.0 * @remarks The @a append_to parameter should be released by the caller with the * free() function. - * @since_tizen 3.0 * * @param[in] format The format object * @param[in] formattable The object to format @@ -122,9 +122,9 @@ int i18n_format_format_with_field_position(i18n_format_h format, i18n_formattabl /** * @brief Parses a string to produce an object. + * @since_tizen 3.0 * @remarks The obtained @a result formattable object should be released by the caller with the * i18n_formattable_destroy() function. - * @since_tizen 3.0 * * @param[in] format The format object * @param[in] source The string to be parsed into an object @@ -139,9 +139,9 @@ int i18n_format_parse_object(i18n_format_h format, const char *source, i18n_form /** * @brief Parses a string to produce an object. + * @since_tizen 3.0 * @remarks The obtained @a result formattable object should be released by the caller with the * i18n_formattable_destroy() function. - * @since_tizen 3.0 * * @param[in] format The format object * @param[in] source The string to be parsed into an object @@ -151,7 +151,7 @@ int i18n_format_parse_object(i18n_format_h format, const char *source, i18n_form * @param[out] result The formattable object to be set to the parse result. * If parse fails, return contents are undefined. * - * @return Error code. Error codes not listed below are described in the #i18n_error_code_e + * @return @c 0 on success, otherwise a negative error value * @retval #I18N_ERROR_NONE Successful * @retval #I18N_ERROR_INVALID_PARAMETER Invalid function parameter */ @@ -160,8 +160,8 @@ int i18n_format_parse_object_with_parse_position(i18n_format_h format, const cha /** * @brief Gets the locale for the given format object. * @details You can choose between valid and actual locale. - * @remarks Both @a language and @a country should be released by the caller with the free() function. * @since_tizen 3.0 + * @remarks Both @a language and @a country should be released by the caller with the free() function. * * @param[in] format The format object * @param[in] type The type of the locale we're looking for (valid or actual) @@ -174,7 +174,7 @@ int i18n_format_parse_object_with_parse_position(i18n_format_h format, const cha * @retval #I18N_ERROR_OUT_OF_MEMORY Out of memory */ int i18n_format_get_locale(i18n_format_h format, - i18n_uloc_data_locale_type_e type, const char **language, const char **country); + i18n_uloc_data_locale_type_e type, char **language, char **country); /** * @} diff --git a/src/include/mobile/utils_i18n_formattable.h b/src/include/mobile/utils_i18n_formattable.h index c7abfab..fa371ee 100644 --- a/src/include/mobile/utils_i18n_formattable.h +++ b/src/include/mobile/utils_i18n_formattable.h @@ -53,6 +53,7 @@ extern "C" { /** * @brief Creates a new default #i18n_formattable_h. + * @since_tizen 3.0 * @remarks The created object should be released by the caller with the * #i18n_formattable_destroy() function. * @@ -68,6 +69,7 @@ int i18n_formattable_create_default(i18n_formattable_h *formattable); /** * @brief Creates a new #i18n_formattable_h handle with an #i18n_udate instance. + * @since_tizen 3.0 * @remarks The created object should be released by the caller with the * #i18n_formattable_destroy() function. * @@ -83,11 +85,12 @@ int i18n_formattable_create_default(i18n_formattable_h *formattable); int i18n_formattable_create_with_udate(i18n_udate date, i18n_formattable_h *formattable); /** - * @brief Creates a new #i18n_formattable_h handle with a double number. + * @brief Creates a new #i18n_formattable_h handle with a double value. + * @since_tizen 3.0 * @remarks The created object should be released by the caller with the * #i18n_formattable_destroy() function. * - * @param[in] d The double number + * @param[in] value The double value to be used * @param[out] formattable A pointer to a handle to the newly created formattable * object * @@ -96,14 +99,15 @@ int i18n_formattable_create_with_udate(i18n_udate date, i18n_formattable_h *form * @retval #I18N_ERROR_INVALID_PARAMETER Invalid function parameter * @retval #I18N_ERROR_UNKNOWN Unknown error */ -int i18n_formattable_create_with_double(double d, i18n_formattable_h *formattable); +int i18n_formattable_create_with_double(double value, i18n_formattable_h *formattable); /** - * @brief Creates a new #i18n_formattable_h handle with a long number. + * @brief Creates a new #i18n_formattable_h handle with a long value. + * @since_tizen 3.0 * @remarks The created object should be released by the caller with the * #i18n_formattable_destroy() function. * - * @param[in] l The long number + * @param[in] value The long value to be used * @param[out] formattable A pointer to a handle to the newly created formattable * object * @@ -112,14 +116,15 @@ int i18n_formattable_create_with_double(double d, i18n_formattable_h *formattabl * @retval #I18N_ERROR_INVALID_PARAMETER Invalid function parameter * @retval #I18N_ERROR_UNKNOWN Unknown error */ -int i18n_formattable_create_with_long(int32_t l, i18n_formattable_h *formattable); +int i18n_formattable_create_with_long(int32_t value, i18n_formattable_h *formattable); /** - * @brief Creates a new #i18n_formattable_h handle with an int64_t number. + * @brief Creates a new #i18n_formattable_h handle with an int64_t value. + * @since_tizen 3.0 * @remarks The created object should be released by the caller with the * #i18n_formattable_destroy() function. * - * @param[in] ll The int64_t number + * @param[in] value The int64_t value to be used * @param[out] formattable A pointer to a handle to the newly created formattable * object * @@ -128,11 +133,12 @@ int i18n_formattable_create_with_long(int32_t l, i18n_formattable_h *formattable * @retval #I18N_ERROR_INVALID_PARAMETER Invalid function parameter * @retval #I18N_ERROR_UNKNOWN Unknown error */ -int i18n_formattable_create_with_int64(int64_t ll, i18n_formattable_h *formattable); +int i18n_formattable_create_with_int64(int64_t value, i18n_formattable_h *formattable); /** * @brief Creates a new #i18n_formattable_h handle with a char string pointer. * @details Assumes that the char string is null terminated. + * @since_tizen 3.0 * @remarks The created object should be released by the caller with the * #i18n_formattable_destroy() function. * @@ -150,6 +156,7 @@ int i18n_formattable_create_with_char_string(const char *str_to_copy, i18n_forma /** * @brief Creates a new #i18n_formattable_h handle with an array of * #i18n_formattable_h handles. + * @since_tizen 3.0 * @remarks The created object should be released by the caller with the * #i18n_formattable_destroy() function. * @@ -167,6 +174,7 @@ int i18n_formattable_create_with_formattable_array(const i18n_formattable_h *arr /** * @brief Releases the given #i18n_formattable_h handle. + * @since_tizen 3.0 * * @param[in] formattable A handle to the formattable object to be released * @@ -179,6 +187,7 @@ int i18n_formattable_destroy(i18n_formattable_h formattable); /** * @brief Clones the given formattable handle with the related object to the * @a clone handle. + * @since_tizen 3.0 * @details Clones can be used concurrently in multiple threads. * @remarks The cloned object should be released by the caller with the * #i18n_formattable_destroy() function. @@ -196,9 +205,9 @@ int i18n_formattable_clone(i18n_formattable_h formattable, i18n_formattable_h *c /** * @brief Gets the array value and count of the given formattable object. + * @since_tizen 3.0 * @remarks If this object is not of type #I18N_FORMATTABLE_K_ARRAY then the - * result is undefined. The obtained array should be released by the - * caller with the free() function. + * result is undefined. * * @param[in] formattable A handle to the formattable object * @param[out] array A pointer to an array of #i18n_formattable_h handles @@ -213,6 +222,7 @@ int i18n_formattable_get_array(i18n_formattable_h formattable, i18n_formattable_ /** * @brief Gets the date value of the given formattable object. + * @since_tizen 3.0 * @remarks If this object is not of type #I18N_FORMATTABLE_K_DATE then the * result is undefined. * @@ -228,6 +238,7 @@ int i18n_formattable_get_date(i18n_formattable_h formattable, i18n_udate *date); /** * @brief Gets the double value of the given formattable object. + * @since_tizen 3.0 * @remarks If this object is not of type #I18N_FORMATTABLE_K_DOUBLE then the * result is undefined. * @@ -243,6 +254,7 @@ int i18n_formattable_get_double(i18n_formattable_h formattable, double *value); /** * @brief Gets the int64 value of the given formattable object. + * @since_tizen 3.0 * @remarks If this object is not of type #I18N_FORMATTABLE_K_INT64 then the * result is undefined. * @@ -262,6 +274,7 @@ int i18n_formattable_get_int64(i18n_formattable_h formattable, int64_t *value); * minimum long value, as appropriate, is set to @value variable and * the #I18N_ERROR_INVALID_FORMAT error code is returned by the * function. + * @since_tizen 3.0 * * @param[in] formattable A handle to the formattable object * @param[out] value A pointer to a int32_t variable which will be filled @@ -275,9 +288,10 @@ int i18n_formattable_get_long(i18n_formattable_h formattable, int32_t *value); /** * @brief Gets the string value of the given formattable object. + * @since_tizen 3.0 * @remarks If the type is not a string, the function returns the * #I18N_ERROR_INVALID_FORMAT error code and the value is set to @c - * NULL. + * NULL. The @a value should be released by the caller with the free() function. * * @param[in] formattable A handle to the formattable object * @param[out] value A pointer to a char string variable which will be @@ -293,6 +307,7 @@ int i18n_formattable_get_string(i18n_formattable_h formattable, char **value); /** * @brief Gets the data type of the given formattable object. + * @since_tizen 3.0 * * @param[in] formattable A handle to the formattable object * @param[out] type A pointer to an #i18n_formattable_type_e variable which @@ -309,6 +324,7 @@ int i18n_formattable_get_type(i18n_formattable_h formattable, i18n_formattable_t * @brief Sets the variable pointed by the @a is_numeric pointer to @c true if * the data type of the given formattable object is #I18N_FORMATTABLE_K_DOUBLE, * #I18N_FORMATTABLE_K_LONG or #I18N_FORMATTABLE_K_INT64. + * @since_tizen 3.0 * * @param[in] formattable A handle to the formattable object * @param[out] is_numeric A pointer to a boolean variable which will be filled by @@ -324,6 +340,7 @@ int i18n_formattable_is_numeric(i18n_formattable_h formattable, bool *is_numeric * @brief Sets the variable pointed by the @a not_equal pointer to @c true if * the given @a formattable object is not equal to the given @a other * formattable object. + * @since_tizen 3.0 * * @param[in] formattable A handle to the formattable object * @param[in] other A handle to the other formattable object @@ -340,6 +357,7 @@ int i18n_formattable_not_equal(i18n_formattable_h formattable, i18n_formattable_ * @brief Sets the variable pointed by the @a equal pointer to @c true if the * given @a formattable object is equal to the given @a other * formattable object. + * @since_tizen 3.0 * * @param[in] formattable A handle to the formattable object * @param[in] other A handle to the other formattable object @@ -356,6 +374,7 @@ int i18n_formattable_equal(i18n_formattable_h formattable, i18n_formattable_h ot * @brief Sets the object pointed by the @a element pointer to the element at * the @a index position in the array stored by the given formattable * object (if its type is #I18N_FORMATTABLE_K_ARRAY). + * @since_tizen 3.0 * @remarks If this object is not of type #I18N_FORMATTABLE_K_ARRAY then the * result is undefined. * @@ -379,6 +398,7 @@ int i18n_formattable_element_at(i18n_formattable_h formattable, int32_t index, i /** * @brief Sets the array value and count of the given formattable object and * changes the type to #I18N_FORMATTABLE_K_ARRAY. + * @since_tizen 3.0 * * @param[in] formattable A handle to the formattable object * @param[in] array An array of handles to the formattable objects @@ -393,58 +413,63 @@ int i18n_formattable_set_array(i18n_formattable_h formattable, const i18n_format /** * @brief Sets the date value of the given formattable object and changes the * type to the #I18N_FORMATTABLE_K_DATE. + * @since_tizen 3.0 * * @param[in] formattable A handle to the formattable object - * @param[in] d The new i18n_udate value to be set + * @param[in] date The new i18n_udate value to be set * * @return @c 0 on success, otherwise a negative error value * @retval #I18N_ERROR_NONE Successful * @retval #I18N_ERROR_INVALID_PARAMETER Invalid function parameter */ -int i18n_formattable_set_date(i18n_formattable_h formattable, i18n_udate d); +int i18n_formattable_set_date(i18n_formattable_h formattable, i18n_udate date); /** * @brief Sets the double value of the given formattable object and changes * the type to the #I18N_FORMATTABLE_K_DOUBLE. + * @since_tizen 3.0 * * @param[in] formattable A handle to the formattable object - * @param[in] d The new double value to be set + * @param[in] value The new double value to be set * * @return @c 0 on success, otherwise a negative error value * @retval #I18N_ERROR_NONE Successful * @retval #I18N_ERROR_INVALID_PARAMETER Invalid function parameter */ -int i18n_formattable_set_double(i18n_formattable_h formattable, double d); +int i18n_formattable_set_double(i18n_formattable_h formattable, double value); /** * @brief Sets the int64 value of the given formattable object and changes the * type to the #I18N_FORMATTABLE_K_INT64. + * @since_tizen 3.0 * * @param[in] formattable A handle to the formattable object - * @param[in] ll The new int64_t value to be set + * @param[in] value The new int64_t value to be set * * @return @c 0 on success, otherwise a negative error value * @retval #I18N_ERROR_NONE Successful * @retval #I18N_ERROR_INVALID_PARAMETER Invalid function parameter */ -int i18n_formattable_set_int64(i18n_formattable_h formattable, int64_t ll); +int i18n_formattable_set_int64(i18n_formattable_h formattable, int64_t value); /** * @brief Sets the long value of the given formattable object and changes the * type to the #I18N_FORMATTABLE_K_LONG. + * @since_tizen 3.0 * * @param[in] formattable A handle to the formattable object - * @param[in] l The new int32_t value to be set + * @param[in] value The new int32_t value to be set * * @return @c 0 on success, otherwise a negative error value * @retval #I18N_ERROR_NONE Successful * @retval #I18N_ERROR_INVALID_PARAMETER Invalid function parameter */ -int i18n_formattable_set_long(i18n_formattable_h formattable, int32_t l); +int i18n_formattable_set_long(i18n_formattable_h formattable, int32_t value); /** * @brief Sets the string value of the given formattable object and changes * the type to the #I18N_FORMATTABLE_K_STRING. + * @since_tizen 3.0 * * @param[in] formattable A handle to the formattable object * @param[in] string_to_copy The new string value to be set diff --git a/src/include/mobile/utils_i18n_measure.h b/src/include/mobile/utils_i18n_measure.h index 6e2c276..76b6f8c 100644 --- a/src/include/mobile/utils_i18n_measure.h +++ b/src/include/mobile/utils_i18n_measure.h @@ -34,7 +34,7 @@ extern "C" { * @defgroup CAPI_BASE_UTILS_I18N_MEASURE_MODULE MeasureUnit * @brief Measure object contains an amount of a specified unit, consisting of a number and an unit. * @section CAPI_BASE_UTILS_I18N_MEASURE_MODULE_HEADER Required Header - *» \#include + * \#include * * @section CAPI_BASE_UTILS_I18N_MEASURE_MODULE_OVERVIEW Overview * @details @@ -48,9 +48,9 @@ extern "C" { /** * @brief Creates an object with the given numeric amount and the given unit. * @details After this call, the caller must not delete the given measure unit object. + * @since_tizen 3.0 * @remarks The created object should be released by the caller with the * #i18n_measure_destroy() function. - * @since_tizen 3.0 * * @param[in] formattable A numeric object; The #i18n_formattable_is_numeric() * function must return @c true for this object. @@ -66,9 +66,9 @@ int i18n_measure_create(const i18n_formattable_h formattable, i18n_measure_unit_ /** * @brief Creates a polymorphic clone of the given @a clone object. + * @since_tizen 3.0 * @remarks The @c clone object should be released by the caller with the * #i18n_measure_destroy() function. - * @since_tizen 3.0 * * @param[in] measure The measure object to be cloned * @param[out] clone The created measure object @@ -81,7 +81,7 @@ int i18n_measure_create(const i18n_formattable_h formattable, i18n_measure_unit_ int i18n_measure_clone(i18n_measure_h measure, i18n_measure_h *clone); /** - * @brief Destroys the measure object + * @brief Destroys the measure object. * @since_tizen 3.0 * * @param[in] measure The measure object to destroy @@ -94,9 +94,9 @@ int i18n_measure_destroy(i18n_measure_h measure); /** * @brief Gets a reference to the numeric value of the measure object. + * @since_tizen 3.0 * @remarks The obtained formattable object should be released by the caller * with the #i18n_formattable_destroy() function. - * @since_tizen 3.0 * * @param[in] measure The measure object * @param[out] formattable The numeric value of the measure object @@ -110,9 +110,9 @@ int i18n_measure_get_number(i18n_measure_h measure, i18n_formattable_h *formatta /** * @brief Gets a reference to the unit of the measure object. + * @since_tizen 3.0 * @remarks The obtained measure unit object should be released by the caller * with the #i18n_measure_unit_destroy() function. - * @since_tizen 3.0 * * @param[in] measure The measure object * @param[out] measure_unit The unit of the measure object diff --git a/src/include/mobile/utils_i18n_measure_format.h b/src/include/mobile/utils_i18n_measure_format.h index 75d4a64..823752c 100644 --- a/src/include/mobile/utils_i18n_measure_format.h +++ b/src/include/mobile/utils_i18n_measure_format.h @@ -34,7 +34,7 @@ extern "C" { * @defgroup CAPI_BASE_UTILS_I18N_MEASURE_FORMAT_MODULE MeasureFormat * @brief The MeasureFormat is a formatter for Measure objects. * @section CAPI_BASE_UTILS_I18N_MEASURE_FORMAT_MODULE_HEADER Required Header - *» \#include + * \#include * * @section CAPI_BASE_UTILS_I18N_MEASURE_FORMAT_MODULE_OVERVIEW Overview * @details @@ -47,9 +47,9 @@ extern "C" { /** * @brief Creates the measure format object using given locale. + * @since_tizen 3.0 * @remarks The created object should be released by the caller with the * i18n_measure_format_destroy() function. - * @since_tizen 3.0 * * @param[in] language The language of the locale * @param[in] country The country of the locale @@ -78,9 +78,9 @@ int i18n_measure_format_destroy(i18n_measure_format_h measure_format); /** * @brief Creates a polymorphic clone of the given @a measure_format object. + * @since_tizen 3.0 * @remarks The @a clone object should be released by the caller with the * i18n_measure_format_destroy() function. - * @since_tizen 3.0 * * @param[in] measure_format The measure format object to be cloned * @param[out] clone The created measure format object @@ -94,12 +94,12 @@ int i18n_measure_format_clone(i18n_measure_format_h measure_format, i18n_format_ /** * @brief Formats an object to produce a string. + * @since_tizen 3.0 * @remarks The obtained @a append_to string is actually a concatenation of the given input string and * the result of the function (appended to the string). Actually, the @a append_to * buffer is being reallocated inside the function which means that the buffer is not * at the same place in memory as it was on the input. Please note that the @a append_to * buffer should be released by the caller with the free() function. - * @since_tizen 3.0 * * @param[in] measure_format The format object * @param[in] formattable The object to format @@ -118,9 +118,9 @@ int i18n_measure_format_format(i18n_measure_format_h measure_format, i18n_format /** * @brief Parses a string to produce an object. + * @since_tizen 3.0 * @remarks The obtained @a result object should be released by the caller * with the i18n_formattable_destroy() function. - * @since_tizen 3.0 * * @param[in] measure_format The format object * @param[in] source The string to be parsed into an object @@ -141,9 +141,9 @@ int i18n_measure_format_parse_object(i18n_measure_format_h measure_format, const /** * @brief Gets a formatter for currency amount objects in the given locale. + * @since_tizen 3.0 * @remarks The created object should be released by the caller with the * i18n_measure_format_destroy() function. - * @since_tizen 3.0 * * @param[in] language The language of the locale * @param[in] country The country of the locale @@ -158,9 +158,9 @@ int i18n_measure_format_create_currency_format_from_locale(const char *language, /** * @brief Gets a formatter for currency amount objects in the default locale. + * @since_tizen 3.0 * @remarks The created object should be released by the caller with the * i18n_measure_format_destroy() function. - * @since_tizen 3.0 * * @param[out] measure_format The measure format object * diff --git a/src/include/mobile/utils_i18n_measure_unit.h b/src/include/mobile/utils_i18n_measure_unit.h index 144b87f..ae16c42 100644 --- a/src/include/mobile/utils_i18n_measure_unit.h +++ b/src/include/mobile/utils_i18n_measure_unit.h @@ -47,9 +47,9 @@ extern "C" { /** * @brief Creates the default measure unit object. + * @since_tizen 3.0 * @remarks The created object should be released by the caller with the * #i18n_measure_unit_destroy() function. - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -62,9 +62,9 @@ int i18n_measure_unit_create(i18n_measure_unit_h *measure_unit); /** * @brief Creates a polymorphic clone of the given @a clone object. + * @since_tizen 3.0 * @remarks The created object should be released by the caller with the * #i18n_measure_unit_destroy() function. - * @since_tizen 3.0 * * @param[in] measure_unit The measure unit object to be cloned. * @param[out] clone The clone of the given @a measure_unit object @@ -103,9 +103,8 @@ int i18n_measure_unit_array_destroy(i18n_measure_unit_h *array, int32_t array_si /** * @brief Gets the measure unit object type. - * @remarks The obtained type should not be freed as it is handled by the given measure - * unit object. * @since_tizen 3.0 + * @remarks The obtained type should be released by the caller with the free() function. * * @param[in] measure_unit The measure unit object * @param[out] type The measure unit object type @@ -115,13 +114,12 @@ int i18n_measure_unit_array_destroy(i18n_measure_unit_h *array, int32_t array_si * @retval #I18N_ERROR_INVALID_PARAMETER Invalid function parameter * @retval #I18N_ERROR_OUT_OF_MEMORY Out of memory */ -int i18n_measure_unit_get_type(i18n_measure_unit_h measure_unit, const char **type); +int i18n_measure_unit_get_type(i18n_measure_unit_h measure_unit, char **type); /** * @brief Gets the measure unit object sub type. - * @remarks The obtained subtype should not be freed as it is handled by the given measure - * unit object. * @since_tizen 3.0 + * @remarks The obtained subtype should be released by the caller with the free() function. * * @param[in] measure_unit The measure unit object * @param[out] subtype The measure unit object subtype @@ -131,15 +129,15 @@ int i18n_measure_unit_get_type(i18n_measure_unit_h measure_unit, const char **ty * @retval #I18N_ERROR_INVALID_PARAMETER Invalid function parameter * @retval #I18N_ERROR_OUT_OF_MEMORY Out of memory */ -int i18n_measure_unit_get_subtype(i18n_measure_unit_h measure_unit, const char **subtype); +int i18n_measure_unit_get_subtype(i18n_measure_unit_h measure_unit, char **subtype); /** * @brief Gets all of the available units. * @details If there are too many units to fit into @a dest_capacity the returned error code * is #I18N_ERROR_BUFFER_OVERFLOW. + * @since_tizen 3.0 * @remarks The obtained array of measure unit objects should be released by the caller * with the #i18n_measure_unit_array_destroy() function. - * @since_tizen 3.0 * * @param[in] dest_capacity The capacity of the given @a dest_array * @param[out] dest_array The destination buffer @@ -157,9 +155,9 @@ int i18n_measure_unit_get_available(int32_t dest_capacity, i18n_measure_unit_h * * @brief Gets all of the available units for a specific type. * @details If there are too many units to fit into dest_capacity then the error code * is set to #I18N_ERROR_BUFFER_OVERFLOW. + * @since_tizen 3.0 * @remarks The obtained array of measure unit objects should be released by the caller * with the #i18n_measure_unit_array_destroy() function. - * @since_tizen 3.0 * * @param[in] dest_capacity The capacity of the given @a dest_array * @param[in] type The type of the obtained units @@ -189,9 +187,9 @@ int i18n_measure_unit_foreach_available_type(i18n_measure_unit_types_cb cb, void /** * @brief Gets unit of acceleration: g-force. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -204,9 +202,9 @@ int i18n_measure_unit_create_g_force(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of acceleration: meter-per-second-squared. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -219,9 +217,9 @@ int i18n_measure_unit_create_meter_per_second_squared(i18n_measure_unit_h *measu /** * @brief Gets unit of angle: arc-minute. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -234,9 +232,9 @@ int i18n_measure_unit_create_arc_minute(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of angle: arc-second. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -249,9 +247,9 @@ int i18n_measure_unit_create_arc_second(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of angle: degree. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -264,9 +262,9 @@ int i18n_measure_unit_create_degree(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of angle: radian. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -279,9 +277,9 @@ int i18n_measure_unit_create_radian(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of angle: acre. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -294,9 +292,9 @@ int i18n_measure_unit_create_acre(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of angle: hectare. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -309,9 +307,9 @@ int i18n_measure_unit_create_hectare(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit area: square-centimeter. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -324,9 +322,9 @@ int i18n_measure_unit_create_square_centimeter(i18n_measure_unit_h *measure_unit /** * @brief Gets unit area: square-foot. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -339,9 +337,9 @@ int i18n_measure_unit_create_square_foot(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit area: square-inch. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -354,9 +352,9 @@ int i18n_measure_unit_create_square_inch(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit area: square-kilometer. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -369,9 +367,9 @@ int i18n_measure_unit_create_square_kilometer(i18n_measure_unit_h *measure_unit) /** * @brief Gets unit area: square-meter. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -384,9 +382,9 @@ int i18n_measure_unit_create_square_meter(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit area: square-mile. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -399,9 +397,9 @@ int i18n_measure_unit_create_square_mile(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit area: square-yard. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -414,9 +412,9 @@ int i18n_measure_unit_create_square_yard(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of consumption: liter-per-kilometer. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -429,9 +427,9 @@ int i18n_measure_unit_create_liter_per_kilometer(i18n_measure_unit_h *measure_un /** * @brief Gets unit of consumption: mile-per-gallon. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -444,9 +442,9 @@ int i18n_measure_unit_create_mile_per_gallon(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of digital: bit. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -459,9 +457,9 @@ int i18n_measure_unit_create_bit(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of digital: byte. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -474,9 +472,9 @@ int i18n_measure_unit_create_byte(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of digital: gigabit. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -489,9 +487,9 @@ int i18n_measure_unit_create_gigabit(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of digital: gigabyte. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -504,9 +502,9 @@ int i18n_measure_unit_create_gigabyte(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of digital: kilobit. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -519,9 +517,9 @@ int i18n_measure_unit_create_kilobit(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of digital: kilobyte. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -534,9 +532,9 @@ int i18n_measure_unit_create_kilobyte(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of digital: megabit. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -549,9 +547,9 @@ int i18n_measure_unit_create_megabit(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of digital: megabyte. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -564,9 +562,9 @@ int i18n_measure_unit_create_megabyte(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of digital: terabit. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -579,9 +577,9 @@ int i18n_measure_unit_create_terabit(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of digital: terabyte. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -594,9 +592,9 @@ int i18n_measure_unit_create_terabyte(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of duration: day. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -609,9 +607,9 @@ int i18n_measure_unit_create_day(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of duration: hour. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -624,9 +622,9 @@ int i18n_measure_unit_create_hour(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of duration: microsecond. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -639,9 +637,9 @@ int i18n_measure_unit_create_microsecond(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of duration: millisecond. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -654,9 +652,9 @@ int i18n_measure_unit_create_millisecond(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of duration: minute. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -669,9 +667,9 @@ int i18n_measure_unit_create_minute(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of duration: month. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -684,9 +682,9 @@ int i18n_measure_unit_create_month(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of duration: nanosecond. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -699,9 +697,9 @@ int i18n_measure_unit_create_nanosecond(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of duration: second. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -714,9 +712,9 @@ int i18n_measure_unit_create_second(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of duration: week. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -729,9 +727,9 @@ int i18n_measure_unit_create_week(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of duration: year. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -744,9 +742,9 @@ int i18n_measure_unit_create_year(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of electric: ampere. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -759,9 +757,9 @@ int i18n_measure_unit_create_ampere(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of electric: milliampere. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -774,9 +772,9 @@ int i18n_measure_unit_create_milliampere(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of electric: ohm. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -789,9 +787,9 @@ int i18n_measure_unit_create_ohm(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of electric: volt. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -804,9 +802,9 @@ int i18n_measure_unit_create_volt(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of energy: calorie. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -819,9 +817,9 @@ int i18n_measure_unit_create_calorie(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of energy: foodcalorie. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -834,9 +832,9 @@ int i18n_measure_unit_create_foodcalorie(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of energy: joule. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -849,9 +847,9 @@ int i18n_measure_unit_create_joule(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of energy: kilocalorie. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -864,9 +862,9 @@ int i18n_measure_unit_create_kilocalorie(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of energy: kilojoule. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -879,9 +877,9 @@ int i18n_measure_unit_create_kilojoule(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of energy: kilowatt-hour. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -894,9 +892,9 @@ int i18n_measure_unit_create_kilowatt_hour(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of frequency: gigahertz. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -909,9 +907,9 @@ int i18n_measure_unit_create_gigahertz(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of frequency: hertz. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -924,9 +922,9 @@ int i18n_measure_unit_create_hertz(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of frequency: kilohertz. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -939,9 +937,9 @@ int i18n_measure_unit_create_kilohertz(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of frequency: megahertz. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -954,9 +952,9 @@ int i18n_measure_unit_create_megahertz(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of length: astronomical-unit. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -969,9 +967,9 @@ int i18n_measure_unit_create_astronomical_unit(i18n_measure_unit_h *measure_unit /** * @brief Gets unit of length: centimeter. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -984,9 +982,9 @@ int i18n_measure_unit_create_centimeter(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of length: decimeter. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -999,9 +997,9 @@ int i18n_measure_unit_create_decimeter(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of length: fathom. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1014,9 +1012,9 @@ int i18n_measure_unit_create_fathom(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of length: foot. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1029,9 +1027,9 @@ int i18n_measure_unit_create_foot(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of length: furlong. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1044,9 +1042,9 @@ int i18n_measure_unit_create_furlong(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of length: inch. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1059,9 +1057,9 @@ int i18n_measure_unit_create_inch(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of length: kilometer. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1074,9 +1072,9 @@ int i18n_measure_unit_create_kilometer(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of length: light-year. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1089,9 +1087,9 @@ int i18n_measure_unit_create_light_year(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of length: meter. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1104,9 +1102,9 @@ int i18n_measure_unit_create_meter(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of length: micrometer. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1119,9 +1117,9 @@ int i18n_measure_unit_create_micrometer(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of length: mile. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1134,9 +1132,9 @@ int i18n_measure_unit_create_mile(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of length: millimeter. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1149,9 +1147,9 @@ int i18n_measure_unit_create_millimeter(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of length: nanometer. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1164,9 +1162,9 @@ int i18n_measure_unit_create_nanometer(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of length: nautical-mile. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1179,9 +1177,9 @@ int i18n_measure_unit_create_nautical_mile(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of length: parsec. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1194,9 +1192,9 @@ int i18n_measure_unit_create_parsec(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of length: picometer. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1209,9 +1207,9 @@ int i18n_measure_unit_create_picometer(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of length: yard. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1224,9 +1222,9 @@ int i18n_measure_unit_create_yard(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of length: lux. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1239,9 +1237,9 @@ int i18n_measure_unit_create_lux(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of mass: carat. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1254,9 +1252,9 @@ int i18n_measure_unit_create_carat(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of mass: gram. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1269,9 +1267,9 @@ int i18n_measure_unit_create_gram(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of mass: kilogram. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1284,9 +1282,9 @@ int i18n_measure_unit_create_kilogram(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of mass: metric-ton. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1299,9 +1297,9 @@ int i18n_measure_unit_create_metric_ton(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of mass: microgram. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1314,9 +1312,9 @@ int i18n_measure_unit_create_microgram(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of mass: milligram. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1329,9 +1327,9 @@ int i18n_measure_unit_create_milligram(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of mass: ounce. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1344,9 +1342,9 @@ int i18n_measure_unit_create_ounce(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of mass: ounce-troy. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1359,9 +1357,9 @@ int i18n_measure_unit_create_ounce_troy(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of mass: pound. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1374,9 +1372,9 @@ int i18n_measure_unit_create_pound(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of mass: stone. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1389,9 +1387,9 @@ int i18n_measure_unit_create_stone(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of mass: ton. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1404,9 +1402,9 @@ int i18n_measure_unit_create_ton(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of power: gigawatt. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1419,9 +1417,9 @@ int i18n_measure_unit_create_gigawatt(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of power: horsepower. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1434,9 +1432,9 @@ int i18n_measure_unit_create_horsepower(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of power: kilowatt. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1449,9 +1447,9 @@ int i18n_measure_unit_create_kilowatt(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of power: megawatt. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1464,9 +1462,9 @@ int i18n_measure_unit_create_megawatt(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of power: milliwatt. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1479,9 +1477,9 @@ int i18n_measure_unit_create_milliwatt(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of power: watt. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1494,9 +1492,9 @@ int i18n_measure_unit_create_watt(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of pressure: hectopascal. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1509,9 +1507,9 @@ int i18n_measure_unit_create_hectopascal(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of pressure: inch-hg. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1524,9 +1522,9 @@ int i18n_measure_unit_create_inch_hg(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of pressure: millibar. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1539,9 +1537,9 @@ int i18n_measure_unit_create_millibar(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of pressure: millimeter-of-mercury. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1554,9 +1552,9 @@ int i18n_measure_unit_create_millimeter_of_mercury(i18n_measure_unit_h *measure_ /** * @brief Gets unit of pressure: pound-per-square-inch. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1569,9 +1567,9 @@ int i18n_measure_unit_create_pound_per_square_inch(i18n_measure_unit_h *measure_ /** * @brief Gets unit of proportion: karat. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1584,9 +1582,9 @@ int i18n_measure_unit_create_karat(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of speed: kilometer-per-hour. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1599,9 +1597,9 @@ int i18n_measure_unit_create_kilometer_per_hour(i18n_measure_unit_h *measure_uni /** * @brief Gets unit of speed: meter-per-second. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1614,9 +1612,9 @@ int i18n_measure_unit_create_meter_per_second(i18n_measure_unit_h *measure_unit) /** * @brief Gets unit of speed: mile-per-hour. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1629,9 +1627,9 @@ int i18n_measure_unit_create_mile_per_hour(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of temperature: celsius. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1644,9 +1642,9 @@ int i18n_measure_unit_create_celsius(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of temperature: fahrenheit. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1659,9 +1657,9 @@ int i18n_measure_unit_create_fahrenheit(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of temperature: kelvin. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1674,9 +1672,9 @@ int i18n_measure_unit_create_kelvin(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of volume: acre-foot. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1689,9 +1687,9 @@ int i18n_measure_unit_create_acre_foot(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of volume: bushel. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1704,9 +1702,9 @@ int i18n_measure_unit_create_bushel(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of volume: centiliter. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1719,9 +1717,9 @@ int i18n_measure_unit_create_centiliter(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of volume: cubic-centimeter. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1734,9 +1732,9 @@ int i18n_measure_unit_create_cubic_centimeter(i18n_measure_unit_h *measure_unit) /** * @brief Gets unit of volume: cubic-foot. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1749,9 +1747,9 @@ int i18n_measure_unit_create_cubic_foot(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of volume: cubic-inch. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1764,9 +1762,9 @@ int i18n_measure_unit_create_cubic_inch(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of volume: cubic-kilometer. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1779,9 +1777,9 @@ int i18n_measure_unit_create_cubic_kilometer(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of volume: cubic-meter. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1794,9 +1792,9 @@ int i18n_measure_unit_create_cubic_meter(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of volume: cubic-mile. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1809,9 +1807,9 @@ int i18n_measure_unit_create_cubic_mile(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of volume: cubic-yard. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1824,9 +1822,9 @@ int i18n_measure_unit_create_cubic_yard(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of volume: cup. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1839,9 +1837,9 @@ int i18n_measure_unit_create_cup(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of volume: deciliter. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1854,9 +1852,9 @@ int i18n_measure_unit_create_deciliter(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of volume: fluid-ounce. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1869,9 +1867,9 @@ int i18n_measure_unit_create_fluid_ounce(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of volume: gallon. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1884,9 +1882,9 @@ int i18n_measure_unit_create_gallon(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of volume: hectoliter. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1899,9 +1897,9 @@ int i18n_measure_unit_create_hectoliter(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of volume: liter. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1914,9 +1912,9 @@ int i18n_measure_unit_create_liter(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of volume: megaliter. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1929,9 +1927,9 @@ int i18n_measure_unit_create_megaliter(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of volume: milliliter. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1944,9 +1942,9 @@ int i18n_measure_unit_create_milliliter(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of volume: pint. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1959,9 +1957,9 @@ int i18n_measure_unit_create_pint(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of volume: quart. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1974,9 +1972,9 @@ int i18n_measure_unit_create_quart(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of volume: tablespoon. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1989,9 +1987,9 @@ int i18n_measure_unit_create_tablespoon(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of volume: teaspoon. + * @since_tizen 3.0 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * diff --git a/src/include/mobile/utils_i18n_parse_position.h b/src/include/mobile/utils_i18n_parse_position.h index 9666d36..58b0295 100644 --- a/src/include/mobile/utils_i18n_parse_position.h +++ b/src/include/mobile/utils_i18n_parse_position.h @@ -38,7 +38,7 @@ extern "C" { * \#include * * @section CAPI_BASE_UTILS_I18N_PARSE_POSITION_MODULE_OVERVIEW Overview - * @details The i18n_format_parse_object() method in the Format types requires + * @details The i18n_format_parse_object() function in the Format types requires * a Parse Position object as an argument. * By design, as you parse through a string with different formats, you can use * the same Parse Position, since the index parameter records the current position. @@ -51,9 +51,10 @@ extern "C" { /** * @brief Creates a parse position object. + * @details The index is set to position 0. + * @since_tizen 3.0 * @remarks The created object should be released by the caller with the * i18n_parse_position_destroy() function. - * @since_tizen 3.0 * * @param[out] parse_position The created parse position object * @@ -66,12 +67,12 @@ int i18n_parse_position_create(i18n_parse_position_h *parse_position); /** * @brief Creates a parse position object with the given initial index. + * @since_tizen 3.0 * @remarks The created object should be released by the caller with the * i18n_parse_position_destroy() function. - * @since_tizen 3.0 * - * @param[out] parse_position The parse position object * @param[in] new_index The new text offset + * @param[out] parse_position The parse position object * * @return @c 0 on success, otherwise a negative error value * @retval #I18N_ERROR_NONE Successful @@ -93,10 +94,10 @@ int i18n_parse_position_create_with_index(int32_t new_index, i18n_parse_position int i18n_parse_position_destroy(i18n_parse_position_h parse_position); /** - * @brief Creates a polymorphic clone of the given @a parse_position object. + * @brief Creates a clone of the given @a parse_position object. + * @since_tizen 3.0 * @remarks The @a clone object should be released by the caller with the * i18n_parse_position_destroy() function. - * @since_tizen 3.0 * * @param[in] parse_position The parse position object to be cloned * @param[out] clone The created parse position object @@ -110,7 +111,7 @@ int i18n_parse_position_clone(i18n_parse_position_h parse_position, i18n_parse_p /** * @brief Retrieves the current parse position. - * @details On input to a parse method, this is the index of the character + * @details On input to a parse function, this is the index of the character * at which parsing will begin; on output, it is the index of the character * following the last character parsed. * @since_tizen 3.0 @@ -140,7 +141,7 @@ int i18n_parse_position_set_index(i18n_parse_position_h parse_position, int32_t /** * @brief Sets the index at which a parse error occurred. * @details Formatters should set this before returning an error code - * from their parse_object() method. The default value is -1 + * from their parse_object() function. The default value is -1 * if this is not set. * @since_tizen 3.0 * diff --git a/src/include/mobile/utils_i18n_types.h b/src/include/mobile/utils_i18n_types.h index bc22eac..d8ee211 100644 --- a/src/include/mobile/utils_i18n_types.h +++ b/src/include/mobile/utils_i18n_types.h @@ -70,7 +70,7 @@ typedef enum { I18N_ERROR_ILLEGAL_CHAR_FOUND = TIZEN_ERROR_UTILITY_ICU | 0x10, /**< Character conversion: Illegal input sequence/combination of input units. @if MOBILE (Since 2.3.1) @endif*/ I18N_ERROR_INVALID_TABLE_FORMAT = TIZEN_ERROR_UTILITY_ICU | 0x11, /**< Conversion table file found, but corrupted. @if MOBILE (Since 2.3.1) @endif*/ I18N_ERROR_INVALID_TABLE_FILE = TIZEN_ERROR_UTILITY_ICU | 0x12, /**< Conversion table file not found. @if MOBILE (Since 2.3.1) @endif*/ - I18N_ERROR_ILLECAL_ESCAPE_SEQUENCE = TIZEN_ERROR_UTILITY_ICU | 0x13, /**< ISO-2022 illlegal escape sequence. @if MOBILE (Since 2.3.1) @endif*/ + I18N_ERROR_ILLECAL_ESCAPE_SEQUENCE = TIZEN_ERROR_UTILITY_ICU | 0x13, /**< ISO-2022 illegal escape sequence. @if MOBILE (Since 2.3.1) @endif*/ I18N_ERROR_UNSUPPORTED_ESCAPE_SEQUENCE = TIZEN_ERROR_UTILITY_ICU | 0x14, /**< ISO-2022 unsupported escape sequence. @if MOBILE (Since 2.3.1) @endif*/ I18N_ERROR_NO_SPACE_AVAILABLE = TIZEN_ERROR_UTILITY_ICU | 0x15, /**< No space available for in-buffer expansion for Arabic shaping. @if MOBILE (Since 2.3.1) @endif*/ I18N_ERROR_CE_NOT_FOUND = TIZEN_ERROR_UTILITY_ICU | 0x16, /**< Currently used only while setting variable top, but can be used generally. @if MOBILE (Since 2.3.1) @endif*/ @@ -2858,20 +2858,18 @@ typedef void *i18n_formattable_h; * @since_tizen 3.0 */ typedef enum { - I18N_FORMATTABLE_K_DATE = 0, /**< Selector indicating an #i18n_udate value */ - I18N_FORMATTABLE_K_DOUBLE = 1, /**< Selector indicating a double value */ - I18N_FORMATTABLE_K_LONG = 2, /**< Selector indicating a 32-bit integer value */ - I18N_FORMATTABLE_K_STRING = 3, /**< Selector indicating a UnicodeString value */ - I18N_FORMATTABLE_K_ARRAY = 4, /**< Selector indicating an array of #i18n_formattable_h */ - I18N_FORMATTABLE_K_INT64 = 5, /**< Selector indicating a 64-bit integer value */ - I18N_FORMATTABLE_K_OBJECT = 6, /**< Selector indicating a UObject value */ + I18N_FORMATTABLE_TYPE_DATE = 0, /**< Selector indicating an #i18n_udate value */ + I18N_FORMATTABLE_TYPE_DOUBLE = 1, /**< Selector indicating a double value */ + I18N_FORMATTABLE_TYPE_LONG = 2, /**< Selector indicating a 32-bit integer value */ + I18N_FORMATTABLE_TYPE_STRING = 3, /**< Selector indicating a string */ + I18N_FORMATTABLE_TYPE_ARRAY = 4, /**< Selector indicating an array of #i18n_formattable_h */ + I18N_FORMATTABLE_TYPE_INT64 = 5, /**< Selector indicating a 64-bit integer value */ + I18N_FORMATTABLE_TYPE_OBJECT = 6, /**< Selector indicating a generic object value. + In the current version of the API, such objects + are not supported and cannot be used. This value + was added for completeness and possible future extensions. */ } i18n_formattable_type_e; -/** - * @brief Handle to the object of class used by the #i18n_format_h and its subclasses to identify fields in a formatted output. - * @since_tizen 3.0 - */ -typedef void *i18n_field_position_h; /** * @brief Handle to the object that represents an amount of a specified unit. @@ -2954,7 +2952,7 @@ typedef enum { } i18_alpha_idx_label_type_e; /** - * @brief Handle to the object used by the Format and its subtypes to identify fields in a formatted output. + * @brief A simple type used by Format module and its submodules to identify fields in formatted output. * @since_tizen 3.0 */ typedef void *i18n_field_position_h; @@ -2968,7 +2966,7 @@ typedef enum { } i18n_field_position_dont_care_e; /** - * @brief Handle to the object used by the Format and its subtypes to keep track of the current position during parsing. + * @brief A simple type used by Format module and its submodules to identify fields in formatted output. * @since_tizen 3.0 */ typedef void *i18n_parse_position_h; diff --git a/src/include/wearable/utils_i18n_field_position.h b/src/include/wearable/utils_i18n_field_position.h index a80ae77..88179b2 100644 --- a/src/include/wearable/utils_i18n_field_position.h +++ b/src/include/wearable/utils_i18n_field_position.h @@ -38,14 +38,12 @@ extern "C" { * \#include * * @section CAPI_BASE_UTILS_I18N_FIELD_POSITION_MODULE_OVERVIEW Overview - * @details Fields are identified by constants, whose names typically end with _FIELD, - * defined in the various subclasses of Format. Field position keeps track of the position - * of the field within the formatted output with two indices: the index of the first - * character of the field and the index of the last character of the field. One version - * of the format method in the various Format classes requires a Field Position object - * as an argument. You use this format method to perform partial formatting or to get - * information about the formatted output (such as the position of a field). - * The FieldPosition class is not suitable for subclassing. + * @details Field position keeps track of the position of the field within the formatted + * output with two indices: the index of the first character of the field and the index + * of the last character of the field. One version of the format function in the various + * Format modules requires a Field Position object as an argument. You use this format + * function to perform partial formatting or to get information about the formatted output + * (such as the position of a field). */ /** @@ -55,9 +53,9 @@ extern "C" { /** * @brief Creates a field position object with a non-specified field. + * @since_tizen 2.3.2 * @remarks The created object should be released by the caller with the * i18n_field_position_destroy() function. - * @since_tizen 3.0 * * @param[out] field_position The created field position object * @@ -72,9 +70,9 @@ int i18n_field_position_create(i18n_field_position_h *field_position); * @brief Creates a field position object for the given field. * @details Fields are identified by constants, whose names typically end with _FIELD, * in the various subtypes of Format. + * @since_tizen 2.3.2 * @remarks The created object should be released by the caller with the * i18n_field_position_destroy() function. - * @since_tizen 3.0 * * @param[in] field The field value * @param[out] field_position The created field position object @@ -88,7 +86,7 @@ int i18n_field_position_create_for_field(int32_t field, i18n_field_position_h *f /** * @brief Destroys the field position object. - * @since_tizen 3.0 + * @since_tizen 2.3.2 * * @param[in] field_position The field position object to destroy * @@ -99,10 +97,10 @@ int i18n_field_position_create_for_field(int32_t field, i18n_field_position_h *f int i18n_field_position_destroy(i18n_field_position_h field_position); /** - * @brief Creates a polymorphic clone of the given @a field_position object. + * @brief Creates a clone of the given @a field_position object. + * @since_tizen 2.3.2 * @remarks The @a clone object should be released by the caller with the * i18n_field_position_destroy() function. - * @since_tizen 3.0 * * @param[in] field_position The field position object to be cloned * @param[out] clone The created field position object @@ -116,7 +114,7 @@ int i18n_field_position_clone(i18n_field_position_h field_position, i18n_field_p /** * @brief Retrieves the field identifier. - * @since_tizen 3.0 + * @since_tizen 2.3.2 * * @param[in] field_position The field_position object * @param[out] field The field identifier @@ -129,7 +127,7 @@ int i18n_field_position_get_field(i18n_field_position_h field_position, int32_t /** * @brief Retrieves the index of the first character in the requested field. - * @since_tizen 3.0 + * @since_tizen 2.3.2 * * @param[in] field_position The field position object * @param[out] begin_index The index of the first character in the requested field @@ -142,7 +140,7 @@ int i18n_field_position_get_begin_index(i18n_field_position_h field_position, in /** * @brief Retrieves the index of the character following the last character in the requested field. - * @since_tizen 3.0 + * @since_tizen 2.3.2 * * @param[in] field_position The field position object * @param[out] end_index The index of the character following the last character @@ -156,7 +154,7 @@ int i18n_field_position_get_end_index(i18n_field_position_h field_position, int3 /** * @brief Sets the field. - * @since_tizen 3.0 + * @since_tizen 2.3.2 * * @param[in] field_position The field_position object * @param[in] field The new value of the field @@ -169,7 +167,7 @@ int i18n_field_position_set_field(i18n_field_position_h field_position, int32_t /** * @brief Sets the begin index. - * @since_tizen 3.0 + * @since_tizen 2.3.2 * * @param[in] field_position The field_position object * @param[in] begin_index The new value of the begin index @@ -182,7 +180,7 @@ int i18n_field_position_set_begin_index(i18n_field_position_h field_position, in /** * @brief Sets the end index. - * @since_tizen 3.0 + * @since_tizen 2.3.2 * * @param[in] field_position The field_position object * @param[in] end_position The new value of the end index diff --git a/src/include/wearable/utils_i18n_format.h b/src/include/wearable/utils_i18n_format.h index 8e291a4..1422f4e 100644 --- a/src/include/wearable/utils_i18n_format.h +++ b/src/include/wearable/utils_i18n_format.h @@ -32,7 +32,7 @@ extern "C" { /** * @ingroup CAPI_BASE_UTILS_I18N_MODULE * @defgroup CAPI_BASE_UTILS_I18N_FORMAT_MODULE Format - * @brief The Format module represents the base class for all formats. + * @brief The Format module represents the base module for all formats. * @section CAPI_BASE_UTILS_I18N_FORMAT_MODULE_HEADER Required Header * \#include * @@ -56,7 +56,7 @@ extern "C" { /** * @brief Destroys the format object. - * @since_tizen 3.0 + * @since_tizen 2.3.2 * * @param[in] format The format object to destroy * @@ -68,9 +68,9 @@ int i18n_format_destroy(i18n_format_h format); /** * @brief Creates a polymorphic clone of the given @a format object. + * @since_tizen 2.3.2 * @remarks The cloned object should be released by the caller with the * i18n_format_destroy() function. - * @since_tizen 3.0 * * @param[in] format The format object to be cloned * @param[out] clone The clone of the given @a format object @@ -84,9 +84,9 @@ int i18n_format_clone(i18n_format_h format, i18n_format_h *clone); /** * @brief Formats an object to produce a string. + * @since_tizen 2.3.2 * @remarks The @a append_to parameter should be released by the caller with the * free() function. - * @since_tizen 3.0 * * @param[in] format The format object * @param[in] formattable The object to format @@ -102,9 +102,9 @@ int i18n_format_format(i18n_format_h format, i18n_formattable_h formattable, cha /** * @brief Formats an object to produce a string. + * @since_tizen 2.3.2 * @remarks The @a append_to parameter should be released by the caller with the * free() function. - * @since_tizen 3.0 * * @param[in] format The format object * @param[in] formattable The object to format @@ -122,9 +122,9 @@ int i18n_format_format_with_field_position(i18n_format_h format, i18n_formattabl /** * @brief Parses a string to produce an object. + * @since_tizen 2.3.2 * @remarks The obtained @a result formattable object should be released by the caller with the * i18n_formattable_destroy() function. - * @since_tizen 3.0 * * @param[in] format The format object * @param[in] source The string to be parsed into an object @@ -139,9 +139,9 @@ int i18n_format_parse_object(i18n_format_h format, const char *source, i18n_form /** * @brief Parses a string to produce an object. + * @since_tizen 2.3.2 * @remarks The obtained @a result formattable object should be released by the caller with the * i18n_formattable_destroy() function. - * @since_tizen 3.0 * * @param[in] format The format object * @param[in] source The string to be parsed into an object @@ -151,17 +151,17 @@ int i18n_format_parse_object(i18n_format_h format, const char *source, i18n_form * @param[out] result The formattable object to be set to the parse result. * If parse fails, return contents are undefined. * - * @return Error code. Error codes not listed below are described in the #i18n_error_code_e + * @return @c 0 on success, otherwise a negative error value * @retval #I18N_ERROR_NONE Successful * @retval #I18N_ERROR_INVALID_PARAMETER Invalid function parameter */ -int i18n_format_parse_object_with_parse_position(i18n_format_h format, char *source, i18n_parse_position_h parse_position, i18n_formattable_h *result); +int i18n_format_parse_object_with_parse_position(i18n_format_h format, const char *source, i18n_parse_position_h parse_position, i18n_formattable_h *result); /** * @brief Gets the locale for the given format object. * @details You can choose between valid and actual locale. + * @since_tizen 2.3.2 * @remarks Both @a language and @a country should be released by the caller with the free() function. - * @since_tizen 3.0 * * @param[in] format The format object * @param[in] type The type of the locale we're looking for (valid or actual) @@ -174,7 +174,7 @@ int i18n_format_parse_object_with_parse_position(i18n_format_h format, char *sou * @retval #I18N_ERROR_OUT_OF_MEMORY Out of memory */ int i18n_format_get_locale(i18n_format_h format, - i18n_uloc_data_locale_type_e type, const char **language, const char **country); + i18n_uloc_data_locale_type_e type, char **language, char **country); /** * @} diff --git a/src/include/wearable/utils_i18n_formattable.h b/src/include/wearable/utils_i18n_formattable.h index c7abfab..d10c678 100644 --- a/src/include/wearable/utils_i18n_formattable.h +++ b/src/include/wearable/utils_i18n_formattable.h @@ -53,6 +53,7 @@ extern "C" { /** * @brief Creates a new default #i18n_formattable_h. + * @since_tizen 2.3.2 * @remarks The created object should be released by the caller with the * #i18n_formattable_destroy() function. * @@ -68,6 +69,7 @@ int i18n_formattable_create_default(i18n_formattable_h *formattable); /** * @brief Creates a new #i18n_formattable_h handle with an #i18n_udate instance. + * @since_tizen 2.3.2 * @remarks The created object should be released by the caller with the * #i18n_formattable_destroy() function. * @@ -83,11 +85,12 @@ int i18n_formattable_create_default(i18n_formattable_h *formattable); int i18n_formattable_create_with_udate(i18n_udate date, i18n_formattable_h *formattable); /** - * @brief Creates a new #i18n_formattable_h handle with a double number. + * @brief Creates a new #i18n_formattable_h handle with a double value. + * @since_tizen 2.3.2 * @remarks The created object should be released by the caller with the * #i18n_formattable_destroy() function. * - * @param[in] d The double number + * @param[in] value The double value to be used * @param[out] formattable A pointer to a handle to the newly created formattable * object * @@ -96,14 +99,15 @@ int i18n_formattable_create_with_udate(i18n_udate date, i18n_formattable_h *form * @retval #I18N_ERROR_INVALID_PARAMETER Invalid function parameter * @retval #I18N_ERROR_UNKNOWN Unknown error */ -int i18n_formattable_create_with_double(double d, i18n_formattable_h *formattable); +int i18n_formattable_create_with_double(double value, i18n_formattable_h *formattable); /** - * @brief Creates a new #i18n_formattable_h handle with a long number. + * @brief Creates a new #i18n_formattable_h handle with a long value. + * @since_tizen 2.3.2 * @remarks The created object should be released by the caller with the * #i18n_formattable_destroy() function. * - * @param[in] l The long number + * @param[in] value The long value to be used * @param[out] formattable A pointer to a handle to the newly created formattable * object * @@ -112,14 +116,15 @@ int i18n_formattable_create_with_double(double d, i18n_formattable_h *formattabl * @retval #I18N_ERROR_INVALID_PARAMETER Invalid function parameter * @retval #I18N_ERROR_UNKNOWN Unknown error */ -int i18n_formattable_create_with_long(int32_t l, i18n_formattable_h *formattable); +int i18n_formattable_create_with_long(int32_t value, i18n_formattable_h *formattable); /** - * @brief Creates a new #i18n_formattable_h handle with an int64_t number. + * @brief Creates a new #i18n_formattable_h handle with an int64_t value. + * @since_tizen 2.3.2 * @remarks The created object should be released by the caller with the * #i18n_formattable_destroy() function. * - * @param[in] ll The int64_t number + * @param[in] value The int64_t value to be used * @param[out] formattable A pointer to a handle to the newly created formattable * object * @@ -128,11 +133,12 @@ int i18n_formattable_create_with_long(int32_t l, i18n_formattable_h *formattable * @retval #I18N_ERROR_INVALID_PARAMETER Invalid function parameter * @retval #I18N_ERROR_UNKNOWN Unknown error */ -int i18n_formattable_create_with_int64(int64_t ll, i18n_formattable_h *formattable); +int i18n_formattable_create_with_int64(int64_t value, i18n_formattable_h *formattable); /** * @brief Creates a new #i18n_formattable_h handle with a char string pointer. * @details Assumes that the char string is null terminated. + * @since_tizen 2.3.2 * @remarks The created object should be released by the caller with the * #i18n_formattable_destroy() function. * @@ -150,6 +156,7 @@ int i18n_formattable_create_with_char_string(const char *str_to_copy, i18n_forma /** * @brief Creates a new #i18n_formattable_h handle with an array of * #i18n_formattable_h handles. + * @since_tizen 2.3.2 * @remarks The created object should be released by the caller with the * #i18n_formattable_destroy() function. * @@ -167,6 +174,7 @@ int i18n_formattable_create_with_formattable_array(const i18n_formattable_h *arr /** * @brief Releases the given #i18n_formattable_h handle. + * @since_tizen 2.3.2 * * @param[in] formattable A handle to the formattable object to be released * @@ -180,6 +188,7 @@ int i18n_formattable_destroy(i18n_formattable_h formattable); * @brief Clones the given formattable handle with the related object to the * @a clone handle. * @details Clones can be used concurrently in multiple threads. + * @since_tizen 2.3.2 * @remarks The cloned object should be released by the caller with the * #i18n_formattable_destroy() function. * @@ -196,9 +205,9 @@ int i18n_formattable_clone(i18n_formattable_h formattable, i18n_formattable_h *c /** * @brief Gets the array value and count of the given formattable object. + * @since_tizen 2.3.2 * @remarks If this object is not of type #I18N_FORMATTABLE_K_ARRAY then the - * result is undefined. The obtained array should be released by the - * caller with the free() function. + * result is undefined. * * @param[in] formattable A handle to the formattable object * @param[out] array A pointer to an array of #i18n_formattable_h handles @@ -213,6 +222,7 @@ int i18n_formattable_get_array(i18n_formattable_h formattable, i18n_formattable_ /** * @brief Gets the date value of the given formattable object. + * @since_tizen 2.3.2 * @remarks If this object is not of type #I18N_FORMATTABLE_K_DATE then the * result is undefined. * @@ -228,6 +238,7 @@ int i18n_formattable_get_date(i18n_formattable_h formattable, i18n_udate *date); /** * @brief Gets the double value of the given formattable object. + * @since_tizen 2.3.2 * @remarks If this object is not of type #I18N_FORMATTABLE_K_DOUBLE then the * result is undefined. * @@ -243,6 +254,7 @@ int i18n_formattable_get_double(i18n_formattable_h formattable, double *value); /** * @brief Gets the int64 value of the given formattable object. + * @since_tizen 2.3.2 * @remarks If this object is not of type #I18N_FORMATTABLE_K_INT64 then the * result is undefined. * @@ -262,6 +274,7 @@ int i18n_formattable_get_int64(i18n_formattable_h formattable, int64_t *value); * minimum long value, as appropriate, is set to @value variable and * the #I18N_ERROR_INVALID_FORMAT error code is returned by the * function. + * @since_tizen 2.3.2 * * @param[in] formattable A handle to the formattable object * @param[out] value A pointer to a int32_t variable which will be filled @@ -275,9 +288,10 @@ int i18n_formattable_get_long(i18n_formattable_h formattable, int32_t *value); /** * @brief Gets the string value of the given formattable object. + * @since_tizen 2.3.2 * @remarks If the type is not a string, the function returns the * #I18N_ERROR_INVALID_FORMAT error code and the value is set to @c - * NULL. + * NULL. The @a value should be released by the caller with the free() function. * * @param[in] formattable A handle to the formattable object * @param[out] value A pointer to a char string variable which will be @@ -293,6 +307,7 @@ int i18n_formattable_get_string(i18n_formattable_h formattable, char **value); /** * @brief Gets the data type of the given formattable object. + * @since_tizen 2.3.2 * * @param[in] formattable A handle to the formattable object * @param[out] type A pointer to an #i18n_formattable_type_e variable which @@ -309,6 +324,7 @@ int i18n_formattable_get_type(i18n_formattable_h formattable, i18n_formattable_t * @brief Sets the variable pointed by the @a is_numeric pointer to @c true if * the data type of the given formattable object is #I18N_FORMATTABLE_K_DOUBLE, * #I18N_FORMATTABLE_K_LONG or #I18N_FORMATTABLE_K_INT64. + * @since_tizen 2.3.2 * * @param[in] formattable A handle to the formattable object * @param[out] is_numeric A pointer to a boolean variable which will be filled by @@ -324,6 +340,7 @@ int i18n_formattable_is_numeric(i18n_formattable_h formattable, bool *is_numeric * @brief Sets the variable pointed by the @a not_equal pointer to @c true if * the given @a formattable object is not equal to the given @a other * formattable object. + * @since_tizen 2.3.2 * * @param[in] formattable A handle to the formattable object * @param[in] other A handle to the other formattable object @@ -340,6 +357,7 @@ int i18n_formattable_not_equal(i18n_formattable_h formattable, i18n_formattable_ * @brief Sets the variable pointed by the @a equal pointer to @c true if the * given @a formattable object is equal to the given @a other * formattable object. + * @since_tizen 2.3.2 * * @param[in] formattable A handle to the formattable object * @param[in] other A handle to the other formattable object @@ -356,6 +374,7 @@ int i18n_formattable_equal(i18n_formattable_h formattable, i18n_formattable_h ot * @brief Sets the object pointed by the @a element pointer to the element at * the @a index position in the array stored by the given formattable * object (if its type is #I18N_FORMATTABLE_K_ARRAY). + * @since_tizen 2.3.2 * @remarks If this object is not of type #I18N_FORMATTABLE_K_ARRAY then the * result is undefined. * @@ -379,6 +398,7 @@ int i18n_formattable_element_at(i18n_formattable_h formattable, int32_t index, i /** * @brief Sets the array value and count of the given formattable object and * changes the type to #I18N_FORMATTABLE_K_ARRAY. + * @since_tizen 2.3.2 * * @param[in] formattable A handle to the formattable object * @param[in] array An array of handles to the formattable objects @@ -393,58 +413,63 @@ int i18n_formattable_set_array(i18n_formattable_h formattable, const i18n_format /** * @brief Sets the date value of the given formattable object and changes the * type to the #I18N_FORMATTABLE_K_DATE. + * @since_tizen 2.3.2 * * @param[in] formattable A handle to the formattable object - * @param[in] d The new i18n_udate value to be set + * @param[in] date The new i18n_udate value to be set * * @return @c 0 on success, otherwise a negative error value * @retval #I18N_ERROR_NONE Successful * @retval #I18N_ERROR_INVALID_PARAMETER Invalid function parameter */ -int i18n_formattable_set_date(i18n_formattable_h formattable, i18n_udate d); +int i18n_formattable_set_date(i18n_formattable_h formattable, i18n_udate date); /** * @brief Sets the double value of the given formattable object and changes * the type to the #I18N_FORMATTABLE_K_DOUBLE. + * @since_tizen 2.3.2 * * @param[in] formattable A handle to the formattable object - * @param[in] d The new double value to be set + * @param[in] value The new double value to be set * * @return @c 0 on success, otherwise a negative error value * @retval #I18N_ERROR_NONE Successful * @retval #I18N_ERROR_INVALID_PARAMETER Invalid function parameter */ -int i18n_formattable_set_double(i18n_formattable_h formattable, double d); +int i18n_formattable_set_double(i18n_formattable_h formattable, double value); /** * @brief Sets the int64 value of the given formattable object and changes the * type to the #I18N_FORMATTABLE_K_INT64. + * @since_tizen 2.3.2 * * @param[in] formattable A handle to the formattable object - * @param[in] ll The new int64_t value to be set + * @param[in] value The new int64_t value to be set * * @return @c 0 on success, otherwise a negative error value * @retval #I18N_ERROR_NONE Successful * @retval #I18N_ERROR_INVALID_PARAMETER Invalid function parameter */ -int i18n_formattable_set_int64(i18n_formattable_h formattable, int64_t ll); +int i18n_formattable_set_int64(i18n_formattable_h formattable, int64_t value); /** * @brief Sets the long value of the given formattable object and changes the * type to the #I18N_FORMATTABLE_K_LONG. + * @since_tizen 2.3.2 * * @param[in] formattable A handle to the formattable object - * @param[in] l The new int32_t value to be set + * @param[in] value The new int32_t value to be set * * @return @c 0 on success, otherwise a negative error value * @retval #I18N_ERROR_NONE Successful * @retval #I18N_ERROR_INVALID_PARAMETER Invalid function parameter */ -int i18n_formattable_set_long(i18n_formattable_h formattable, int32_t l); +int i18n_formattable_set_long(i18n_formattable_h formattable, int32_t value); /** * @brief Sets the string value of the given formattable object and changes * the type to the #I18N_FORMATTABLE_K_STRING. + * @since_tizen 2.3.2 * * @param[in] formattable A handle to the formattable object * @param[in] string_to_copy The new string value to be set diff --git a/src/include/wearable/utils_i18n_measure.h b/src/include/wearable/utils_i18n_measure.h index 6e2c276..c643df8 100644 --- a/src/include/wearable/utils_i18n_measure.h +++ b/src/include/wearable/utils_i18n_measure.h @@ -34,7 +34,7 @@ extern "C" { * @defgroup CAPI_BASE_UTILS_I18N_MEASURE_MODULE MeasureUnit * @brief Measure object contains an amount of a specified unit, consisting of a number and an unit. * @section CAPI_BASE_UTILS_I18N_MEASURE_MODULE_HEADER Required Header - *» \#include + * \#include * * @section CAPI_BASE_UTILS_I18N_MEASURE_MODULE_OVERVIEW Overview * @details @@ -48,9 +48,9 @@ extern "C" { /** * @brief Creates an object with the given numeric amount and the given unit. * @details After this call, the caller must not delete the given measure unit object. + * @since_tizen 2.3.2 * @remarks The created object should be released by the caller with the * #i18n_measure_destroy() function. - * @since_tizen 3.0 * * @param[in] formattable A numeric object; The #i18n_formattable_is_numeric() * function must return @c true for this object. @@ -66,9 +66,9 @@ int i18n_measure_create(const i18n_formattable_h formattable, i18n_measure_unit_ /** * @brief Creates a polymorphic clone of the given @a clone object. + * @since_tizen 2.3.2 * @remarks The @c clone object should be released by the caller with the * #i18n_measure_destroy() function. - * @since_tizen 3.0 * * @param[in] measure The measure object to be cloned * @param[out] clone The created measure object @@ -81,8 +81,8 @@ int i18n_measure_create(const i18n_formattable_h formattable, i18n_measure_unit_ int i18n_measure_clone(i18n_measure_h measure, i18n_measure_h *clone); /** - * @brief Destroys the measure object - * @since_tizen 3.0 + * @brief Destroys the measure object. + * @since_tizen 2.3.2 * * @param[in] measure The measure object to destroy * @@ -94,9 +94,9 @@ int i18n_measure_destroy(i18n_measure_h measure); /** * @brief Gets a reference to the numeric value of the measure object. + * @since_tizen 2.3.2 * @remarks The obtained formattable object should be released by the caller * with the #i18n_formattable_destroy() function. - * @since_tizen 3.0 * * @param[in] measure The measure object * @param[out] formattable The numeric value of the measure object @@ -110,9 +110,9 @@ int i18n_measure_get_number(i18n_measure_h measure, i18n_formattable_h *formatta /** * @brief Gets a reference to the unit of the measure object. + * @since_tizen 2.3.2 * @remarks The obtained measure unit object should be released by the caller * with the #i18n_measure_unit_destroy() function. - * @since_tizen 3.0 * * @param[in] measure The measure object * @param[out] measure_unit The unit of the measure object diff --git a/src/include/wearable/utils_i18n_measure_format.h b/src/include/wearable/utils_i18n_measure_format.h index 75d4a64..9bcd4a4 100644 --- a/src/include/wearable/utils_i18n_measure_format.h +++ b/src/include/wearable/utils_i18n_measure_format.h @@ -34,7 +34,7 @@ extern "C" { * @defgroup CAPI_BASE_UTILS_I18N_MEASURE_FORMAT_MODULE MeasureFormat * @brief The MeasureFormat is a formatter for Measure objects. * @section CAPI_BASE_UTILS_I18N_MEASURE_FORMAT_MODULE_HEADER Required Header - *» \#include + * \#include * * @section CAPI_BASE_UTILS_I18N_MEASURE_FORMAT_MODULE_OVERVIEW Overview * @details @@ -47,9 +47,9 @@ extern "C" { /** * @brief Creates the measure format object using given locale. + * @since_tizen 2.3.2 * @remarks The created object should be released by the caller with the * i18n_measure_format_destroy() function. - * @since_tizen 3.0 * * @param[in] language The language of the locale * @param[in] country The country of the locale @@ -66,7 +66,7 @@ int i18n_measure_format_create(const char *language, const char *country, /** * @brief Destroys the measure format object - * @since_tizen 3.0 + * @since_tizen 2.3.2 * * @param[in] measure_format The measure format object to destroy * @@ -78,9 +78,9 @@ int i18n_measure_format_destroy(i18n_measure_format_h measure_format); /** * @brief Creates a polymorphic clone of the given @a measure_format object. + * @since_tizen 2.3.2 * @remarks The @a clone object should be released by the caller with the * i18n_measure_format_destroy() function. - * @since_tizen 3.0 * * @param[in] measure_format The measure format object to be cloned * @param[out] clone The created measure format object @@ -94,12 +94,12 @@ int i18n_measure_format_clone(i18n_measure_format_h measure_format, i18n_format_ /** * @brief Formats an object to produce a string. + * @since_tizen 2.3.2 * @remarks The obtained @a append_to string is actually a concatenation of the given input string and * the result of the function (appended to the string). Actually, the @a append_to * buffer is being reallocated inside the function which means that the buffer is not * at the same place in memory as it was on the input. Please note that the @a append_to * buffer should be released by the caller with the free() function. - * @since_tizen 3.0 * * @param[in] measure_format The format object * @param[in] formattable The object to format @@ -118,9 +118,9 @@ int i18n_measure_format_format(i18n_measure_format_h measure_format, i18n_format /** * @brief Parses a string to produce an object. + * @since_tizen 2.3.2 * @remarks The obtained @a result object should be released by the caller * with the i18n_formattable_destroy() function. - * @since_tizen 3.0 * * @param[in] measure_format The format object * @param[in] source The string to be parsed into an object @@ -141,9 +141,9 @@ int i18n_measure_format_parse_object(i18n_measure_format_h measure_format, const /** * @brief Gets a formatter for currency amount objects in the given locale. + * @since_tizen 2.3.2 * @remarks The created object should be released by the caller with the * i18n_measure_format_destroy() function. - * @since_tizen 3.0 * * @param[in] language The language of the locale * @param[in] country The country of the locale @@ -158,9 +158,9 @@ int i18n_measure_format_create_currency_format_from_locale(const char *language, /** * @brief Gets a formatter for currency amount objects in the default locale. + * @since_tizen 2.3.2 * @remarks The created object should be released by the caller with the * i18n_measure_format_destroy() function. - * @since_tizen 3.0 * * @param[out] measure_format The measure format object * diff --git a/src/include/wearable/utils_i18n_measure_unit.h b/src/include/wearable/utils_i18n_measure_unit.h index 144b87f..5324c16 100644 --- a/src/include/wearable/utils_i18n_measure_unit.h +++ b/src/include/wearable/utils_i18n_measure_unit.h @@ -47,9 +47,9 @@ extern "C" { /** * @brief Creates the default measure unit object. + * @since_tizen 2.3.2 * @remarks The created object should be released by the caller with the * #i18n_measure_unit_destroy() function. - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -62,9 +62,9 @@ int i18n_measure_unit_create(i18n_measure_unit_h *measure_unit); /** * @brief Creates a polymorphic clone of the given @a clone object. + * @since_tizen 2.3.2 * @remarks The created object should be released by the caller with the * #i18n_measure_unit_destroy() function. - * @since_tizen 3.0 * * @param[in] measure_unit The measure unit object to be cloned. * @param[out] clone The clone of the given @a measure_unit object @@ -78,7 +78,7 @@ int i18n_measure_unit_clone(i18n_measure_unit_h measure_unit, i18n_measure_unit_ /** * @brief Destroys the measure unit object - * @since_tizen 3.0 + * @since_tizen 2.3.2 * * @param[in] measure_unit The measure unit object to destroy * @@ -90,7 +90,7 @@ int i18n_measure_unit_destroy(i18n_measure_unit_h measure_unit); /** * @brief Destroys the given array of the measure unit objects - * @since_tizen 3.0 + * @since_tizen 2.3.2 * * @param[in] array The array of measure unit objects to destroy * @param[in] array_size The capacity of the @a dest_array @@ -103,9 +103,8 @@ int i18n_measure_unit_array_destroy(i18n_measure_unit_h *array, int32_t array_si /** * @brief Gets the measure unit object type. - * @remarks The obtained type should not be freed as it is handled by the given measure - * unit object. - * @since_tizen 3.0 + * @since_tizen 2.3.2 + * @remarks The obtained type should be released by the caller with the free() function. * * @param[in] measure_unit The measure unit object * @param[out] type The measure unit object type @@ -115,13 +114,12 @@ int i18n_measure_unit_array_destroy(i18n_measure_unit_h *array, int32_t array_si * @retval #I18N_ERROR_INVALID_PARAMETER Invalid function parameter * @retval #I18N_ERROR_OUT_OF_MEMORY Out of memory */ -int i18n_measure_unit_get_type(i18n_measure_unit_h measure_unit, const char **type); +int i18n_measure_unit_get_type(i18n_measure_unit_h measure_unit, char **type); /** * @brief Gets the measure unit object sub type. - * @remarks The obtained subtype should not be freed as it is handled by the given measure - * unit object. - * @since_tizen 3.0 + * @since_tizen 2.3.2 + * @remarks The obtained subtype should be released by the caller with the free() function. * * @param[in] measure_unit The measure unit object * @param[out] subtype The measure unit object subtype @@ -131,15 +129,15 @@ int i18n_measure_unit_get_type(i18n_measure_unit_h measure_unit, const char **ty * @retval #I18N_ERROR_INVALID_PARAMETER Invalid function parameter * @retval #I18N_ERROR_OUT_OF_MEMORY Out of memory */ -int i18n_measure_unit_get_subtype(i18n_measure_unit_h measure_unit, const char **subtype); +int i18n_measure_unit_get_subtype(i18n_measure_unit_h measure_unit, char **subtype); /** * @brief Gets all of the available units. * @details If there are too many units to fit into @a dest_capacity the returned error code * is #I18N_ERROR_BUFFER_OVERFLOW. + * @since_tizen 2.3.2 * @remarks The obtained array of measure unit objects should be released by the caller * with the #i18n_measure_unit_array_destroy() function. - * @since_tizen 3.0 * * @param[in] dest_capacity The capacity of the given @a dest_array * @param[out] dest_array The destination buffer @@ -157,9 +155,9 @@ int i18n_measure_unit_get_available(int32_t dest_capacity, i18n_measure_unit_h * * @brief Gets all of the available units for a specific type. * @details If there are too many units to fit into dest_capacity then the error code * is set to #I18N_ERROR_BUFFER_OVERFLOW. + * @since_tizen 2.3.2 * @remarks The obtained array of measure unit objects should be released by the caller * with the #i18n_measure_unit_array_destroy() function. - * @since_tizen 3.0 * * @param[in] dest_capacity The capacity of the given @a dest_array * @param[in] type The type of the obtained units @@ -176,7 +174,7 @@ int i18n_measure_unit_get_available_with_type(int32_t dest_capacity, const char /** * @brief Invokes the given callback function for every available measure unit type. - * @since_tizen 3.0 + * @since_tizen 2.3.2 * * @param[in] cb The callback function invoked for every available measure unit type * @param[in] user_data The user data passed to the callback function @@ -189,9 +187,9 @@ int i18n_measure_unit_foreach_available_type(i18n_measure_unit_types_cb cb, void /** * @brief Gets unit of acceleration: g-force. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -204,9 +202,9 @@ int i18n_measure_unit_create_g_force(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of acceleration: meter-per-second-squared. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -219,9 +217,9 @@ int i18n_measure_unit_create_meter_per_second_squared(i18n_measure_unit_h *measu /** * @brief Gets unit of angle: arc-minute. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -234,9 +232,9 @@ int i18n_measure_unit_create_arc_minute(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of angle: arc-second. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -249,9 +247,9 @@ int i18n_measure_unit_create_arc_second(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of angle: degree. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -264,9 +262,9 @@ int i18n_measure_unit_create_degree(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of angle: radian. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -279,9 +277,9 @@ int i18n_measure_unit_create_radian(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of angle: acre. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -294,9 +292,9 @@ int i18n_measure_unit_create_acre(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of angle: hectare. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -309,9 +307,9 @@ int i18n_measure_unit_create_hectare(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit area: square-centimeter. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -324,9 +322,9 @@ int i18n_measure_unit_create_square_centimeter(i18n_measure_unit_h *measure_unit /** * @brief Gets unit area: square-foot. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -339,9 +337,9 @@ int i18n_measure_unit_create_square_foot(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit area: square-inch. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -354,9 +352,9 @@ int i18n_measure_unit_create_square_inch(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit area: square-kilometer. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -369,9 +367,9 @@ int i18n_measure_unit_create_square_kilometer(i18n_measure_unit_h *measure_unit) /** * @brief Gets unit area: square-meter. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -384,9 +382,9 @@ int i18n_measure_unit_create_square_meter(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit area: square-mile. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -399,9 +397,9 @@ int i18n_measure_unit_create_square_mile(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit area: square-yard. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -414,9 +412,9 @@ int i18n_measure_unit_create_square_yard(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of consumption: liter-per-kilometer. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -429,9 +427,9 @@ int i18n_measure_unit_create_liter_per_kilometer(i18n_measure_unit_h *measure_un /** * @brief Gets unit of consumption: mile-per-gallon. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -444,9 +442,9 @@ int i18n_measure_unit_create_mile_per_gallon(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of digital: bit. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -459,9 +457,9 @@ int i18n_measure_unit_create_bit(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of digital: byte. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -474,9 +472,9 @@ int i18n_measure_unit_create_byte(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of digital: gigabit. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -489,9 +487,9 @@ int i18n_measure_unit_create_gigabit(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of digital: gigabyte. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -504,9 +502,9 @@ int i18n_measure_unit_create_gigabyte(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of digital: kilobit. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -519,9 +517,9 @@ int i18n_measure_unit_create_kilobit(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of digital: kilobyte. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -534,9 +532,9 @@ int i18n_measure_unit_create_kilobyte(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of digital: megabit. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -549,9 +547,9 @@ int i18n_measure_unit_create_megabit(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of digital: megabyte. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -564,9 +562,9 @@ int i18n_measure_unit_create_megabyte(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of digital: terabit. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -579,9 +577,9 @@ int i18n_measure_unit_create_terabit(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of digital: terabyte. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -594,9 +592,9 @@ int i18n_measure_unit_create_terabyte(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of duration: day. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -609,9 +607,9 @@ int i18n_measure_unit_create_day(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of duration: hour. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -624,9 +622,9 @@ int i18n_measure_unit_create_hour(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of duration: microsecond. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -639,9 +637,9 @@ int i18n_measure_unit_create_microsecond(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of duration: millisecond. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -654,9 +652,9 @@ int i18n_measure_unit_create_millisecond(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of duration: minute. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -669,9 +667,9 @@ int i18n_measure_unit_create_minute(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of duration: month. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -684,9 +682,9 @@ int i18n_measure_unit_create_month(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of duration: nanosecond. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -699,9 +697,9 @@ int i18n_measure_unit_create_nanosecond(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of duration: second. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -714,9 +712,9 @@ int i18n_measure_unit_create_second(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of duration: week. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -729,9 +727,9 @@ int i18n_measure_unit_create_week(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of duration: year. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -744,9 +742,9 @@ int i18n_measure_unit_create_year(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of electric: ampere. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -759,9 +757,9 @@ int i18n_measure_unit_create_ampere(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of electric: milliampere. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -774,9 +772,9 @@ int i18n_measure_unit_create_milliampere(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of electric: ohm. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -789,9 +787,9 @@ int i18n_measure_unit_create_ohm(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of electric: volt. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -804,9 +802,9 @@ int i18n_measure_unit_create_volt(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of energy: calorie. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -819,9 +817,9 @@ int i18n_measure_unit_create_calorie(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of energy: foodcalorie. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -834,9 +832,9 @@ int i18n_measure_unit_create_foodcalorie(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of energy: joule. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -849,9 +847,9 @@ int i18n_measure_unit_create_joule(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of energy: kilocalorie. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -864,9 +862,9 @@ int i18n_measure_unit_create_kilocalorie(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of energy: kilojoule. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -879,9 +877,9 @@ int i18n_measure_unit_create_kilojoule(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of energy: kilowatt-hour. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -894,9 +892,9 @@ int i18n_measure_unit_create_kilowatt_hour(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of frequency: gigahertz. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -909,9 +907,9 @@ int i18n_measure_unit_create_gigahertz(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of frequency: hertz. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -924,9 +922,9 @@ int i18n_measure_unit_create_hertz(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of frequency: kilohertz. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -939,9 +937,9 @@ int i18n_measure_unit_create_kilohertz(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of frequency: megahertz. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -954,9 +952,9 @@ int i18n_measure_unit_create_megahertz(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of length: astronomical-unit. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -969,9 +967,9 @@ int i18n_measure_unit_create_astronomical_unit(i18n_measure_unit_h *measure_unit /** * @brief Gets unit of length: centimeter. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -984,9 +982,9 @@ int i18n_measure_unit_create_centimeter(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of length: decimeter. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -999,9 +997,9 @@ int i18n_measure_unit_create_decimeter(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of length: fathom. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1014,9 +1012,9 @@ int i18n_measure_unit_create_fathom(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of length: foot. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1029,9 +1027,9 @@ int i18n_measure_unit_create_foot(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of length: furlong. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1044,9 +1042,9 @@ int i18n_measure_unit_create_furlong(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of length: inch. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1059,9 +1057,9 @@ int i18n_measure_unit_create_inch(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of length: kilometer. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1074,9 +1072,9 @@ int i18n_measure_unit_create_kilometer(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of length: light-year. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1089,9 +1087,9 @@ int i18n_measure_unit_create_light_year(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of length: meter. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1104,9 +1102,9 @@ int i18n_measure_unit_create_meter(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of length: micrometer. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1119,9 +1117,9 @@ int i18n_measure_unit_create_micrometer(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of length: mile. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1134,9 +1132,9 @@ int i18n_measure_unit_create_mile(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of length: millimeter. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1149,9 +1147,9 @@ int i18n_measure_unit_create_millimeter(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of length: nanometer. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1164,9 +1162,9 @@ int i18n_measure_unit_create_nanometer(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of length: nautical-mile. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1179,9 +1177,9 @@ int i18n_measure_unit_create_nautical_mile(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of length: parsec. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1194,9 +1192,9 @@ int i18n_measure_unit_create_parsec(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of length: picometer. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1209,9 +1207,9 @@ int i18n_measure_unit_create_picometer(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of length: yard. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1224,9 +1222,9 @@ int i18n_measure_unit_create_yard(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of length: lux. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1239,9 +1237,9 @@ int i18n_measure_unit_create_lux(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of mass: carat. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1254,9 +1252,9 @@ int i18n_measure_unit_create_carat(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of mass: gram. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1269,9 +1267,9 @@ int i18n_measure_unit_create_gram(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of mass: kilogram. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1284,9 +1282,9 @@ int i18n_measure_unit_create_kilogram(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of mass: metric-ton. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1299,9 +1297,9 @@ int i18n_measure_unit_create_metric_ton(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of mass: microgram. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1314,9 +1312,9 @@ int i18n_measure_unit_create_microgram(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of mass: milligram. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1329,9 +1327,9 @@ int i18n_measure_unit_create_milligram(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of mass: ounce. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1344,9 +1342,9 @@ int i18n_measure_unit_create_ounce(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of mass: ounce-troy. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1359,9 +1357,9 @@ int i18n_measure_unit_create_ounce_troy(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of mass: pound. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1374,9 +1372,9 @@ int i18n_measure_unit_create_pound(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of mass: stone. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1389,9 +1387,9 @@ int i18n_measure_unit_create_stone(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of mass: ton. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1404,9 +1402,9 @@ int i18n_measure_unit_create_ton(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of power: gigawatt. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1419,9 +1417,9 @@ int i18n_measure_unit_create_gigawatt(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of power: horsepower. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1434,9 +1432,9 @@ int i18n_measure_unit_create_horsepower(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of power: kilowatt. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1449,9 +1447,9 @@ int i18n_measure_unit_create_kilowatt(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of power: megawatt. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1464,9 +1462,9 @@ int i18n_measure_unit_create_megawatt(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of power: milliwatt. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1479,9 +1477,9 @@ int i18n_measure_unit_create_milliwatt(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of power: watt. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1494,9 +1492,9 @@ int i18n_measure_unit_create_watt(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of pressure: hectopascal. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1509,9 +1507,9 @@ int i18n_measure_unit_create_hectopascal(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of pressure: inch-hg. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1524,9 +1522,9 @@ int i18n_measure_unit_create_inch_hg(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of pressure: millibar. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1539,9 +1537,9 @@ int i18n_measure_unit_create_millibar(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of pressure: millimeter-of-mercury. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1554,9 +1552,9 @@ int i18n_measure_unit_create_millimeter_of_mercury(i18n_measure_unit_h *measure_ /** * @brief Gets unit of pressure: pound-per-square-inch. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1569,9 +1567,9 @@ int i18n_measure_unit_create_pound_per_square_inch(i18n_measure_unit_h *measure_ /** * @brief Gets unit of proportion: karat. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1584,9 +1582,9 @@ int i18n_measure_unit_create_karat(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of speed: kilometer-per-hour. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1599,9 +1597,9 @@ int i18n_measure_unit_create_kilometer_per_hour(i18n_measure_unit_h *measure_uni /** * @brief Gets unit of speed: meter-per-second. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1614,9 +1612,9 @@ int i18n_measure_unit_create_meter_per_second(i18n_measure_unit_h *measure_unit) /** * @brief Gets unit of speed: mile-per-hour. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1629,9 +1627,9 @@ int i18n_measure_unit_create_mile_per_hour(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of temperature: celsius. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1644,9 +1642,9 @@ int i18n_measure_unit_create_celsius(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of temperature: fahrenheit. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1659,9 +1657,9 @@ int i18n_measure_unit_create_fahrenheit(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of temperature: kelvin. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1674,9 +1672,9 @@ int i18n_measure_unit_create_kelvin(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of volume: acre-foot. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1689,9 +1687,9 @@ int i18n_measure_unit_create_acre_foot(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of volume: bushel. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1704,9 +1702,9 @@ int i18n_measure_unit_create_bushel(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of volume: centiliter. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1719,9 +1717,9 @@ int i18n_measure_unit_create_centiliter(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of volume: cubic-centimeter. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1734,9 +1732,9 @@ int i18n_measure_unit_create_cubic_centimeter(i18n_measure_unit_h *measure_unit) /** * @brief Gets unit of volume: cubic-foot. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1749,9 +1747,9 @@ int i18n_measure_unit_create_cubic_foot(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of volume: cubic-inch. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1764,9 +1762,9 @@ int i18n_measure_unit_create_cubic_inch(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of volume: cubic-kilometer. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1779,9 +1777,9 @@ int i18n_measure_unit_create_cubic_kilometer(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of volume: cubic-meter. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1794,9 +1792,9 @@ int i18n_measure_unit_create_cubic_meter(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of volume: cubic-mile. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1809,9 +1807,9 @@ int i18n_measure_unit_create_cubic_mile(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of volume: cubic-yard. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1824,9 +1822,9 @@ int i18n_measure_unit_create_cubic_yard(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of volume: cup. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1839,9 +1837,9 @@ int i18n_measure_unit_create_cup(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of volume: deciliter. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1854,9 +1852,9 @@ int i18n_measure_unit_create_deciliter(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of volume: fluid-ounce. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1869,9 +1867,9 @@ int i18n_measure_unit_create_fluid_ounce(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of volume: gallon. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1884,9 +1882,9 @@ int i18n_measure_unit_create_gallon(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of volume: hectoliter. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1899,9 +1897,9 @@ int i18n_measure_unit_create_hectoliter(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of volume: liter. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1914,9 +1912,9 @@ int i18n_measure_unit_create_liter(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of volume: megaliter. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1929,9 +1927,9 @@ int i18n_measure_unit_create_megaliter(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of volume: milliliter. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1944,9 +1942,9 @@ int i18n_measure_unit_create_milliliter(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of volume: pint. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1959,9 +1957,9 @@ int i18n_measure_unit_create_pint(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of volume: quart. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1974,9 +1972,9 @@ int i18n_measure_unit_create_quart(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of volume: tablespoon. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * @@ -1989,9 +1987,9 @@ int i18n_measure_unit_create_tablespoon(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of volume: teaspoon. + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). - * @since_tizen 3.0 * * @param[out] measure_unit The created measure unit object * diff --git a/src/include/wearable/utils_i18n_parse_position.h b/src/include/wearable/utils_i18n_parse_position.h index 9666d36..9c94e52 100644 --- a/src/include/wearable/utils_i18n_parse_position.h +++ b/src/include/wearable/utils_i18n_parse_position.h @@ -38,7 +38,7 @@ extern "C" { * \#include * * @section CAPI_BASE_UTILS_I18N_PARSE_POSITION_MODULE_OVERVIEW Overview - * @details The i18n_format_parse_object() method in the Format types requires + * @details The i18n_format_parse_object() function in the Format types requires * a Parse Position object as an argument. * By design, as you parse through a string with different formats, you can use * the same Parse Position, since the index parameter records the current position. @@ -51,9 +51,10 @@ extern "C" { /** * @brief Creates a parse position object. + * @details The index is set to position 0. + * @since_tizen 2.3.2 * @remarks The created object should be released by the caller with the * i18n_parse_position_destroy() function. - * @since_tizen 3.0 * * @param[out] parse_position The created parse position object * @@ -66,12 +67,12 @@ int i18n_parse_position_create(i18n_parse_position_h *parse_position); /** * @brief Creates a parse position object with the given initial index. + * @since_tizen 2.3.2 * @remarks The created object should be released by the caller with the * i18n_parse_position_destroy() function. - * @since_tizen 3.0 * - * @param[out] parse_position The parse position object * @param[in] new_index The new text offset + * @param[out] parse_position The parse position object * * @return @c 0 on success, otherwise a negative error value * @retval #I18N_ERROR_NONE Successful @@ -82,7 +83,7 @@ int i18n_parse_position_create_with_index(int32_t new_index, i18n_parse_position /** * @brief Destroys the parse position object. - * @since_tizen 3.0 + * @since_tizen 2.3.2 * * @param[in] parse_position The parse position object to destroy * @@ -93,10 +94,10 @@ int i18n_parse_position_create_with_index(int32_t new_index, i18n_parse_position int i18n_parse_position_destroy(i18n_parse_position_h parse_position); /** - * @brief Creates a polymorphic clone of the given @a parse_position object. + * @brief Creates a clone of the given @a parse_position object. + * @since_tizen 2.3.2 * @remarks The @a clone object should be released by the caller with the * i18n_parse_position_destroy() function. - * @since_tizen 3.0 * * @param[in] parse_position The parse position object to be cloned * @param[out] clone The created parse position object @@ -110,10 +111,10 @@ int i18n_parse_position_clone(i18n_parse_position_h parse_position, i18n_parse_p /** * @brief Retrieves the current parse position. - * @details On input to a parse method, this is the index of the character + * @details On input to a parse function, this is the index of the character * at which parsing will begin; on output, it is the index of the character * following the last character parsed. - * @since_tizen 3.0 + * @since_tizen 2.3.2 * * @param[in] parse_position The parse position object * @param[out] index The current index @@ -126,7 +127,7 @@ int i18n_parse_position_get_index(i18n_parse_position_h parse_position, int32_t /** * @brief Sets the current parse position. - * @since_tizen 3.0 + * @since_tizen 2.3.2 * * @param[in] parse_position The parse position object * @param[in] index The new index @@ -140,9 +141,9 @@ int i18n_parse_position_set_index(i18n_parse_position_h parse_position, int32_t /** * @brief Sets the index at which a parse error occurred. * @details Formatters should set this before returning an error code - * from their parse_object() method. The default value is -1 + * from their parse_object() function. The default value is -1 * if this is not set. - * @since_tizen 3.0 + * @since_tizen 2.3.2 * * @param[in] parse_position The parse position object * @param[in] error_index The error index @@ -156,7 +157,7 @@ int i18n_parse_position_set_error_index(i18n_parse_position_h parse_position, in /** * @brief Retrieves the index at which an error occurred, or -1 if the error index * has not been set. - * @since_tizen 3.0 + * @since_tizen 2.3.2 * * @param[in] parse_position The parse position object * @param[out] error_index The index at which an error occurred diff --git a/src/include/wearable/utils_i18n_types.h b/src/include/wearable/utils_i18n_types.h index 8874562..2e0a48e 100644 --- a/src/include/wearable/utils_i18n_types.h +++ b/src/include/wearable/utils_i18n_types.h @@ -2824,19 +2824,19 @@ typedef enum { /** * @brief Handle to the object of base class for all formats. - * @since_tizen 3.0 + * @since_tizen 2.3.2 */ typedef void *i18n_format_h; /** * @brief Handle to the object that represents a formatter for measure objects. - * @since_tizen 3.0 + * @since_tizen 2.3.2 */ typedef void *i18n_measure_format_h; /** * @brief Enumeration for various widths. - * @since_tizen 3.0 + * @since_tizen 2.3.2 */ typedef enum { I18N_UMEASFMT_WIDTH_WIDE = 0, /**< Spell out measure units */ @@ -2849,46 +2849,43 @@ typedef enum { /** * @brief Handle to the object of class used for formatting #i18n_format_h and its subclasses. - * @since_tizen 3.0 + * @since_tizen 2.3.2 */ typedef void *i18n_formattable_h; /** * @brief Enumeration for the flavor of data type contained within an #i18n_formattable_h object. - * @since_tizen 3.0 + * @since_tizen 2.3.2 */ typedef enum { - I18N_FORMATTABLE_K_DATE = 0, /**< Selector indicating an #i18n_udate value */ - I18N_FORMATTABLE_K_DOUBLE = 1, /**< Selector indicating a double value */ - I18N_FORMATTABLE_K_LONG = 2, /**< Selector indicating a 32-bit integer value */ - I18N_FORMATTABLE_K_STRING = 3, /**< Selector indicating a UnicodeString value */ - I18N_FORMATTABLE_K_ARRAY = 4, /**< Selector indicating an array of #i18n_formattable_h */ - I18N_FORMATTABLE_K_INT64 = 5, /**< Selector indicating a 64-bit integer value */ - I18N_FORMATTABLE_K_OBJECT = 6, /**< Selector indicating a UObject value */ + I18N_FORMATTABLE_TYPE_DATE = 0, /**< Selector indicating an #i18n_udate value */ + I18N_FORMATTABLE_TYPE_DOUBLE = 1, /**< Selector indicating a double value */ + I18N_FORMATTABLE_TYPE_LONG = 2, /**< Selector indicating a 32-bit integer value */ + I18N_FORMATTABLE_TYPE_STRING = 3, /**< Selector indicating a string value */ + I18N_FORMATTABLE_TYPE_ARRAY = 4, /**< Selector indicating an array of #i18n_formattable_h */ + I18N_FORMATTABLE_TYPE_INT64 = 5, /**< Selector indicating a 64-bit integer value */ + I18N_FORMATTABLE_TYPE_OBJECT = 6, /**< Selector indicating a generic object value. + In the current version of the API, such objects + are not supported and cannot be used. This value + was added for completeness and possible future extensions. */ } i18n_formattable_type_e; -/** - * @brief Handle to the object of class used by the #i18n_format_h and its subclasses to identify fields in a formatted output. - * @since_tizen 3.0 - */ -typedef void *i18n_field_position_h; - /** * @brief Handle to the object that represents an amount of a specified unit. - * @since_tizen 3.0 + * @since_tizen 2.3.2 */ typedef void *i18n_measure_h; /** * @brief Handle to the object that represents a unit such as length, mass, volume, currency, etc. - * @since_tizen 3.0 + * @since_tizen 2.3.2 */ typedef void *i18n_measure_unit_h; /** * @brief Callback function for the i18n_measure_unit_get_available_types() * that returns an enumeration over all recognized types. - * @since_tizen 3.0 + * @since_tizen 2.3.2 * * @param[in] type_id The type ID * @param[in] user_data The user data passed to the callback function @@ -2900,7 +2897,7 @@ typedef bool (*i18n_measure_unit_types_cb)(const char *type_id, void *user_data) /** * @brief Enumeration for the flavor of data type contained within an #i18n_formattable_h object. - * @since_tizen 3.0 + * @since_tizen 2.3.2 */ typedef enum { I18N_ULOC_ACTUAL_LOCALE = 0, /**< This is locale the data actually comes from */ @@ -2910,13 +2907,13 @@ typedef enum { /* * @brief The Alphabetic index handle. - * @since_tizen 3.0 + * @since_tizen 2.3.2 */ typedef void *i18_alpha_idx_h; /** * @brief Enumeration for alphabetic index label types. - * @since_tizen 3.0 + * @since_tizen 2.3.2 * * @see i18n_alpha_idx_get_bucket_label_type() */ @@ -2954,22 +2951,22 @@ typedef enum { } i18_alpha_idx_label_type_e; /** - * @brief Handle to the object used by the Format and its subtypes to identify fields in a formatted output - * @since_tizen 3.0 + * @brief A simple class used by Format and its subclasses to identify fields in formatted output + * @since_tizen 2.3.2 */ typedef void *i18n_field_position_h; /** * @brief DONT_CARE may be specified as the field to indicate that the caller doesn't need to specify a field. - * @since_tizen 3.0 + * @since_tizen 2.3.2 */ typedef enum { I18N_FIELD_POSITION_DONT_CARE = -1, } i18n_field_position_dont_care_e; /** - * @brief Handle to the object used by the Format and its subtypes to keep track of the current position during parsing. - * @since_tizen 3.0 + * @brief A simple class used by Format and its subclasses to identify fields in formatted output. + * @since_tizen 2.3.2 */ typedef void *i18n_parse_position_h; diff --git a/src/utils_i18n_format.cpp b/src/utils_i18n_format.cpp index 7379078..da645bf 100644 --- a/src/utils_i18n_format.cpp +++ b/src/utils_i18n_format.cpp @@ -127,7 +127,7 @@ int i18n_format_parse_object_with_parse_position(i18n_format_h format, const cha } int i18n_format_get_locale(i18n_format_h format, i18n_uloc_data_locale_type_e type, - const char **language, const char **country) + char **language, char **country) { retv_if(format == NULL, I18N_ERROR_INVALID_PARAMETER); retv_if(type < I18N_ULOC_ACTUAL_LOCALE || type > I18N_ULOC_REQUESTED_LOCALE, I18N_ERROR_INVALID_PARAMETER); diff --git a/src/utils_i18n_formattable.cpp b/src/utils_i18n_formattable.cpp index 90ae8a6..598f57b 100644 --- a/src/utils_i18n_formattable.cpp +++ b/src/utils_i18n_formattable.cpp @@ -85,11 +85,13 @@ int i18n_formattable_create_with_formattable_array(const i18n_formattable_h *arr retv_if(array_to_copy == NULL, I18N_ERROR_INVALID_PARAMETER); retv_if(count < 0, I18N_ERROR_INVALID_PARAMETER); retv_if(formattable == NULL, I18N_ERROR_INVALID_PARAMETER); + for (int i = 0; i < count; i++) { + retv_if(array_to_copy[i] == NULL, I18N_ERROR_INVALID_PARAMETER); + } Formattable *f_array = new Formattable[count]; for (int i = 0; i < count; i++) { - retv_if(array_to_copy[i] == NULL, I18N_ERROR_INVALID_PARAMETER); f_array[i] = *((Formattable *)array_to_copy[i]); } @@ -276,11 +278,13 @@ int i18n_formattable_set_array(i18n_formattable_h formattable, const i18n_format retv_if(formattable == NULL, I18N_ERROR_INVALID_PARAMETER); retv_if(array == NULL, I18N_ERROR_INVALID_PARAMETER); retv_if(count < 0, I18N_ERROR_INVALID_PARAMETER); + for (int i = 0; i < count; i++) { + retv_if(array[i] == NULL, I18N_ERROR_INVALID_PARAMETER); + } Formattable *f_array = new Formattable[count]; for (int i = 0; i < count; i++) { - retv_if(array[i] == NULL, I18N_ERROR_INVALID_PARAMETER); f_array[i] = *((Formattable *)array[i]); } diff --git a/src/utils_i18n_measure_format.cpp b/src/utils_i18n_measure_format.cpp index 64ff51b..b4e473b 100644 --- a/src/utils_i18n_measure_format.cpp +++ b/src/utils_i18n_measure_format.cpp @@ -24,6 +24,8 @@ int i18n_measure_format_create(const char *language, const char *country, i18n_umeasure_format_width_e width, i18n_measure_format_h *measure_format) { retv_if(measure_format == NULL, I18N_ERROR_INVALID_PARAMETER); + retv_if(width < I18N_UMEASFMT_WIDTH_WIDE, I18N_ERROR_INVALID_PARAMETER); + retv_if(width > I18N_UMEASFMT_WIDTH_COUNT, I18N_ERROR_INVALID_PARAMETER); UErrorCode status = U_ZERO_ERROR; Locale locale(language, country, 0, 0); UMeasureFormatWidth icu_width = (UMeasureFormatWidth) width; diff --git a/src/utils_i18n_measure_unit.cpp b/src/utils_i18n_measure_unit.cpp index 8f98209..d2a86d2 100644 --- a/src/utils_i18n_measure_unit.cpp +++ b/src/utils_i18n_measure_unit.cpp @@ -19,6 +19,7 @@ #include #include +#include int i18n_measure_unit_create(i18n_measure_unit_h *measure_unit) { @@ -62,21 +63,29 @@ int i18n_measure_unit_array_destroy(i18n_measure_unit_h *array, int32_t array_si return I18N_ERROR_NONE; } -int i18n_measure_unit_get_type(i18n_measure_unit_h measure_unit, const char **type) +int i18n_measure_unit_get_type(i18n_measure_unit_h measure_unit, char **type) { retv_if(measure_unit == NULL, I18N_ERROR_INVALID_PARAMETER); retv_if(type == NULL, I18N_ERROR_INVALID_PARAMETER); - *type = ((MeasureUnit *) measure_unit)->getType(); + const char *const_type; + const_type = ((MeasureUnit *) measure_unit)->getType(); + + *type = strdup(const_type); + retv_if(*type == NULL, I18N_ERROR_OUT_OF_MEMORY); return I18N_ERROR_NONE; } -int i18n_measure_unit_get_subtype(i18n_measure_unit_h measure_unit, const char **subtype) +int i18n_measure_unit_get_subtype(i18n_measure_unit_h measure_unit, char **subtype) { retv_if(measure_unit == NULL, I18N_ERROR_INVALID_PARAMETER); retv_if(subtype == NULL, I18N_ERROR_INVALID_PARAMETER); - *subtype = ((MeasureUnit *) measure_unit)->getSubtype(); + const char *const_subtype; + const_subtype = ((MeasureUnit *) measure_unit)->getSubtype(); + + *subtype = strdup(const_subtype); + retv_if(*subtype == NULL, I18N_ERROR_OUT_OF_MEMORY); return I18N_ERROR_NONE; @@ -117,7 +126,7 @@ int i18n_measure_unit_get_available_with_type(int32_t dest_capacity, const char *dest_array = new i18n_measure_unit_h[dest_capacity]; for (int i = 0; i < dest_capacity; ++i) { - (*dest_array)[i] = (const i18n_measure_unit_h) mu_array[i].clone(); + (*dest_array)[i] = (i18n_measure_unit_h) mu_array[i].clone(); } delete[] mu_array; -- 2.34.1