Tizen Native API  6.5
MeasureUnit

The MeasureUnit unit such as length, mass, volume, currency, etc. coupled with a numeric amount to produce a Measure.

Required Header

#include <utils_i18n.h>

Overview

Functions

int i18n_measure_unit_create (i18n_measure_unit_h *measure_unit)
 Creates the default measure unit object.
int i18n_measure_unit_clone (i18n_measure_unit_h measure_unit, i18n_measure_unit_h *clone)
 Creates a polymorphic clone of the given clone object.
int i18n_measure_unit_destroy (i18n_measure_unit_h measure_unit)
 Destroys the measure unit object.
int i18n_measure_unit_array_destroy (i18n_measure_unit_h *array, int32_t array_size)
 Destroys the given array of the measure unit objects.
int i18n_measure_unit_get_type (i18n_measure_unit_h measure_unit, char **type)
 Gets the measure unit object type.
int i18n_measure_unit_get_subtype (i18n_measure_unit_h measure_unit, char **subtype)
 Gets the measure unit object sub type.
int i18n_measure_unit_get_available (int32_t max_count, i18n_measure_unit_h **out_array, int32_t *available)
 Gets the available units.
int i18n_measure_unit_get_available_with_type (int32_t max_count, const char *type, i18n_measure_unit_h **out_array, int32_t *available)
 Gets the available units for a specific type.
int i18n_measure_unit_foreach_available_type (i18n_measure_unit_types_cb cb, void *user_data)
 Invokes the given callback function for every available measure unit type.
int i18n_measure_unit_create_g_force (i18n_measure_unit_h *measure_unit)
 Gets unit of acceleration: g-force.
int i18n_measure_unit_create_meter_per_second_squared (i18n_measure_unit_h *measure_unit)
 Gets unit of acceleration: meter-per-second-squared.
int i18n_measure_unit_create_arc_minute (i18n_measure_unit_h *measure_unit)
 Gets unit of angle: arc-minute.
int i18n_measure_unit_create_arc_second (i18n_measure_unit_h *measure_unit)
 Gets unit of angle: arc-second.
int i18n_measure_unit_create_degree (i18n_measure_unit_h *measure_unit)
 Gets unit of angle: degree.
int i18n_measure_unit_create_radian (i18n_measure_unit_h *measure_unit)
 Gets unit of angle: radian.
int i18n_measure_unit_create_acre (i18n_measure_unit_h *measure_unit)
 Gets unit of area: acre.
int i18n_measure_unit_create_hectare (i18n_measure_unit_h *measure_unit)
 Gets unit of area: hectare.
int i18n_measure_unit_create_square_centimeter (i18n_measure_unit_h *measure_unit)
 Gets unit area: square-centimeter.
int i18n_measure_unit_create_square_foot (i18n_measure_unit_h *measure_unit)
 Gets unit area: square-foot.
int i18n_measure_unit_create_square_inch (i18n_measure_unit_h *measure_unit)
 Gets unit area: square-inch.
int i18n_measure_unit_create_square_kilometer (i18n_measure_unit_h *measure_unit)
 Gets unit area: square-kilometer.
int i18n_measure_unit_create_square_meter (i18n_measure_unit_h *measure_unit)
 Gets unit area: square-meter.
int i18n_measure_unit_create_square_mile (i18n_measure_unit_h *measure_unit)
 Gets unit area: square-mile.
int i18n_measure_unit_create_square_yard (i18n_measure_unit_h *measure_unit)
 Gets unit area: square-yard.
int i18n_measure_unit_create_liter_per_kilometer (i18n_measure_unit_h *measure_unit)
 Gets unit of consumption: liter-per-kilometer.
int i18n_measure_unit_create_mile_per_gallon (i18n_measure_unit_h *measure_unit)
 Gets unit of consumption: mile-per-gallon.
int i18n_measure_unit_create_bit (i18n_measure_unit_h *measure_unit)
 Gets unit of digital: bit.
int i18n_measure_unit_create_byte (i18n_measure_unit_h *measure_unit)
 Gets unit of digital: byte.
int i18n_measure_unit_create_gigabit (i18n_measure_unit_h *measure_unit)
 Gets unit of digital: gigabit.
int i18n_measure_unit_create_gigabyte (i18n_measure_unit_h *measure_unit)
 Gets unit of digital: gigabyte.
int i18n_measure_unit_create_kilobit (i18n_measure_unit_h *measure_unit)
 Gets unit of digital: kilobit.
int i18n_measure_unit_create_kilobyte (i18n_measure_unit_h *measure_unit)
 Gets unit of digital: kilobyte.
int i18n_measure_unit_create_megabit (i18n_measure_unit_h *measure_unit)
 Gets unit of digital: megabit.
int i18n_measure_unit_create_megabyte (i18n_measure_unit_h *measure_unit)
 Gets unit of digital: megabyte.
int i18n_measure_unit_create_terabit (i18n_measure_unit_h *measure_unit)
 Gets unit of digital: terabit.
int i18n_measure_unit_create_terabyte (i18n_measure_unit_h *measure_unit)
 Gets unit of digital: terabyte.
int i18n_measure_unit_create_day (i18n_measure_unit_h *measure_unit)
 Gets unit of duration: day.
int i18n_measure_unit_create_hour (i18n_measure_unit_h *measure_unit)
 Gets unit of duration: hour.
int i18n_measure_unit_create_microsecond (i18n_measure_unit_h *measure_unit)
 Gets unit of duration: microsecond.
int i18n_measure_unit_create_millisecond (i18n_measure_unit_h *measure_unit)
 Gets unit of duration: millisecond.
int i18n_measure_unit_create_minute (i18n_measure_unit_h *measure_unit)
 Gets unit of duration: minute.
int i18n_measure_unit_create_month (i18n_measure_unit_h *measure_unit)
 Gets unit of duration: month.
int i18n_measure_unit_create_nanosecond (i18n_measure_unit_h *measure_unit)
 Gets unit of duration: nanosecond.
int i18n_measure_unit_create_second (i18n_measure_unit_h *measure_unit)
 Gets unit of duration: second.
int i18n_measure_unit_create_week (i18n_measure_unit_h *measure_unit)
 Gets unit of duration: week.
int i18n_measure_unit_create_year (i18n_measure_unit_h *measure_unit)
 Gets unit of duration: year.
int i18n_measure_unit_create_ampere (i18n_measure_unit_h *measure_unit)
 Gets unit of electric: ampere.
int i18n_measure_unit_create_milliampere (i18n_measure_unit_h *measure_unit)
 Gets unit of electric: milliampere.
int i18n_measure_unit_create_ohm (i18n_measure_unit_h *measure_unit)
 Gets unit of electric: ohm.
int i18n_measure_unit_create_volt (i18n_measure_unit_h *measure_unit)
 Gets unit of electric: volt.
int i18n_measure_unit_create_calorie (i18n_measure_unit_h *measure_unit)
 Gets unit of energy: calorie.
int i18n_measure_unit_create_foodcalorie (i18n_measure_unit_h *measure_unit)
 Gets unit of energy: foodcalorie.
int i18n_measure_unit_create_joule (i18n_measure_unit_h *measure_unit)
 Gets unit of energy: joule.
int i18n_measure_unit_create_kilocalorie (i18n_measure_unit_h *measure_unit)
 Gets unit of energy: kilocalorie.
int i18n_measure_unit_create_kilojoule (i18n_measure_unit_h *measure_unit)
 Gets unit of energy: kilojoule.
int i18n_measure_unit_create_kilowatt_hour (i18n_measure_unit_h *measure_unit)
 Gets unit of energy: kilowatt-hour.
int i18n_measure_unit_create_gigahertz (i18n_measure_unit_h *measure_unit)
 Gets unit of frequency: gigahertz.
int i18n_measure_unit_create_hertz (i18n_measure_unit_h *measure_unit)
 Gets unit of frequency: hertz.
int i18n_measure_unit_create_kilohertz (i18n_measure_unit_h *measure_unit)
 Gets unit of frequency: kilohertz.
int i18n_measure_unit_create_megahertz (i18n_measure_unit_h *measure_unit)
 Gets unit of frequency: megahertz.
int i18n_measure_unit_create_astronomical_unit (i18n_measure_unit_h *measure_unit)
 Gets unit of length: astronomical-unit.
int i18n_measure_unit_create_centimeter (i18n_measure_unit_h *measure_unit)
 Gets unit of length: centimeter.
int i18n_measure_unit_create_decimeter (i18n_measure_unit_h *measure_unit)
 Gets unit of length: decimeter.
int i18n_measure_unit_create_fathom (i18n_measure_unit_h *measure_unit)
 Gets unit of length: fathom.
int i18n_measure_unit_create_foot (i18n_measure_unit_h *measure_unit)
 Gets unit of length: foot.
int i18n_measure_unit_create_furlong (i18n_measure_unit_h *measure_unit)
 Gets unit of length: furlong.
int i18n_measure_unit_create_inch (i18n_measure_unit_h *measure_unit)
 Gets unit of length: inch.
int i18n_measure_unit_create_kilometer (i18n_measure_unit_h *measure_unit)
 Gets unit of length: kilometer.
int i18n_measure_unit_create_light_year (i18n_measure_unit_h *measure_unit)
 Gets unit of length: light-year.
int i18n_measure_unit_create_meter (i18n_measure_unit_h *measure_unit)
 Gets unit of length: meter.
int i18n_measure_unit_create_micrometer (i18n_measure_unit_h *measure_unit)
 Gets unit of length: micrometer.
int i18n_measure_unit_create_mile (i18n_measure_unit_h *measure_unit)
 Gets unit of length: mile.
int i18n_measure_unit_create_millimeter (i18n_measure_unit_h *measure_unit)
 Gets unit of length: millimeter.
int i18n_measure_unit_create_nanometer (i18n_measure_unit_h *measure_unit)
 Gets unit of length: nanometer.
int i18n_measure_unit_create_nautical_mile (i18n_measure_unit_h *measure_unit)
 Gets unit of length: nautical-mile.
int i18n_measure_unit_create_parsec (i18n_measure_unit_h *measure_unit)
 Gets unit of length: parsec.
int i18n_measure_unit_create_picometer (i18n_measure_unit_h *measure_unit)
 Gets unit of length: picometer.
int i18n_measure_unit_create_yard (i18n_measure_unit_h *measure_unit)
 Gets unit of length: yard.
int i18n_measure_unit_create_lux (i18n_measure_unit_h *measure_unit)
 Gets unit of illuminance: lux.
int i18n_measure_unit_create_carat (i18n_measure_unit_h *measure_unit)
 Gets unit of mass: carat.
int i18n_measure_unit_create_gram (i18n_measure_unit_h *measure_unit)
 Gets unit of mass: gram.
int i18n_measure_unit_create_kilogram (i18n_measure_unit_h *measure_unit)
 Gets unit of mass: kilogram.
int i18n_measure_unit_create_metric_ton (i18n_measure_unit_h *measure_unit)
 Gets unit of mass: metric-ton.
int i18n_measure_unit_create_microgram (i18n_measure_unit_h *measure_unit)
 Gets unit of mass: microgram.
int i18n_measure_unit_create_milligram (i18n_measure_unit_h *measure_unit)
 Gets unit of mass: milligram.
int i18n_measure_unit_create_ounce (i18n_measure_unit_h *measure_unit)
 Gets unit of mass: ounce.
int i18n_measure_unit_create_ounce_troy (i18n_measure_unit_h *measure_unit)
 Gets unit of mass: ounce-troy.
int i18n_measure_unit_create_pound (i18n_measure_unit_h *measure_unit)
 Gets unit of mass: pound.
int i18n_measure_unit_create_stone (i18n_measure_unit_h *measure_unit)
 Gets unit of mass: stone.
int i18n_measure_unit_create_ton (i18n_measure_unit_h *measure_unit)
 Gets unit of mass: ton.
int i18n_measure_unit_create_gigawatt (i18n_measure_unit_h *measure_unit)
 Gets unit of power: gigawatt.
int i18n_measure_unit_create_horsepower (i18n_measure_unit_h *measure_unit)
 Gets unit of power: horsepower.
int i18n_measure_unit_create_kilowatt (i18n_measure_unit_h *measure_unit)
 Gets unit of power: kilowatt.
int i18n_measure_unit_create_megawatt (i18n_measure_unit_h *measure_unit)
 Gets unit of power: megawatt.
int i18n_measure_unit_create_milliwatt (i18n_measure_unit_h *measure_unit)
 Gets unit of power: milliwatt.
int i18n_measure_unit_create_watt (i18n_measure_unit_h *measure_unit)
 Gets unit of power: watt.
int i18n_measure_unit_create_hectopascal (i18n_measure_unit_h *measure_unit)
 Gets unit of pressure: hectopascal.
int i18n_measure_unit_create_inch_hg (i18n_measure_unit_h *measure_unit)
 Gets unit of pressure: inch-hg.
int i18n_measure_unit_create_millibar (i18n_measure_unit_h *measure_unit)
 Gets unit of pressure: millibar.
int i18n_measure_unit_create_millimeter_of_mercury (i18n_measure_unit_h *measure_unit)
 Gets unit of pressure: millimeter-of-mercury.
int i18n_measure_unit_create_pound_per_square_inch (i18n_measure_unit_h *measure_unit)
 Gets unit of pressure: pound-per-square-inch.
int i18n_measure_unit_create_karat (i18n_measure_unit_h *measure_unit)
 Gets unit of proportion: karat.
int i18n_measure_unit_create_kilometer_per_hour (i18n_measure_unit_h *measure_unit)
 Gets unit of speed: kilometer-per-hour.
int i18n_measure_unit_create_meter_per_second (i18n_measure_unit_h *measure_unit)
 Gets unit of speed: meter-per-second.
int i18n_measure_unit_create_mile_per_hour (i18n_measure_unit_h *measure_unit)
 Gets unit of speed: mile-per-hour.
int i18n_measure_unit_create_celsius (i18n_measure_unit_h *measure_unit)
 Gets unit of temperature: celsius.
int i18n_measure_unit_create_fahrenheit (i18n_measure_unit_h *measure_unit)
 Gets unit of temperature: fahrenheit.
int i18n_measure_unit_create_kelvin (i18n_measure_unit_h *measure_unit)
 Gets unit of temperature: kelvin.
int i18n_measure_unit_create_acre_foot (i18n_measure_unit_h *measure_unit)
 Gets unit of volume: acre-foot.
int i18n_measure_unit_create_bushel (i18n_measure_unit_h *measure_unit)
 Gets unit of volume: bushel.
int i18n_measure_unit_create_centiliter (i18n_measure_unit_h *measure_unit)
 Gets unit of volume: centiliter.
int i18n_measure_unit_create_cubic_centimeter (i18n_measure_unit_h *measure_unit)
 Gets unit of volume: cubic-centimeter.
int i18n_measure_unit_create_cubic_foot (i18n_measure_unit_h *measure_unit)
 Gets unit of volume: cubic-foot.
int i18n_measure_unit_create_cubic_inch (i18n_measure_unit_h *measure_unit)
 Gets unit of volume: cubic-inch.
int i18n_measure_unit_create_cubic_kilometer (i18n_measure_unit_h *measure_unit)
 Gets unit of volume: cubic-kilometer.
int i18n_measure_unit_create_cubic_meter (i18n_measure_unit_h *measure_unit)
 Gets unit of volume: cubic-meter.
int i18n_measure_unit_create_cubic_mile (i18n_measure_unit_h *measure_unit)
 Gets unit of volume: cubic-mile.
int i18n_measure_unit_create_cubic_yard (i18n_measure_unit_h *measure_unit)
 Gets unit of volume: cubic-yard.
int i18n_measure_unit_create_cup (i18n_measure_unit_h *measure_unit)
 Gets unit of volume: cup.
int i18n_measure_unit_create_deciliter (i18n_measure_unit_h *measure_unit)
 Gets unit of volume: deciliter.
int i18n_measure_unit_create_fluid_ounce (i18n_measure_unit_h *measure_unit)
 Gets unit of volume: fluid-ounce.
int i18n_measure_unit_create_gallon (i18n_measure_unit_h *measure_unit)
 Gets unit of volume: gallon.
int i18n_measure_unit_create_hectoliter (i18n_measure_unit_h *measure_unit)
 Gets unit of volume: hectoliter.
int i18n_measure_unit_create_liter (i18n_measure_unit_h *measure_unit)
 Gets unit of volume: liter.
int i18n_measure_unit_create_megaliter (i18n_measure_unit_h *measure_unit)
 Gets unit of volume: megaliter.
int i18n_measure_unit_create_milliliter (i18n_measure_unit_h *measure_unit)
 Gets unit of volume: milliliter.
int i18n_measure_unit_create_pint (i18n_measure_unit_h *measure_unit)
 Gets unit of volume: pint.
int i18n_measure_unit_create_quart (i18n_measure_unit_h *measure_unit)
 Gets unit of volume: quart.
int i18n_measure_unit_create_tablespoon (i18n_measure_unit_h *measure_unit)
 Gets unit of volume: tablespoon.
int i18n_measure_unit_create_teaspoon (i18n_measure_unit_h *measure_unit)
 Gets unit of volume: teaspoon.

Typedefs

typedef void * i18n_measure_unit_h
 Handle to the object that represents a unit such as length, mass, volume, currency, etc.
typedef bool(* i18n_measure_unit_types_cb )(const char *type_id, void *user_data)
 Callback function for the i18n_measure_unit_get_available_types() that returns an enumeration over all recognized types.

Typedef Documentation

typedef void* i18n_measure_unit_h

Handle to the object that represents a unit such as length, mass, volume, currency, etc.

Since :
3.0
typedef bool(* i18n_measure_unit_types_cb)(const char *type_id, void *user_data)

Callback function for the i18n_measure_unit_get_available_types() that returns an enumeration over all recognized types.

Since :
3.0
Parameters:
[in]type_idThe type ID
[in]user_dataThe user data passed to the callback function
Returns:
true to continue with the next iteration of the loop, otherwise false to break out of the loop.

Function Documentation

int i18n_measure_unit_array_destroy ( i18n_measure_unit_h array,
int32_t  array_size 
)

Destroys the given array of the measure unit objects.

Since :
2.3.2
Parameters:
[in]arrayThe array of measure unit objects to destroy
[in]array_sizeThe capacity of the dest_array
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter

Creates a polymorphic clone of the given clone object.

Since :
2.3.2
Remarks:
The created object should be released by the caller with the i18n_measure_unit_destroy() function.
Parameters:
[in]measure_unitThe measure unit object to be cloned.
[out]cloneThe clone of the given measure_unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Creates the default measure unit object.

Since :
2.3.2
Remarks:
The created object should be released by the caller with the i18n_measure_unit_destroy() function.
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of area: acre.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of volume: acre-foot.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of electric: ampere.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of angle: arc-minute.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of angle: arc-second.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of length: astronomical-unit.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of digital: bit.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of volume: bushel.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of digital: byte.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of energy: calorie.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of mass: carat.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of temperature: celsius.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of volume: centiliter.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of length: centimeter.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of volume: cubic-centimeter.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of volume: cubic-foot.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of volume: cubic-inch.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of volume: cubic-kilometer.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of volume: cubic-meter.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of volume: cubic-mile.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of volume: cubic-yard.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of volume: cup.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of duration: day.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of volume: deciliter.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of length: decimeter.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of angle: degree.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of temperature: fahrenheit.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of length: fathom.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of volume: fluid-ounce.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of energy: foodcalorie.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of length: foot.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of length: furlong.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of acceleration: g-force.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of volume: gallon.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of digital: gigabit.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of digital: gigabyte.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of frequency: gigahertz.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of power: gigawatt.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of mass: gram.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of area: hectare.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of volume: hectoliter.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of pressure: hectopascal.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of frequency: hertz.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of power: horsepower.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of duration: hour.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of length: inch.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of pressure: inch-hg.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of energy: joule.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of proportion: karat.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of temperature: kelvin.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of digital: kilobit.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of digital: kilobyte.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of energy: kilocalorie.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of mass: kilogram.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of frequency: kilohertz.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of energy: kilojoule.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of length: kilometer.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of speed: kilometer-per-hour.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of power: kilowatt.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of energy: kilowatt-hour.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of length: light-year.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of volume: liter.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of consumption: liter-per-kilometer.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of illuminance: lux.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of digital: megabit.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of digital: megabyte.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of frequency: megahertz.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of volume: megaliter.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of power: megawatt.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of length: meter.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of speed: meter-per-second.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of acceleration: meter-per-second-squared.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of mass: metric-ton.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of mass: microgram.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of length: micrometer.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of duration: microsecond.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of length: mile.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of consumption: mile-per-gallon.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of speed: mile-per-hour.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of electric: milliampere.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of pressure: millibar.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of mass: milligram.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of volume: milliliter.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of length: millimeter.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of pressure: millimeter-of-mercury.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of duration: millisecond.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of power: milliwatt.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of duration: minute.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of duration: month.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of length: nanometer.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of duration: nanosecond.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of length: nautical-mile.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of electric: ohm.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of mass: ounce.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of mass: ounce-troy.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of length: parsec.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of length: picometer.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of volume: pint.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of mass: pound.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of pressure: pound-per-square-inch.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of volume: quart.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of angle: radian.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of duration: second.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit area: square-centimeter.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit area: square-foot.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit area: square-inch.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit area: square-kilometer.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit area: square-meter.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit area: square-mile.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit area: square-yard.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of mass: stone.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of volume: tablespoon.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of volume: teaspoon.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of digital: terabit.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of digital: terabyte.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of mass: ton.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of electric: volt.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of power: watt.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of duration: week.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of length: yard.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Gets unit of duration: year.

Since :
2.3.2
Remarks:
The returned measure_unit should be freed by the caller with i18n_measure_unit_destroy().
Parameters:
[out]measure_unitThe created measure unit object
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory

Destroys the measure unit object.

Since :
2.3.2
Parameters:
[in]measure_unitThe measure unit object to destroy
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter

Invokes the given callback function for every available measure unit type.

Since :
2.3.2
Parameters:
[in]cbThe callback function invoked for every available measure unit type
[in]user_dataThe user data passed to the callback function
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
int i18n_measure_unit_get_available ( int32_t  max_count,
i18n_measure_unit_h **  out_array,
int32_t *  available 
)

Gets the available units.

The function creates the array with the results. If there are more units available than the given max_count then the returned array is truncated to the first max_count units and the returned error code is I18N_ERROR_BUFFER_OVERFLOW.

Since :
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.
Parameters:
[in]max_countThe maximal number of units that will be obtained
[out]out_arrayThe output array
[out]availableThe actual number of available units
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory
I18N_ERROR_BUFFER_OVERFLOWBuffer overflow
int i18n_measure_unit_get_available_with_type ( int32_t  max_count,
const char *  type,
i18n_measure_unit_h **  out_array,
int32_t *  available 
)

Gets the available units for a specific type.

The function creates the array with the results. If there are more units available than the given max_count then the returned array is truncated to the first max_count units and the returned error code is I18N_ERROR_BUFFER_OVERFLOW.

Since :
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.
Parameters:
[in]max_countThe maximal number of units that will be obtained
[in]typeThe type of the obtained units
[out]out_arrayThe output array
[out]availableThe actual number of available units
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory
I18N_ERROR_BUFFER_OVERFLOWBuffer overflow
int i18n_measure_unit_get_subtype ( i18n_measure_unit_h  measure_unit,
char **  subtype 
)

Gets the measure unit object sub type.

Since :
2.3.2
Remarks:
The obtained subtype should be released by the caller with the free() function.
Parameters:
[in]measure_unitThe measure unit object
[out]subtypeThe measure unit object subtype
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory
int i18n_measure_unit_get_type ( i18n_measure_unit_h  measure_unit,
char **  type 
)

Gets the measure unit object type.

Since :
2.3.2
Remarks:
The obtained type should be released by the caller with the free() function.
Parameters:
[in]measure_unitThe measure unit object
[out]typeThe measure unit object type
Returns:
0 on success, otherwise a negative error value
Return values:
I18N_ERROR_NONESuccessful
I18N_ERROR_INVALID_PARAMETERInvalid function parameter
I18N_ERROR_OUT_OF_MEMORYOut of memory