* \#include <utils_i18n.h>
*
* @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).
*/
/**
/**
* @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
*
* @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
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
/**
* @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 <utils_i18n.h>
*
/**
* @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
/**
* @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
/**
* @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
/**
* @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
/**
* @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
* @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
*/
/**
* @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)
* @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);
/**
* @}
/**
* @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.
*
/**
* @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.
*
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
*
* @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
*
* @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
*
* @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.
*
/**
* @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.
*
/**
* @brief Releases the given #i18n_formattable_h handle.
+ * @since_tizen 3.0
*
* @param[in] formattable A handle to the formattable object to be released
*
/**
* @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.
/**
* @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
/**
* @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.
*
/**
* @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.
*
/**
* @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.
*
* 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
/**
* @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
/**
* @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
* @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
* @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
* @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
* @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.
*
/**
* @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
/**
* @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
* @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 <utils_i18n.h>
+ * \#include <utils_i18n.h>
*
* @section CAPI_BASE_UTILS_I18N_MEASURE_MODULE_OVERVIEW Overview
* @details
/**
* @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.
/**
* @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
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
/**
* @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
/**
* @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
* @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 <utils_i18n.h>
+ * \#include <utils_i18n.h>
*
* @section CAPI_BASE_UTILS_I18N_MEASURE_FORMAT_MODULE_OVERVIEW Overview
* @details
/**
* @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
/**
* @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
/**
* @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
/**
* @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
/**
* @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
/**
* @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
*
/**
* @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
*
/**
* @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
/**
* @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
* @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
* @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
* @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
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
* \#include <utils_i18n.h>
*
* @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.
/**
* @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
*
/**
* @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
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
/**
* @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
/**
* @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
*
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*/
* @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.
} 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;
} 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;
* \#include <utils_i18n.h>
*
* @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).
*/
/**
/**
* @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
*
* @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
/**
* @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
*
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
/**
* @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
/**
* @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
/**
* @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
/**
* @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
/**
* @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
/**
* @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
/**
* @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 <utils_i18n.h>
*
/**
* @brief Destroys the format object.
- * @since_tizen 3.0
+ * @since_tizen 2.3.2
*
* @param[in] format The format object to destroy
*
/**
* @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
/**
* @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
/**
* @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
/**
* @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
/**
* @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
* @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)
* @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);
/**
* @}
/**
* @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.
*
/**
* @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.
*
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
*
* @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
*
* @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
*
* @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.
*
/**
* @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.
*
/**
* @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
*
* @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.
*
/**
* @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
/**
* @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.
*
/**
* @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.
*
/**
* @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.
*
* 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
/**
* @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
/**
* @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
* @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
* @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
* @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
* @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.
*
/**
* @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
/**
* @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
* @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 <utils_i18n.h>
+ * \#include <utils_i18n.h>
*
* @section CAPI_BASE_UTILS_I18N_MEASURE_MODULE_OVERVIEW Overview
* @details
/**
* @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.
/**
* @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
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
*
/**
* @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
/**
* @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
* @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 <utils_i18n.h>
+ * \#include <utils_i18n.h>
*
* @section CAPI_BASE_UTILS_I18N_MEASURE_FORMAT_MODULE_OVERVIEW Overview
* @details
/**
* @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
/**
* @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
*
/**
* @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
/**
* @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
/**
* @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
/**
* @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
/**
* @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
*
/**
* @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
*
/**
* @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
/**
* @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
*
/**
* @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
/**
* @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
* @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
* @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
* @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
/**
* @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
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
/**
* @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
*
* \#include <utils_i18n.h>
*
* @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.
/**
* @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
*
/**
* @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
/**
* @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
*
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
/**
* @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
/**
* @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
/**
* @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
/**
* @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
/**
* @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 */
/**
* @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
/**
* @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 */
/*
* @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()
*/
} 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;
}
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);
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]);
}
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]);
}
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;
#include <unicode/measunit.h>
#include <unicode/strenum.h>
+#include <string.h>
int i18n_measure_unit_create(i18n_measure_unit_h *measure_unit)
{
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;
*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;
projects / platform / core / api / base-utils.git / commitdiff