From: JinWang An Date: Mon, 8 Apr 2024 01:54:05 +0000 (+0900) Subject: Removing conditional statements for Mobile/Wearable profile X-Git-Tag: accepted/tizen/unified/20240409.135545~1 X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=faa1d200c7fa0452287d6aa90ab38928319d3cf5;p=platform%2Fcore%2Fapi%2Fbase-utils.git Removing conditional statements for Mobile/Wearable profile Change-Id: I91923664c40d0946d0090f52feabbd83f8e17ba7 Signed-off-by: JinWang An --- diff --git a/src/include/utils_i18n_alpha_idx.h b/src/include/utils_i18n_alpha_idx.h index c39e40d..b8e92ee 100644 --- a/src/include/utils_i18n_alpha_idx.h +++ b/src/include/utils_i18n_alpha_idx.h @@ -61,7 +61,7 @@ extern "C" { * exemplar characters. The locale determines the sorting order * for both the index characters and the user item names appearing * under each Index character. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The created object should be released by the caller with the * #i18n_alpha_idx_destroy() function. * @@ -79,7 +79,7 @@ int i18n_alpha_idx_create(const char *language, const char *country, /** * @brief Destroys the alphabetic index object. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * * @param[in] index The alphabetic index to be destroyed * @@ -96,7 +96,7 @@ int i18n_alpha_idx_destroy(i18n_alpha_idx_h index); * they do not replace the existing index characters. The collation * order for this index is not changed; it remains that of the locale * that was originally specified when creating this Index. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * * @param[in] index Label will be added to this alphabetic index * @param[in] language The language of the locale @@ -117,7 +117,7 @@ int i18n_alpha_idx_add_labels(i18n_alpha_idx_h index, const char *language, * of the names in the index's locale. Records with duplicate * names are permitted; they will be kept in the order that * they were added. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * * @param[in] index Record will be added to this alphabetic index * @param[in] name The display name for the record. @@ -133,7 +133,7 @@ int i18n_alpha_idx_add_record(i18n_alpha_idx_h index, const char *name, /** * @brief Sets the next bucket as current bucket in the index. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * * @param[in] index The alphabetic index, which contains buckets * @param[out] available A flag set to @c true if the next bucket was available, @@ -151,7 +151,7 @@ int i18n_alpha_idx_get_next_bucket(i18n_alpha_idx_h index, bool *available); * @brief Sets the next record as current record in current bucket of the index. * @details When i18n_alpha_idx_get_next_bucket() is called, record iteration is reset * to just before the first record in the new bucket. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * * @param[in] index The alphabetic index, which contains buckets with records * @param[out] available A flag set to @c true if the next record was available, @@ -169,7 +169,7 @@ int i18n_alpha_idx_get_next_record(i18n_alpha_idx_h index, bool *available); * @brief Gets the number of records in the current bucket. * @details If the current bucket iteration position is before the first * label or after the last, return 0. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * * @param[in] index The alphabetic index, which contains buckets with records * @param[out] records_count Number of records in the current bucket @@ -185,7 +185,7 @@ int i18n_alpha_idx_get_bucket_record_count(i18n_alpha_idx_h index, int32_t *reco * @details If the iteration is before the first Bucket * (i18n_alpha_idx_get_next_bucket() has not been called), * or after the last, return an empty string. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The obtained @a label should be released by the caller with the free() function. * * @param[in] index The alphabetic index, which contains buckets @@ -204,7 +204,7 @@ int i18n_alpha_idx_get_bucket_label(i18n_alpha_idx_h index, char **label); * - the current iteration position is before the first item in this Bucket, * or after the last, * - the given @a index parameter is invalid. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The specific error code can be obtained using the get_last_result() method. * Error codes are described in Exceptions section. * @@ -220,7 +220,7 @@ const void *i18n_alpha_idx_get_record_data(i18n_alpha_idx_h index); * @brief Gets the default label used for abbreviated buckets between other index characters. * @details For example, consider the labels when Latin and Greek are used: * X Y Z ... &\#x0391; &\#x0392; &\#x0393; - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The obtained @a label should be released by the caller with the free() function. * * @param[in] index The alphabetic index, which contains buckets with records @@ -238,7 +238,7 @@ int i18n_alpha_idx_get_inflow_label(i18n_alpha_idx_h index, char **label); * @details An inflow label will be automatically inserted if two otherwise-adjacent label characters * are from different scripts, e.g. Latin and Cyrillic, and a third script, * e.g. Greek, sorts between the two. The default inflow character is an ellipsis (...) - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * * @param[in] index The alphabetic index, which contains buckets with records * @param[in] label The new inflow label @@ -252,7 +252,7 @@ int i18n_alpha_idx_set_inflow_label(i18n_alpha_idx_h index, const char *label); /** * @brief Gets the special label used for items that sort after the last normal label, * and that would not otherwise have an appropriate label. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The obtained @a label should be released by the caller with the free() function. * * @param[in] index The alphabetic index, which contains buckets with records @@ -268,7 +268,7 @@ int i18n_alpha_idx_get_overflow_label(i18n_alpha_idx_h index, char **label); /** * @brief Sets the special label used for items that sort after the last normal label, * and that would not otherwise have an appropriate label. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * * @param[in] index The alphabetic index, which contains buckets with records * @param[in] label The new overflow label @@ -282,7 +282,7 @@ int i18n_alpha_idx_set_overflow_label(i18n_alpha_idx_h index, const char *label) /** * @brief Gets the special label used for items that sort before the first normal label, * and that would not otherwise have an appropriate label. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The obtained @a label should be released by the caller with the free() function. * * @param[in] index The alphabetic index, which contains buckets with records @@ -298,7 +298,7 @@ int i18n_alpha_idx_get_underflow_label(i18n_alpha_idx_h index, char **label); /** * @brief Sets the special label used for items that sort before the first normal label, * and that would not otherwise have an appropriate label. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * * @param[in] index The alphabetic index, which contains buckets with records * @param[in] label The new underflow label @@ -312,7 +312,7 @@ int i18n_alpha_idx_set_underflow_label(i18n_alpha_idx_h index, const char *label /** * @brief Gets the limit on the number of labels permitted in the index. * @details The number does not include over, under and inflow labels. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * * @param[in] index The alphabetic index, which contains buckets with records * @param[out] max_label_count The maximum number of labels @@ -329,7 +329,7 @@ int i18n_alpha_idx_get_max_label_count(i18n_alpha_idx_h index, int32_t *max_labe * Currently, if the number is exceeded, then every nth item * is removed to bring the count down. A more sophisticated * mechanism may be available in the future. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * * @param[in] index The alphabetic index, which contains buckets with records * @param[in] max_label_count The new maximum number of labels @@ -344,7 +344,7 @@ int i18n_alpha_idx_set_max_label_count(i18n_alpha_idx_h index, int32_t max_label * @brief Remove all records from the index. * @details The set of Buckets, which define the headings under which records are classified, * is not altered. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * * @param[in] index The alphabetic index, which contains buckets with records * @@ -356,7 +356,7 @@ int i18n_alpha_idx_clear_records(i18n_alpha_idx_h index); /** * @brief Gets the number of labels in this index. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks Note: may trigger lazy index construction. * * @param[in] index The alphabetic index, which contains buckets with records @@ -372,7 +372,7 @@ int i18n_alpha_idx_get_bucket_count(i18n_alpha_idx_h index, int32_t *bucket_coun /** * @brief Gets the total number of records in this index, that is, the number of * pairs added. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * * @param[in] index The alphabetic index, which contains buckets with records * @param[out] record_count The number of records in this index, that is, @@ -391,7 +391,7 @@ int i18n_alpha_idx_get_record_count(i18n_alpha_idx_h index, int32_t *record_coun * @details The name need not be in the index. * A Record will not be added to the index by this function. * Bucket numbers are zero-based, in Bucket iteration order. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * * @param[in] index The alphabetic index, which contains buckets with records * @param[in] item_name The name whose bucket position in the index is to be determined @@ -407,7 +407,7 @@ int i18n_alpha_idx_get_bucket_index(i18n_alpha_idx_h index, const char *item_nam * @brief Gets the zero based index of the current bucket of this index. * @details Sets the variable pointed by the @a bucket_index to -1 if no iteration * is in process. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * * @param[in] index The alphabetic index, which contains buckets with records * @param[out] bucket_index The index of the current Bucket @@ -421,7 +421,7 @@ int i18n_alpha_idx_get_current_bucket_index(i18n_alpha_idx_h index, int32_t *buc /** * @brief Gets the type of the label for the current Bucket * (selected by the iteration over Buckets). - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * * @param[in] index The alphabetic index, which contains buckets with records * @param[out] type The alphabetic index label type @@ -438,7 +438,7 @@ int i18n_alpha_idx_get_bucket_label_type(i18n_alpha_idx_h index, * @details If the Record iteration position is before the first or after the last record, * sets the string pointed by the @a record_name parameter to NULL and returns * the #I18N_ERROR_INDEX_OUTOFBOUNDS error code. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The obtained @a record_name should be released by the caller with the free() function. * * @param[in] index The alphabetic index, which contains buckets with records @@ -455,7 +455,7 @@ int i18n_alpha_idx_get_record_name(i18n_alpha_idx_h index, char **record_name); /** * @brief Resets the bucket iteration for this index. * @details The next call to i18n_alpha_idx_get_next_bucket() will restart the iteration at the first label. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * * @param[in] index The alphabetic index, which contains buckets with records * @@ -468,7 +468,7 @@ int i18n_alpha_idx_reset_bucket_iter(i18n_alpha_idx_h index); /** * @brief Resets the record iteration for this index to before the first Record in the current Bucket. * @details The next call to i18n_alpha_idx_get_next_record() will restart the iteration at the first label. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * * @param[in] index The alphabetic index, which contains buckets with records * diff --git a/src/include/utils_i18n_field_position.h b/src/include/utils_i18n_field_position.h index bfa5e63..d9b9cae 100644 --- a/src/include/utils_i18n_field_position.h +++ b/src/include/utils_i18n_field_position.h @@ -53,7 +53,7 @@ extern "C" { /** * @brief Creates a field position object with a non-specified field. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The created object should be released by the caller with the * i18n_field_position_destroy() function. * @@ -70,7 +70,7 @@ int i18n_field_position_create(i18n_field_position_h *field_position); * @brief Creates a field position object for the given field. * @details The only fields currently supported are the fields accepted by the date formatter, * see #i18n_udate_format_field_e. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The created object should be released by the caller with the * i18n_field_position_destroy() function. * @@ -86,7 +86,7 @@ int i18n_field_position_create_for_field(int32_t field, i18n_field_position_h *f /** * @brief Destroys the field position object. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * * @param[in] field_position The field position object to destroy * @@ -98,7 +98,7 @@ int i18n_field_position_destroy(i18n_field_position_h field_position); /** * @brief Creates a clone of the given @a field_position object. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The @a clone object should be released by the caller with the * i18n_field_position_destroy() function. * @@ -114,7 +114,7 @@ int i18n_field_position_clone(i18n_field_position_h field_position, i18n_field_p /** * @brief Retrieves the field identifier. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * * @param[in] field_position The field_position object * @param[out] field The field identifier @@ -127,7 +127,7 @@ int i18n_field_position_get_field(i18n_field_position_h field_position, int32_t /** * @brief Retrieves the index of the first character in the requested field. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @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 @@ -140,7 +140,7 @@ int i18n_field_position_get_begin_index(i18n_field_position_h field_position, in /** * @brief Retrieves the index of the character following the last character in the requested field. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @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 @@ -154,7 +154,7 @@ int i18n_field_position_get_end_index(i18n_field_position_h field_position, int3 /** * @brief Sets the field. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * * @param[in] field_position The field_position object * @param[in] field The new value of the field @@ -167,7 +167,7 @@ int i18n_field_position_set_field(i18n_field_position_h field_position, int32_t /** * @brief Sets the begin index. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * * @param[in] field_position The field_position object * @param[in] begin_index The new value of the begin index @@ -180,7 +180,7 @@ int i18n_field_position_set_begin_index(i18n_field_position_h field_position, in /** * @brief Sets the end index. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * * @param[in] field_position The field_position object * @param[in] end_index The new value of the end index diff --git a/src/include/utils_i18n_format.h b/src/include/utils_i18n_format.h index ce36cea..938f095 100644 --- a/src/include/utils_i18n_format.h +++ b/src/include/utils_i18n_format.h @@ -54,7 +54,7 @@ extern "C" { /** * @brief Destroys the format object. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * * @param[in] format The format object to destroy * @@ -66,7 +66,7 @@ int i18n_format_destroy(i18n_format_h format); /** * @brief Creates a polymorphic clone of the given @a format object. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The cloned object should be released by the caller with the * i18n_format_destroy() function. * @@ -82,7 +82,7 @@ int i18n_format_clone(i18n_format_h format, i18n_format_h *clone); /** * @brief Formats an object to produce a string. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The @a append_to parameter should be released by the caller with the * free() function. * @@ -100,7 +100,7 @@ int i18n_format_format(i18n_format_h format, i18n_formattable_h formattable, cha /** * @brief Formats an object to produce a string. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The @a append_to parameter should be released by the caller with the * free() function. * @@ -120,7 +120,7 @@ int i18n_format_format_with_field_position(i18n_format_h format, i18n_formattabl /** * @brief Parses a string to produce an object. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The obtained @a result formattable object should be released by the caller with the * i18n_formattable_destroy() function. * @@ -137,7 +137,7 @@ int i18n_format_parse_object(i18n_format_h format, const char *source, i18n_form /** * @brief Parses a string to produce an object. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The obtained @a result formattable object should be released by the caller with the * i18n_formattable_destroy() function. * @@ -159,7 +159,7 @@ int i18n_format_parse_object_with_parse_position(i18n_format_h format, const cha * @deprecated Deprecated since 5.0. Use i18n_format_get_locale_id() instead. * @brief Gets the locale for the given format object. * @details You can choose between valid and actual locale. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks Both @a language and @a country should be released by the caller with the free() function. * * @param[in] format The format object diff --git a/src/include/utils_i18n_formattable.h b/src/include/utils_i18n_formattable.h index db05a96..79cb678 100644 --- a/src/include/utils_i18n_formattable.h +++ b/src/include/utils_i18n_formattable.h @@ -51,7 +51,7 @@ extern "C" { /** * @brief Creates a new default #i18n_formattable_h. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The created object should be released by the caller with the * #i18n_formattable_destroy() function. * @@ -67,7 +67,7 @@ int i18n_formattable_create_default(i18n_formattable_h *formattable); /** * @brief Creates a new #i18n_formattable_h handle with an #i18n_udate instance. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The created object should be released by the caller with the * #i18n_formattable_destroy() function. * @@ -84,7 +84,7 @@ int i18n_formattable_create_with_udate(i18n_udate date, i18n_formattable_h *form /** * @brief Creates a new #i18n_formattable_h handle with a double value. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The created object should be released by the caller with the * #i18n_formattable_destroy() function. * @@ -101,7 +101,7 @@ int i18n_formattable_create_with_double(double value, i18n_formattable_h *format /** * @brief Creates a new #i18n_formattable_h handle with a long value. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The created object should be released by the caller with the * #i18n_formattable_destroy() function. * @@ -118,7 +118,7 @@ int i18n_formattable_create_with_long(int32_t value, i18n_formattable_h *formatt /** * @brief Creates a new #i18n_formattable_h handle with an int64_t value. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The created object should be released by the caller with the * #i18n_formattable_destroy() function. * @@ -136,7 +136,7 @@ int i18n_formattable_create_with_int64(int64_t value, i18n_formattable_h *format /** * @brief Creates a new #i18n_formattable_h handle with a char string pointer. * @details Assumes that the char string is null terminated. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The created object should be released by the caller with the * #i18n_formattable_destroy() function. * @@ -154,7 +154,7 @@ int i18n_formattable_create_with_char_string(const char *str_to_copy, i18n_forma /** * @brief Creates a new #i18n_formattable_h handle with an array of * #i18n_formattable_h handles. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The created object should be released by the caller with the * #i18n_formattable_destroy() function. * @@ -172,7 +172,7 @@ int i18n_formattable_create_with_formattable_array(const i18n_formattable_h *arr /** * @brief Releases the given #i18n_formattable_h handle. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * * @param[in] formattable A handle to the formattable object to be released * @@ -185,7 +185,7 @@ int i18n_formattable_destroy(i18n_formattable_h formattable); /** * @brief Clones the given formattable handle with the related object to the * @a clone handle. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @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. @@ -203,7 +203,7 @@ int i18n_formattable_clone(i18n_formattable_h formattable, i18n_formattable_h *c /** * @brief Gets the array value and count of the given formattable object. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks If this object is not of type #I18N_FORMATTABLE_TYPE_ARRAY then the * result is undefined. The obtained array should be released by the * caller with the free() function. @@ -222,7 +222,7 @@ int i18n_formattable_get_array(i18n_formattable_h formattable, i18n_formattable_ /** * @brief Gets the date value of the given formattable object. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks If this object is not of type #I18N_FORMATTABLE_TYPE_DATE then the * result is undefined. * @@ -238,7 +238,7 @@ int i18n_formattable_get_date(i18n_formattable_h formattable, i18n_udate *date); /** * @brief Gets the double value of the given formattable object. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks If this object is not of type #I18N_FORMATTABLE_TYPE_DOUBLE then the * result is undefined. * @@ -254,7 +254,7 @@ int i18n_formattable_get_double(i18n_formattable_h formattable, double *value); /** * @brief Gets the int64 value of the given formattable object. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks If this object is not of type #I18N_FORMATTABLE_TYPE_INT64 then the * result is undefined. * @@ -274,7 +274,7 @@ int i18n_formattable_get_int64(i18n_formattable_h formattable, int64_t *value); * minimum long value, as appropriate, is set to @a value * and the #I18N_ERROR_INVALID_FORMAT error code is returned by the * function. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @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 @@ -288,7 +288,7 @@ int i18n_formattable_get_long(i18n_formattable_h formattable, int32_t *value); /** * @brief Gets the string value of the given formattable object. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @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. The @a value should be released by the caller with the free() function. @@ -308,7 +308,7 @@ int i18n_formattable_get_string(i18n_formattable_h formattable, char **value); /** * @brief Gets the data type of the given formattable object. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @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 @@ -325,7 +325,7 @@ int i18n_formattable_get_type(i18n_formattable_h formattable, i18n_formattable_t * @brief Sets the variable pointed by the @a is_numeric pointer to @c true if * the data type of the given formattable object is #I18N_FORMATTABLE_TYPE_DOUBLE, * #I18N_FORMATTABLE_TYPE_LONG or #I18N_FORMATTABLE_TYPE_INT64. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @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 @@ -341,7 +341,7 @@ int i18n_formattable_is_numeric(i18n_formattable_h formattable, bool *is_numeric * @brief Sets the variable pointed by the @a not_equal pointer to @c true if * the given @a formattable object is not equal to the given @a other * formattable object. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * * @param[in] formattable A handle to the formattable object * @param[in] other A handle to the other formattable object @@ -358,7 +358,7 @@ int i18n_formattable_not_equal(i18n_formattable_h formattable, i18n_formattable_ * @brief Sets the variable pointed by the @a equal pointer to @c true if the * given @a formattable object is equal to the given @a other * formattable object. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * * @param[in] formattable A handle to the formattable object * @param[in] other A handle to the other formattable object @@ -375,7 +375,7 @@ int i18n_formattable_equal(i18n_formattable_h formattable, i18n_formattable_h ot * @brief Sets the object pointed by the @a element pointer to the element at * the @a index position in the array stored by the given formattable * object (if its type is #I18N_FORMATTABLE_TYPE_ARRAY). - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks If this object is not of type #I18N_FORMATTABLE_TYPE_ARRAY then the * result is undefined. * @@ -399,7 +399,7 @@ int i18n_formattable_element_at(i18n_formattable_h formattable, int32_t index, i /** * @brief Sets the array value and count of the given formattable object and * changes the type to #I18N_FORMATTABLE_TYPE_ARRAY. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @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 @@ -414,7 +414,7 @@ int i18n_formattable_set_array(i18n_formattable_h formattable, const i18n_format /** * @brief Sets the date value of the given formattable object and changes the * type to the #I18N_FORMATTABLE_TYPE_DATE. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * * @param[in] formattable A handle to the formattable object * @param[in] date The new i18n_udate value to be set @@ -428,7 +428,7 @@ 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_TYPE_DOUBLE. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * * @param[in] formattable A handle to the formattable object * @param[in] value The new double value to be set @@ -442,7 +442,7 @@ 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_TYPE_INT64. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * * @param[in] formattable A handle to the formattable object * @param[in] value The new int64_t value to be set @@ -456,7 +456,7 @@ 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_TYPE_LONG. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * * @param[in] formattable A handle to the formattable object * @param[in] value The new int32_t value to be set @@ -470,7 +470,7 @@ 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_TYPE_STRING. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * * @param[in] formattable A handle to the formattable object * @param[in] string_to_copy The new string value to be set diff --git a/src/include/utils_i18n_measure_format.h b/src/include/utils_i18n_measure_format.h index 227da0c..154609e 100644 --- a/src/include/utils_i18n_measure_format.h +++ b/src/include/utils_i18n_measure_format.h @@ -46,7 +46,7 @@ extern "C" { /** * @deprecated Deprecated since 5.0. Use i18n_measure_format_create_from_locale_id() instead. * @brief Creates the measure format object using given locale. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The created object should be released by the caller with the * i18n_measure_format_destroy() function. * @@ -67,7 +67,7 @@ int i18n_measure_format_create(const char *language, /** * @brief Destroys the measure format object. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * * @param[in] measure_format The measure format object to destroy * @@ -79,7 +79,7 @@ int i18n_measure_format_destroy(i18n_measure_format_h measure_format); /** * @brief Creates a polymorphic clone of the given @a measure_format object. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The @a clone object should be released by the caller with the * i18n_measure_format_destroy() function. * @@ -95,7 +95,7 @@ int i18n_measure_format_clone(i18n_measure_format_h measure_format, i18n_format_ /** * @brief Formats an object to produce a string. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @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 @@ -121,7 +121,7 @@ int i18n_measure_format_format(i18n_measure_format_h measure_format, /** * @brief Parses a string to produce an object. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The obtained @a result object should be released by the caller * with the i18n_formattable_destroy() function. * @@ -148,7 +148,7 @@ int i18n_measure_format_parse_object(i18n_measure_format_h measure_format, /** * @deprecated Deprecated since 5.0. Use i18n_measure_format_create_currency_format_from_locale_id() instead. * @brief Gets a formatter for currency amount objects in the given locale. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The created object should be released by the caller with the * i18n_measure_format_destroy() function. * @@ -167,7 +167,7 @@ int i18n_measure_format_create_currency_format_from_locale(const char *language, /** * @brief Gets a formatter for currency amount objects in the default locale. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The created object should be released by the caller with the * i18n_measure_format_destroy() function. * diff --git a/src/include/utils_i18n_measure_unit.h b/src/include/utils_i18n_measure_unit.h index a655ad6..958c653 100644 --- a/src/include/utils_i18n_measure_unit.h +++ b/src/include/utils_i18n_measure_unit.h @@ -45,7 +45,7 @@ extern "C" { /** * @brief Creates the default measure unit object. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The created object should be released by the caller with the * #i18n_measure_unit_destroy() function. * @@ -60,7 +60,7 @@ int i18n_measure_unit_create(i18n_measure_unit_h *measure_unit); /** * @brief Creates a polymorphic clone of the given @a clone object. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The created object should be released by the caller with the * #i18n_measure_unit_destroy() function. * @@ -76,7 +76,7 @@ int i18n_measure_unit_clone(i18n_measure_unit_h measure_unit, i18n_measure_unit_ /** * @brief Destroys the measure unit object - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * * @param[in] measure_unit The measure unit object to destroy * @@ -88,7 +88,7 @@ int i18n_measure_unit_destroy(i18n_measure_unit_h measure_unit); /** * @brief Destroys the given array of the measure unit objects - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @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 @@ -101,7 +101,7 @@ int i18n_measure_unit_array_destroy(i18n_measure_unit_h *array, int32_t array_si /** * @brief Gets the measure unit object type. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @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 @@ -116,7 +116,7 @@ int i18n_measure_unit_get_type(i18n_measure_unit_h measure_unit, char **type); /** * @brief Gets the measure unit object sub type. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @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 @@ -136,7 +136,7 @@ int i18n_measure_unit_get_subtype(i18n_measure_unit_h measure_unit, char **subty * then the returned array is truncated to the first @a max_count units * and the returned error code is #I18N_ERROR_BUFFER_OVERFLOW. * - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @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. * @@ -159,7 +159,7 @@ int i18n_measure_unit_get_available(int32_t max_count, i18n_measure_unit_h **out * then the returned array is truncated to the first @a max_count units * and the returned error code is #I18N_ERROR_BUFFER_OVERFLOW. * - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @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. * @@ -179,7 +179,7 @@ int i18n_measure_unit_get_available_with_type(int32_t max_count, const char *typ /** * @brief Invokes the given callback function for every available measure unit type. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @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 @@ -192,7 +192,7 @@ int i18n_measure_unit_foreach_available_type(i18n_measure_unit_types_cb cb, void /** * @brief Gets unit of acceleration: g-force. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -207,7 +207,7 @@ int i18n_measure_unit_create_g_force(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of acceleration: meter-per-second-squared. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -222,7 +222,7 @@ int i18n_measure_unit_create_meter_per_second_squared(i18n_measure_unit_h *measu /** * @brief Gets unit of angle: arc-minute. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -237,7 +237,7 @@ int i18n_measure_unit_create_arc_minute(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of angle: arc-second. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -252,7 +252,7 @@ int i18n_measure_unit_create_arc_second(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of angle: degree. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -267,7 +267,7 @@ int i18n_measure_unit_create_degree(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of angle: radian. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -282,7 +282,7 @@ int i18n_measure_unit_create_radian(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of area: acre. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -297,7 +297,7 @@ int i18n_measure_unit_create_acre(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of area: hectare. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -312,7 +312,7 @@ int i18n_measure_unit_create_hectare(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit area: square-centimeter. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -327,7 +327,7 @@ int i18n_measure_unit_create_square_centimeter(i18n_measure_unit_h *measure_unit /** * @brief Gets unit area: square-foot. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -342,7 +342,7 @@ int i18n_measure_unit_create_square_foot(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit area: square-inch. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -357,7 +357,7 @@ int i18n_measure_unit_create_square_inch(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit area: square-kilometer. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -372,7 +372,7 @@ int i18n_measure_unit_create_square_kilometer(i18n_measure_unit_h *measure_unit) /** * @brief Gets unit area: square-meter. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -387,7 +387,7 @@ int i18n_measure_unit_create_square_meter(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit area: square-mile. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -402,7 +402,7 @@ int i18n_measure_unit_create_square_mile(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit area: square-yard. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -417,7 +417,7 @@ int i18n_measure_unit_create_square_yard(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of consumption: liter-per-kilometer. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -432,7 +432,7 @@ int i18n_measure_unit_create_liter_per_kilometer(i18n_measure_unit_h *measure_un /** * @brief Gets unit of consumption: mile-per-gallon. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -447,7 +447,7 @@ int i18n_measure_unit_create_mile_per_gallon(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of digital: bit. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -462,7 +462,7 @@ int i18n_measure_unit_create_bit(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of digital: byte. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -477,7 +477,7 @@ int i18n_measure_unit_create_byte(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of digital: gigabit. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -492,7 +492,7 @@ int i18n_measure_unit_create_gigabit(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of digital: gigabyte. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -507,7 +507,7 @@ int i18n_measure_unit_create_gigabyte(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of digital: kilobit. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -522,7 +522,7 @@ int i18n_measure_unit_create_kilobit(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of digital: kilobyte. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -537,7 +537,7 @@ int i18n_measure_unit_create_kilobyte(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of digital: megabit. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -552,7 +552,7 @@ int i18n_measure_unit_create_megabit(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of digital: megabyte. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -567,7 +567,7 @@ int i18n_measure_unit_create_megabyte(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of digital: terabit. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -582,7 +582,7 @@ int i18n_measure_unit_create_terabit(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of digital: terabyte. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -597,7 +597,7 @@ int i18n_measure_unit_create_terabyte(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of duration: day. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -612,7 +612,7 @@ int i18n_measure_unit_create_day(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of duration: hour. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -627,7 +627,7 @@ int i18n_measure_unit_create_hour(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of duration: microsecond. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -642,7 +642,7 @@ int i18n_measure_unit_create_microsecond(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of duration: millisecond. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -657,7 +657,7 @@ int i18n_measure_unit_create_millisecond(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of duration: minute. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -672,7 +672,7 @@ int i18n_measure_unit_create_minute(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of duration: month. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -687,7 +687,7 @@ int i18n_measure_unit_create_month(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of duration: nanosecond. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -702,7 +702,7 @@ int i18n_measure_unit_create_nanosecond(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of duration: second. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -717,7 +717,7 @@ int i18n_measure_unit_create_second(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of duration: week. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -732,7 +732,7 @@ int i18n_measure_unit_create_week(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of duration: year. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -747,7 +747,7 @@ int i18n_measure_unit_create_year(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of electric: ampere. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -762,7 +762,7 @@ int i18n_measure_unit_create_ampere(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of electric: milliampere. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -777,7 +777,7 @@ int i18n_measure_unit_create_milliampere(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of electric: ohm. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -792,7 +792,7 @@ int i18n_measure_unit_create_ohm(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of electric: volt. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -807,7 +807,7 @@ int i18n_measure_unit_create_volt(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of energy: calorie. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -822,7 +822,7 @@ int i18n_measure_unit_create_calorie(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of energy: foodcalorie. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -837,7 +837,7 @@ int i18n_measure_unit_create_foodcalorie(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of energy: joule. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -852,7 +852,7 @@ int i18n_measure_unit_create_joule(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of energy: kilocalorie. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -867,7 +867,7 @@ int i18n_measure_unit_create_kilocalorie(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of energy: kilojoule. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -882,7 +882,7 @@ int i18n_measure_unit_create_kilojoule(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of energy: kilowatt-hour. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -897,7 +897,7 @@ int i18n_measure_unit_create_kilowatt_hour(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of frequency: gigahertz. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -912,7 +912,7 @@ int i18n_measure_unit_create_gigahertz(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of frequency: hertz. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -927,7 +927,7 @@ int i18n_measure_unit_create_hertz(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of frequency: kilohertz. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -942,7 +942,7 @@ int i18n_measure_unit_create_kilohertz(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of frequency: megahertz. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -957,7 +957,7 @@ int i18n_measure_unit_create_megahertz(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of length: astronomical-unit. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -972,7 +972,7 @@ int i18n_measure_unit_create_astronomical_unit(i18n_measure_unit_h *measure_unit /** * @brief Gets unit of length: centimeter. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -987,7 +987,7 @@ int i18n_measure_unit_create_centimeter(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of length: decimeter. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -1002,7 +1002,7 @@ int i18n_measure_unit_create_decimeter(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of length: fathom. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -1017,7 +1017,7 @@ int i18n_measure_unit_create_fathom(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of length: foot. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -1032,7 +1032,7 @@ int i18n_measure_unit_create_foot(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of length: furlong. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -1047,7 +1047,7 @@ int i18n_measure_unit_create_furlong(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of length: inch. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -1062,7 +1062,7 @@ int i18n_measure_unit_create_inch(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of length: kilometer. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -1077,7 +1077,7 @@ int i18n_measure_unit_create_kilometer(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of length: light-year. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -1092,7 +1092,7 @@ int i18n_measure_unit_create_light_year(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of length: meter. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -1107,7 +1107,7 @@ int i18n_measure_unit_create_meter(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of length: micrometer. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -1122,7 +1122,7 @@ int i18n_measure_unit_create_micrometer(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of length: mile. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -1137,7 +1137,7 @@ int i18n_measure_unit_create_mile(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of length: millimeter. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -1152,7 +1152,7 @@ int i18n_measure_unit_create_millimeter(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of length: nanometer. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -1167,7 +1167,7 @@ int i18n_measure_unit_create_nanometer(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of length: nautical-mile. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -1182,7 +1182,7 @@ int i18n_measure_unit_create_nautical_mile(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of length: parsec. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -1197,7 +1197,7 @@ int i18n_measure_unit_create_parsec(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of length: picometer. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -1212,7 +1212,7 @@ int i18n_measure_unit_create_picometer(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of length: yard. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -1227,7 +1227,7 @@ int i18n_measure_unit_create_yard(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of illuminance: lux. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -1242,7 +1242,7 @@ int i18n_measure_unit_create_lux(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of mass: carat. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -1257,7 +1257,7 @@ int i18n_measure_unit_create_carat(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of mass: gram. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -1272,7 +1272,7 @@ int i18n_measure_unit_create_gram(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of mass: kilogram. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -1287,7 +1287,7 @@ int i18n_measure_unit_create_kilogram(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of mass: metric-ton. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -1302,7 +1302,7 @@ int i18n_measure_unit_create_metric_ton(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of mass: microgram. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -1317,7 +1317,7 @@ int i18n_measure_unit_create_microgram(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of mass: milligram. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -1332,7 +1332,7 @@ int i18n_measure_unit_create_milligram(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of mass: ounce. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -1347,7 +1347,7 @@ int i18n_measure_unit_create_ounce(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of mass: ounce-troy. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -1362,7 +1362,7 @@ int i18n_measure_unit_create_ounce_troy(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of mass: pound. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -1377,7 +1377,7 @@ int i18n_measure_unit_create_pound(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of mass: stone. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -1392,7 +1392,7 @@ int i18n_measure_unit_create_stone(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of mass: ton. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -1407,7 +1407,7 @@ int i18n_measure_unit_create_ton(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of power: gigawatt. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -1422,7 +1422,7 @@ int i18n_measure_unit_create_gigawatt(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of power: horsepower. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -1437,7 +1437,7 @@ int i18n_measure_unit_create_horsepower(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of power: kilowatt. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -1452,7 +1452,7 @@ int i18n_measure_unit_create_kilowatt(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of power: megawatt. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -1467,7 +1467,7 @@ int i18n_measure_unit_create_megawatt(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of power: milliwatt. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -1482,7 +1482,7 @@ int i18n_measure_unit_create_milliwatt(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of power: watt. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -1497,7 +1497,7 @@ int i18n_measure_unit_create_watt(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of pressure: hectopascal. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -1512,7 +1512,7 @@ int i18n_measure_unit_create_hectopascal(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of pressure: inch-hg. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -1527,7 +1527,7 @@ int i18n_measure_unit_create_inch_hg(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of pressure: millibar. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -1542,7 +1542,7 @@ int i18n_measure_unit_create_millibar(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of pressure: millimeter-of-mercury. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -1557,7 +1557,7 @@ int i18n_measure_unit_create_millimeter_of_mercury(i18n_measure_unit_h *measure_ /** * @brief Gets unit of pressure: pound-per-square-inch. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -1572,7 +1572,7 @@ int i18n_measure_unit_create_pound_per_square_inch(i18n_measure_unit_h *measure_ /** * @brief Gets unit of proportion: karat. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -1587,7 +1587,7 @@ int i18n_measure_unit_create_karat(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of speed: kilometer-per-hour. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -1602,7 +1602,7 @@ int i18n_measure_unit_create_kilometer_per_hour(i18n_measure_unit_h *measure_uni /** * @brief Gets unit of speed: meter-per-second. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -1617,7 +1617,7 @@ int i18n_measure_unit_create_meter_per_second(i18n_measure_unit_h *measure_unit) /** * @brief Gets unit of speed: mile-per-hour. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -1632,7 +1632,7 @@ int i18n_measure_unit_create_mile_per_hour(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of temperature: celsius. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -1647,7 +1647,7 @@ int i18n_measure_unit_create_celsius(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of temperature: fahrenheit. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -1662,7 +1662,7 @@ int i18n_measure_unit_create_fahrenheit(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of temperature: kelvin. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -1677,7 +1677,7 @@ int i18n_measure_unit_create_kelvin(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of volume: acre-foot. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -1692,7 +1692,7 @@ int i18n_measure_unit_create_acre_foot(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of volume: bushel. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -1707,7 +1707,7 @@ int i18n_measure_unit_create_bushel(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of volume: centiliter. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -1722,7 +1722,7 @@ int i18n_measure_unit_create_centiliter(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of volume: cubic-centimeter. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -1737,7 +1737,7 @@ int i18n_measure_unit_create_cubic_centimeter(i18n_measure_unit_h *measure_unit) /** * @brief Gets unit of volume: cubic-foot. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -1752,7 +1752,7 @@ int i18n_measure_unit_create_cubic_foot(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of volume: cubic-inch. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -1767,7 +1767,7 @@ int i18n_measure_unit_create_cubic_inch(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of volume: cubic-kilometer. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -1782,7 +1782,7 @@ int i18n_measure_unit_create_cubic_kilometer(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of volume: cubic-meter. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -1797,7 +1797,7 @@ int i18n_measure_unit_create_cubic_meter(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of volume: cubic-mile. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -1812,7 +1812,7 @@ int i18n_measure_unit_create_cubic_mile(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of volume: cubic-yard. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -1827,7 +1827,7 @@ int i18n_measure_unit_create_cubic_yard(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of volume: cup. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -1842,7 +1842,7 @@ int i18n_measure_unit_create_cup(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of volume: deciliter. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -1857,7 +1857,7 @@ int i18n_measure_unit_create_deciliter(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of volume: fluid-ounce. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -1872,7 +1872,7 @@ int i18n_measure_unit_create_fluid_ounce(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of volume: gallon. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -1887,7 +1887,7 @@ int i18n_measure_unit_create_gallon(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of volume: hectoliter. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -1902,7 +1902,7 @@ int i18n_measure_unit_create_hectoliter(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of volume: liter. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -1917,7 +1917,7 @@ int i18n_measure_unit_create_liter(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of volume: megaliter. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -1932,7 +1932,7 @@ int i18n_measure_unit_create_megaliter(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of volume: milliliter. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -1947,7 +1947,7 @@ int i18n_measure_unit_create_milliliter(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of volume: pint. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -1962,7 +1962,7 @@ int i18n_measure_unit_create_pint(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of volume: quart. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -1977,7 +1977,7 @@ int i18n_measure_unit_create_quart(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of volume: tablespoon. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * @@ -1992,7 +1992,7 @@ int i18n_measure_unit_create_tablespoon(i18n_measure_unit_h *measure_unit); /** * @brief Gets unit of volume: teaspoon. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The returned @a measure_unit should be freed by the caller * with i18n_measure_unit_destroy(). * diff --git a/src/include/utils_i18n_parse_position.h b/src/include/utils_i18n_parse_position.h index 50d0fce..994efe8 100644 --- a/src/include/utils_i18n_parse_position.h +++ b/src/include/utils_i18n_parse_position.h @@ -50,7 +50,7 @@ extern "C" { /** * @brief Creates a parse position object. * @details The index is set to position 0. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The created object should be released by the caller with the * i18n_parse_position_destroy() function. * @@ -65,7 +65,7 @@ int i18n_parse_position_create(i18n_parse_position_h *parse_position); /** * @brief Creates a parse position object with the given initial index. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The created object should be released by the caller with the * i18n_parse_position_destroy() function. * @@ -81,7 +81,7 @@ int i18n_parse_position_create_with_index(int32_t new_index, i18n_parse_position /** * @brief Destroys the parse position object. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * * @param[in] parse_position The parse position object to destroy * @@ -93,7 +93,7 @@ int i18n_parse_position_destroy(i18n_parse_position_h parse_position); /** * @brief Creates a clone of the given @a parse_position object. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * @remarks The @a clone object should be released by the caller with the * i18n_parse_position_destroy() function. * @@ -112,7 +112,7 @@ int i18n_parse_position_clone(i18n_parse_position_h parse_position, i18n_parse_p * @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 @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * * @param[in] parse_position The parse position object * @param[out] index The current index @@ -125,7 +125,7 @@ int i18n_parse_position_get_index(i18n_parse_position_h parse_position, int32_t /** * @brief Sets the current parse position. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * * @param[in] parse_position The parse position object * @param[in] index The new index @@ -141,7 +141,7 @@ int i18n_parse_position_set_index(i18n_parse_position_h parse_position, int32_t * @details Formatters should set this before returning an error code * from their parse_object() function. The default value is -1 * if this is not set. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * * @param[in] parse_position The parse position object * @param[in] error_index The error index @@ -155,7 +155,7 @@ int i18n_parse_position_set_error_index(i18n_parse_position_h parse_position, in /** * @brief Retrieves the index at which an error occurred, or -1 if the error index * has not been set. - * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif + * @since_tizen 2.3.2 * * @param[in] parse_position The parse position object * @param[out] error_index The index at which an error occurred diff --git a/src/include/utils_i18n_timezone.h b/src/include/utils_i18n_timezone.h index d22a341..a20fcd9 100644 --- a/src/include/utils_i18n_timezone.h +++ b/src/include/utils_i18n_timezone.h @@ -62,7 +62,7 @@ extern "C" { /** * @brief Returns the "unknown" time zone. * @details #i18n_timezone_create() returns a mutable clone of this time zone if the input ID is not recognized. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[out] timezone the "unknown" time zone. * @@ -76,7 +76,7 @@ int i18n_timezone_create_unknown(i18n_timezone_h *timezone); * @brief The GMT (=UTC) time zone has a raw offset of zero and does not use daylight savings time. * @details This is a commonly used time zone.\n * Note: For backward compatibility reason, the ID used by the time zone returned by this method is "GMT", although the I18N's canonical ID for the GMT time zone is "Etc/GMT". - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[out] timezone the GMT/UTC time zone. * @@ -87,7 +87,7 @@ int i18n_timezone_create_gmt(i18n_timezone_h *timezone); /** * @brief Creates an i18n_timezone_h for the given timezone_id. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[out] timezone the GMT/UTC time zone. * @param[in] timezone_id the ID for an i18n_timezone_h, such as "America/Los_Angeles", or a custom ID such as "GMT-8:00". @@ -99,7 +99,7 @@ int i18n_timezone_create(i18n_timezone_h *timezone, const char *timezone_id); /** * @brief Destroys an i18n_timezone_h. * @details Once destroyed, an i18n_timezone_h may no longer be used. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[in] timezone The i18n_timezone_h to destroy. * @@ -109,7 +109,7 @@ int i18n_timezone_destroy(i18n_timezone_h timezone); /** * @brief Returns an enumeration over system time zone IDs with the given filter conditions. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[in] timezone_type The system time zone type. * @param[in] region The ISO 3166 two-letter country code or UN M.49 three-digit area code. When NULL, no filtering done by region. @@ -124,7 +124,7 @@ int i18n_timezone_foreach_timezone_id_by_region(i18n_system_timezone_type_e time /** * @brief Returns an enumeration over all recognized time zone IDs. * (i.e., all strings that #i18n_timezone_create() accepts) - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[in] cb The callback function to get an enumeration object, owned by the caller. * @param[in] user_data The user data to be passed to the callback function. @@ -142,7 +142,7 @@ int i18n_timezone_foreach_timezone_id(i18n_timezone_id_cb cb, void *user_data); * which corresponds to Mountain Standard Time in the winter and Mountain Daylight Time in the summer, * and "America/Phoenix", which corresponds to Mountain Standard Time year-round, even in the summer. * - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[in] raw_offset an offset from GMT in milliseconds, ignoring the effect of daylight savings time, if any * @param[in] cb The callback function to get an enumeration object, owned by the caller. @@ -155,7 +155,7 @@ int i18n_timezone_foreach_timezone_id_with_offset(int32_t raw_offset, i18n_timez /** * @brief Returns an enumeration over time zone IDs associated with the given country. * @details Some zones are affiliated with no country (e.g., "UTC"); these may also be retrieved, as a group. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[in] country The ISO 3166 two-letter country code, or NULL to retrieve zones not affiliated with any country. * @param[in] cb The callback function to get an enumeration object, owned by the caller. @@ -169,7 +169,7 @@ int i18n_timezone_foreach_timezone_id_by_country(const char *country, i18n_timez * @brief Returns the number of IDs in the equivalency group that includes the given ID. * @details An equivalency group contains zones that have the same GMT offset and rules.\n * The returned count includes the given ID; it is always >= 1. The given ID must be a system time zone. If it is not, returns zero. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[in] timezone_id a system time zone ID * @param[out] count the number of zones in the equivalency group containing 'timezone_id', or zero if 'timezone_id' is not a valid system ID @@ -187,7 +187,7 @@ int i18n_timezone_count_equivalent_ids(const char *timezone_id, int32_t *count); * For some value of 'index', the returned value will be equal to the given id. * If the given id is not a valid system time zone, * or if 'index' is out of range, then returns an empty string. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[in] timezone_id a system time zone ID * @param[in] index a value from 0 to n-1, where n is the out parameter value from i18n_timezone_count_equivalent_ids(timezone_id, &n) @@ -212,7 +212,7 @@ int i18n_timezone_get_equivalent_id(const char *timezone_id, int32_t index, char * * To query the system for the current timezone, use i18n_timezone_detect_host_timezone(). * - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[out] timezone A default i18n_timezone_h. Clients are responsible for deleting the time zone object returned. * @@ -227,7 +227,7 @@ int i18n_timezone_create_default(i18n_timezone_h *timezone); * This function is not thread safe. It is an error for multiple threads to concurrently attempt to set * the default time zone, or for any thread to attempt to reference the default zone while another thread is setting it. * - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * @remarks Do not use unless you know what you are doing. * * @param[in] timezone The given timezone. @@ -240,7 +240,7 @@ int i18n_timezone_set_default(i18n_timezone_h timezone); * @brief Returns the timezone data version currently used by I18N. * @remarks The specific error code can be obtained using the get_last_result() * method. Error codes are described in #i18n_error_code_e description. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @return the version string, such as "2007f" * @exception #I18N_ERROR_NONE Successful @@ -252,7 +252,7 @@ const char *i18n_timezone_get_tzdata_version(void); * @details The region code is either ISO 3166 2-letter country code or UN M.49 3-digit area code. * When the time zone is not associated with a specific location, for example - "Etc/UTC", * "EST5EDT", then this method returns "001" (UN M.49 area code for World). - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[in] timezone_id The system time zone ID. * @param[out] region Output buffer for receiving the region code. @@ -268,7 +268,7 @@ int i18n_timezone_get_region(const char *timezone_id, char *region, int32_t *reg * @brief Returns the time zone raw and GMT offset for the given moment in time. * @details Upon return, local-millis = GMT-millis + rawOffset + dstOffset. All computations are performed * in the proleptic Gregorian calendar. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[in] timezone The i18n_timezone_h to get an offset. * @param[in] date moment in time for which to return offsets, in units of milliseconds from January 1, 1970 0:00 GMT, either GMT time or local wall time, depending on `local'. @@ -283,7 +283,7 @@ int i18n_timezone_get_offset_with_date(i18n_timezone_h timezone, i18n_udate date /** * @brief Sets the i18n_timezone_h's raw GMT offset * (i.e., the number of milliseconds to add to GMT to get local time, before taking daylight savings time into account). - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[in] timezone The i18n_timezone_h to set a raw offset. * @param[in] offset_milliseconds The new raw GMT offset for this time zone. @@ -295,7 +295,7 @@ int i18n_timezone_set_raw_offset(i18n_timezone_h timezone, int32_t offset_millis /** * @brief Gets the i18n_timezone_h's raw GMT offset (i.e., the number of milliseconds * to add to GMT to get local time, before taking daylight savings time into account). - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[in] timezone The i18n_timezone_h to get a raw offset. * @param[out] offset_milliseconds The i18n_timezone_h's raw GMT offset. @@ -306,7 +306,7 @@ int i18n_timezone_get_raw_offset(i18n_timezone_h timezone, int32_t *offset_milli /** * @brief Fills in "timezone_id" with the i18n_timezone_h's ID. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[in] timezone The i18n_timezone_h to get a timezone ID. * @param[out] timezone_id Receives this i18n_timezone_h's ID. @@ -325,7 +325,7 @@ int i18n_timezone_get_id(i18n_timezone_h timezone, char **timezone_id); * \n * the timezone's GMT offset and daylight-savings rules don't change to those for Los Angeles. * They're still those for New York. Only the ID has changed. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[in] timezone The i18n_timezone_h to set a timezone ID. * @param[in] timezone_id The new time zone ID. @@ -338,7 +338,7 @@ int i18n_timezone_set_id(i18n_timezone_h timezone, const char *timezone_id); * @brief Returns a name of this time zone suitable for presentation to the user in the default locale. * @details This method returns the long name, not including daylight savings. * If the display name is not available for the locale, then this method returns a string in the localized GMT offset format such as GMT[+-]HH:mm. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[in] timezone The i18n_timezone_h to get a display name. * @param[out] display_name The human-readable name of this time zone in the default locale. @@ -352,7 +352,7 @@ int i18n_timezone_get_display_name(i18n_timezone_h timezone, char **display_name * @brief Returns a name of this time zone suitable for presentation to the user in the default locale. * @details This method returns the long name, not including daylight savings. * If the display name is not available for the locale, then this method returns a string in the localized GMT offset format such as GMT[+-]HH:mm. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[in] timezone The i18n_timezone_h to get a display name. * @param[in] language The language in which to supply the display name. This parameter can be NULL; if so, the locale is initialized to match the current default locale. @@ -367,7 +367,7 @@ int i18n_timezone_get_display_name_with_locale(i18n_timezone_h timezone, const c * @brief Returns a name of this time zone suitable for presentation to the user in the default locale. * @details If the display name is not available for the locale, * then this method returns a string in the localized GMT offset format such as GMT[+-]HH:mm. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[in] timezone The i18n_timezone_h to get a display name. * @param[in] daylight If true, display_name is filled with the daylight savings name. @@ -383,7 +383,7 @@ int i18n_timezone_get_display_name_with_type(i18n_timezone_h timezone, i18n_uboo * @brief Returns a name of this time zone suitable for presentation to the user in the default locale. * @details If the display name is not available for the locale, * then this method returns a string in the localized GMT offset format such as GMT[+-]HH:mm. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[in] timezone The i18n_timezone_h to get a display name. * @param[in] daylight If true, display_name is filled with the daylight savings name. @@ -398,7 +398,7 @@ int i18n_timezone_get_display_name_with_type_locale(i18n_timezone_h timezone, i1 /** * @brief Queries if this time zone uses daylight savings time. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[in] timezone The i18n_timezone_h to know whether uses daylight savings time or not. * @param[out] daylight_time True if this time zone uses daylight savings time, False, otherwise. @@ -410,7 +410,7 @@ int i18n_timezone_use_daylight_time(i18n_timezone_h timezone, i18n_ubool *daylig /** * @brief Returns true if this zone has the same rule and offset as another zone. * @details That is, if this zone differs only in ID, if at all. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[in] timezone The i18n_timezone_h to know whether has the same rule or not. * @param[in] other The i18n_timezone_h to be compared with. @@ -423,7 +423,7 @@ int i18n_timezone_has_same_rule(i18n_timezone_h timezone, i18n_timezone_h other, /** * @brief Clones i18n_timezone_h polymorphically. * @details Clients are responsible for deleting the i18n_timezone_h cloned. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[in] timezone The i18n_timezone_h to clone. * @param[out] clone A new copy of this i18n_timezone_h. @@ -438,7 +438,7 @@ int i18n_timezone_clone(i18n_timezone_h timezone, i18n_timezone_h *clone); * Otherwise, 0 (zero) is returned.\n * If an underlying TimeZone implementation subclass supports historical Daylight Saving Time changes, * this method returns the known latest daylight saving value. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[in] timezone The i18n_timezone_h to get DST savings. * @param[out] dst_savings The amount of saving time in milliseconds. diff --git a/src/include/utils_i18n_types.h b/src/include/utils_i18n_types.h index c5cc0c8..27ccf92 100644 --- a/src/include/utils_i18n_types.h +++ b/src/include/utils_i18n_types.h @@ -40,7 +40,7 @@ extern "C" { /** * @brief Enumeration for error codes to replace exception handlings. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 */ typedef enum { I18N_ERROR_NONE = TIZEN_ERROR_NONE, /**< No error, no warning */ @@ -61,29 +61,29 @@ typedef enum { I18N_ERROR_INVALID_PARAMETER = TIZEN_ERROR_INVALID_PARAMETER, /**< Invalid function parameter */ I18N_ERROR_PERMISSION_DENIED = TIZEN_ERROR_PERMISSION_DENIED, /**< Permission denied */ - I18N_ERROR_MESSAGE_PARSE = TIZEN_ERROR_UTILITY_ICU | 0x0D, /**< Unable to parse a message (message format). @if MOBILE (Since 2.3.1) @endif*/ - I18N_ERROR_PARSE = TIZEN_ERROR_UTILITY_ICU | 0x0E, /**< Equivalent to Java ParseException. @if MOBILE (Since 2.3.1) @endif*/ - I18N_ERROR_TRUNCATED_CHAR_FOUND = TIZEN_ERROR_UTILITY_ICU | 0x0F, /**< Character conversion: Incomplete input sequence. @if MOBILE (Since 2.3.1) @endif*/ - 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 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*/ - I18N_ERROR_PRIMARY_TOO_LONG = TIZEN_ERROR_UTILITY_ICU | 0x17, /**< User tried to set variable top to a primary that is longer than two bytes. @if MOBILE (Since 2.3.1) @endif*/ - I18N_ERROR_STATE_TOO_OLD = TIZEN_ERROR_UTILITY_ICU | 0x18, /**< ICU cannot construct a service from this state, as it is no longer supported. @if MOBILE (Since 2.3.1) @endif*/ - I18N_ERROR_ENUM_OUT_OF_SYNC = TIZEN_ERROR_UTILITY_ICU | 0x19, /**< UEnumeration out of sync with underlying collection. @if MOBILE (Since 2.3.1) @endif*/ - I18N_ERROR_INVARIANT_CONVERSION = TIZEN_ERROR_UTILITY_ICU | 0x1A, /**< Unable to convert a UChar* string to char* with the invariant converter. @if MOBILE (Since 2.3.1) @endif*/ - I18N_ERROR_INVALID_STATE = TIZEN_ERROR_UTILITY_ICU | 0x1B, /**< Requested operation can not be completed with ICU in its current state. @if MOBILE (Since 2.3.1) @endif*/ - I18N_ERROR_MALFORMED_SET = TIZEN_ERROR_UTILITY_ICU | 0x1C, /**< A UnicodeSet pattern is invalid. @if MOBILE (Since 2.3.1) @endif*/ - I18N_WARNING_STRING_NOT_TERMINATED = TIZEN_ERROR_UTILITY_ICU | 0x1D, /**< String not terminated with NULL. @if MOBILE (Since 2.3.1) @endif*/ - I18N_ERROR_STD3_ASCII_RULES = TIZEN_ERROR_UTILITY_ICU | 0x1E, /**< Argument does not satisfy STD3 rules. @if MOBILE (Since 2.3.1) @endif*/ - I18N_ERROR_UNASSIGNED = TIZEN_ERROR_UTILITY_ICU | 0x1F, /**< Unassigned code points are found. @if MOBILE (Since 2.3.1) @endif*/ - I18N_WARNING_SORT_KEY_TOO_SHORT = TIZEN_ERROR_UTILITY_ICU | 0x20, /**< Number of levels requested in getBound is higher than the number of levels in the sort key. @if MOBILE (Since 2.3.1) @endif*/ + I18N_ERROR_MESSAGE_PARSE = TIZEN_ERROR_UTILITY_ICU | 0x0D, /**< Unable to parse a message (message format). (Since 2.3.1)*/ + I18N_ERROR_PARSE = TIZEN_ERROR_UTILITY_ICU | 0x0E, /**< Equivalent to Java ParseException. (Since 2.3.1)*/ + I18N_ERROR_TRUNCATED_CHAR_FOUND = TIZEN_ERROR_UTILITY_ICU | 0x0F, /**< Character conversion: Incomplete input sequence. (Since 2.3.1)*/ + I18N_ERROR_ILLEGAL_CHAR_FOUND = TIZEN_ERROR_UTILITY_ICU | 0x10, /**< Character conversion: Illegal input sequence/combination of input units. (Since 2.3.1)*/ + I18N_ERROR_INVALID_TABLE_FORMAT = TIZEN_ERROR_UTILITY_ICU | 0x11, /**< Conversion table file found, but corrupted. (Since 2.3.1)*/ + I18N_ERROR_INVALID_TABLE_FILE = TIZEN_ERROR_UTILITY_ICU | 0x12, /**< Conversion table file not found. (Since 2.3.1)*/ + I18N_ERROR_ILLECAL_ESCAPE_SEQUENCE = TIZEN_ERROR_UTILITY_ICU | 0x13, /**< ISO-2022 illegal escape sequence. (Since 2.3.1)*/ + I18N_ERROR_UNSUPPORTED_ESCAPE_SEQUENCE = TIZEN_ERROR_UTILITY_ICU | 0x14, /**< ISO-2022 unsupported escape sequence. (Since 2.3.1)*/ + I18N_ERROR_NO_SPACE_AVAILABLE = TIZEN_ERROR_UTILITY_ICU | 0x15, /**< No space available for in-buffer expansion for Arabic shaping. (Since 2.3.1)*/ + I18N_ERROR_CE_NOT_FOUND = TIZEN_ERROR_UTILITY_ICU | 0x16, /**< Currently used only while setting variable top, but can be used generally. (Since 2.3.1)*/ + I18N_ERROR_PRIMARY_TOO_LONG = TIZEN_ERROR_UTILITY_ICU | 0x17, /**< User tried to set variable top to a primary that is longer than two bytes. (Since 2.3.1)*/ + I18N_ERROR_STATE_TOO_OLD = TIZEN_ERROR_UTILITY_ICU | 0x18, /**< ICU cannot construct a service from this state, as it is no longer supported. (Since 2.3.1)*/ + I18N_ERROR_ENUM_OUT_OF_SYNC = TIZEN_ERROR_UTILITY_ICU | 0x19, /**< UEnumeration out of sync with underlying collection. (Since 2.3.1)*/ + I18N_ERROR_INVARIANT_CONVERSION = TIZEN_ERROR_UTILITY_ICU | 0x1A, /**< Unable to convert a UChar* string to char* with the invariant converter. (Since 2.3.1)*/ + I18N_ERROR_INVALID_STATE = TIZEN_ERROR_UTILITY_ICU | 0x1B, /**< Requested operation can not be completed with ICU in its current state. (Since 2.3.1)*/ + I18N_ERROR_MALFORMED_SET = TIZEN_ERROR_UTILITY_ICU | 0x1C, /**< A UnicodeSet pattern is invalid. (Since 2.3.1)*/ + I18N_WARNING_STRING_NOT_TERMINATED = TIZEN_ERROR_UTILITY_ICU | 0x1D, /**< String not terminated with NULL. (Since 2.3.1)*/ + I18N_ERROR_STD3_ASCII_RULES = TIZEN_ERROR_UTILITY_ICU | 0x1E, /**< Argument does not satisfy STD3 rules. (Since 2.3.1)*/ + I18N_ERROR_UNASSIGNED = TIZEN_ERROR_UTILITY_ICU | 0x1F, /**< Unassigned code points are found. (Since 2.3.1)*/ + I18N_WARNING_SORT_KEY_TOO_SHORT = TIZEN_ERROR_UTILITY_ICU | 0x20, /**< Number of levels requested in getBound is higher than the number of levels in the sort key. (Since 2.3.1)*/ I18N_WARNING_USING_FALLBACK = TIZEN_ERROR_UTILITY_ICU | 0x21, /**< A resource bundle lookup returned a fallback result (not an error) (Since 6.0)*/ I18N_WARNING_USING_DEFAULT = TIZEN_ERROR_UTILITY_ICU | 0x22, /**< A resource bundle lookup returned a result from the root locale (not an error) (Since 6.0)*/ - I18N_ERROR_UNKNOWN = TIZEN_ERROR_UNKNOWN, /**< Unknown error. @if MOBILE (Since 2.3.1) @endif*/ + I18N_ERROR_UNKNOWN = TIZEN_ERROR_UNKNOWN, /**< Unknown error. (Since 2.3.1)*/ /** Errors connected with transliteration text from one format to another */ I18N_ERROR_BAD_VARIABLE_DEFINITION = TIZEN_ERROR_UTILITY_ICU | 0x1000, /**< Missing '$' or duplicate variable name. (Since 5.0)*/ @@ -172,54 +172,54 @@ i18n_error_code_e; * @{ */ -#define I18N_U_MASK(x) ((uint32_t)1 << (x)) /**< Get a single-bit bit set (a flag) from a bit number 0..31. @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif*/ - -#define I18N_U_GC_CN_MASK I18N_U_MASK(I18N_UCHAR_U_GENERAL_OTHER_TYPES) /**< U_GC_XX_MASK constants are bit flags corresponding to Unicode general category values. @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif*/ -#define I18N_U_GC_LU_MASK I18N_U_MASK(I18N_UCHAR_U_UPPERCASE_LETTER) /**< Mask constant for a #i18n_uchar_category_e. @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif*/ -#define I18N_U_GC_LL_MASK I18N_U_MASK(I18N_UCHAR_U_LOWERCASE_LETTER) /**< Mask constant for a #i18n_uchar_category_e. @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif*/ -#define I18N_U_GC_LT_MASK I18N_U_MASK(I18N_UCHAR_U_TITLECASE_LETTER) /**< Mask constant for a #i18n_uchar_category_e. @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif*/ -#define I18N_U_GC_LM_MASK I18N_U_MASK(I18N_UCHAR_U_MODIFIER_LETTER) /**< Mask constant for a #i18n_uchar_category_e. @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif*/ -#define I18N_U_GC_LO_MASK I18N_U_MASK(I18N_UCHAR_U_OTHER_LETTER) /**< Mask constant for a #i18n_uchar_category_e. @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif*/ -#define I18N_U_GC_MN_MASK I18N_U_MASK(I18N_UCHAR_U_NON_SPACING_MARK) /**< Mask constant for a #i18n_uchar_category_e. @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif*/ -#define I18N_U_GC_ME_MASK I18N_U_MASK(I18N_UCHAR_U_ENCLOSING_MARK) /**< Mask constant for a #i18n_uchar_category_e. @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif*/ -#define I18N_U_GC_MC_MASK I18N_U_MASK(I18N_UCHAR_U_COMBINING_SPACING_MARK) /**< Mask constant for a #i18n_uchar_category_e. @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif*/ -#define I18N_U_GC_ND_MASK I18N_U_MASK(I18N_UCHAR_U_DECIMAL_DIGIT_NUMBER) /**< Mask constant for a #i18n_uchar_category_e. @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif*/ -#define I18N_U_GC_NL_MASK I18N_U_MASK(I18N_UCHAR_U_LETTER_NUMBER) /**< Mask constant for a #i18n_uchar_category_e. @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif*/ -#define I18N_U_GC_NO_MASK I18N_U_MASK(I18N_UCHAR_U_OTHER_NUMBER) /**< Mask constant for a #i18n_uchar_category_e. @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif*/ -#define I18N_U_GC_ZS_MASK I18N_U_MASK(I18N_UCHAR_U_SPACE_SEPARATOR) /**< Mask constant for a #i18n_uchar_category_e. @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif*/ -#define I18N_U_GC_ZL_MASK I18N_U_MASK(I18N_UCHAR_U_LINE_SEPARATOR) /**< Mask constant for a #i18n_uchar_category_e. @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif*/ -#define I18N_U_GC_ZP_MASK I18N_U_MASK(I18N_UCHAR_U_PARAGRAPH_SEPARATOR) /**< Mask constant for a #i18n_uchar_category_e. @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif*/ -#define I18N_U_GC_CC_MASK I18N_U_MASK(I18N_UCHAR_U_CONTROL_CHAR) /**< Mask constant for a #i18n_uchar_category_e. @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif*/ -#define I18N_U_GC_CF_MASK I18N_U_MASK(I18N_UCHAR_U_FORMAT_CHAR) /**< Mask constant for a #i18n_uchar_category_e. @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif*/ -#define I18N_U_GC_CO_MASK I18N_U_MASK(I18N_UCHAR_U_PRIVATE_USE_CHAR) /**< Mask constant for a #i18n_uchar_category_e. @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif*/ -#define I18N_U_GC_CS_MASK I18N_U_MASK(I18N_UCHAR_U_SURROGATE) /**< Mask constant for a #i18n_uchar_category_e. @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif*/ -#define I18N_U_GC_PD_MASK I18N_U_MASK(I18N_UCHAR_U_DASH_PUNCTUATION) /**< Mask constant for a #i18n_uchar_category_e. @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif*/ -#define I18N_U_GC_PS_MASK I18N_U_MASK(I18N_UCHAR_U_START_PUNCTUATION) /**< Mask constant for a #i18n_uchar_category_e. @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif*/ -#define I18N_U_GC_PE_MASK I18N_U_MASK(I18N_UCHAR_U_END_PUNCTUATION) /**< Mask constant for a #i18n_uchar_category_e. @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif*/ -#define I18N_U_GC_PC_MASK I18N_U_MASK(I18N_UCHAR_U_CONNECTOR_PUNCTUATION) /**< Mask constant for a #i18n_uchar_category_e. @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif*/ -#define I18N_U_GC_PO_MASK I18N_U_MASK(I18N_UCHAR_U_OTHER_PUNCTUATION) /**< Mask constant for a #i18n_uchar_category_e. @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif*/ -#define I18N_U_GC_SM_MASK I18N_U_MASK(I18N_UCHAR_U_MATH_SYMBOL) /**< Mask constant for a #i18n_uchar_category_e. @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif*/ -#define I18N_U_GC_SC_MASK I18N_U_MASK(I18N_UCHAR_U_CURRENCY_SYMBOL) /**< Mask constant for a #i18n_uchar_category_e. @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif*/ -#define I18N_U_GC_SK_MASK I18N_U_MASK(I18N_UCHAR_U_MODIFIER_SYMBOL) /**< Mask constant for a #i18n_uchar_category_e. @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif*/ -#define I18N_U_GC_SO_MASK I18N_U_MASK(I18N_UCHAR_U_OTHER_SYMBOL) /**< Mask constant for a #i18n_uchar_category_e. @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif*/ -#define I18N_U_GC_PI_MASK I18N_U_MASK(I18N_UCHAR_U_INITIAL_PUNCTUATION) /**< Mask constant for a #i18n_uchar_category_e. @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif*/ -#define I18N_U_GC_PF_MASK I18N_U_MASK(I18N_UCHAR_U_FINAL_PUNCTUATION) /**< Mask constant for a #i18n_uchar_category_e. @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif*/ -#define I18N_U_GC_L_MASK (I18N_U_GC_LU_MASK|I18N_U_GC_LL_MASK|I18N_U_GC_LT_MASK|I18N_U_GC_LM_MASK|I18N_U_GC_LO_MASK) /**= 59 #if defined(U_COMBINED_IMPLEMENTATION) || defined(U_COMMON_IMPLEMENTATION) || \ @@ -299,13 +299,13 @@ typedef uint16_t i18n_uchar; /** * @brief i18n_uchar32. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 */ typedef int32_t i18n_uchar32; /** * @brief i18n_ubool. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 */ typedef int8_t i18n_ubool; @@ -316,7 +316,7 @@ typedef int8_t i18n_ubool; * For details about the properties see http://www.unicode.org/ucd/ . * For names of Unicode properties see the UCD file PropertyAliases.txt. * - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 */ typedef enum { I18N_UCHAR_ALPHABETIC = 0, @@ -697,7 +697,7 @@ typedef enum { /** * @brief Constants for Unicode blocks, see the Unicode Data file Blocks.txt. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * */ typedef enum { @@ -984,7 +984,7 @@ typedef enum { /** * @brief Enumeration for the language directional property of a character set. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 */ typedef enum { I18N_UCHAR_U_LEFT_TO_RIGHT, /**< L */ @@ -1015,7 +1015,7 @@ typedef enum { /** * @brief Enumeration for Decomposition Type constants. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 */ typedef enum { I18N_UCHAR_U_DT_NONE, /**< [none] */ @@ -1041,7 +1041,7 @@ typedef enum { /** * @brief Enumeration for East Asian Width constants. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 */ typedef enum { I18N_UCHAR_U_EA_NEUTRAL, /**< [N] */ @@ -1055,7 +1055,7 @@ typedef enum { /** * @brief Enumeration for Unicode general category types. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 */ typedef enum { I18N_UCHAR_U_UNASSIGNED, /**< Non-category for unassigned and non-character code points */ @@ -1094,7 +1094,7 @@ typedef enum { /** * @brief Enumeration for Joining Group constants. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 */ typedef enum { I18N_UCHAR_U_JG_NO_JOINING_GROUP, /**< No Joining Group */ @@ -1192,7 +1192,7 @@ typedef enum { /** * @brief Enumeration for Joining Type constants. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 */ typedef enum { I18N_UCHAR_U_JT_NON_JOINING, /**< [U] */ @@ -1206,7 +1206,7 @@ typedef enum { /** * @brief Enumeration for Line Break constants. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 */ typedef enum { I18N_UCHAR_U_LB_UNKNOWN, /**< [XX] */ @@ -1258,7 +1258,7 @@ typedef enum { /** * @brief Enumeration for Numeric Type constants. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 */ typedef enum { I18N_UCHAR_U_NT_NONE, /**< [None] */ @@ -1270,7 +1270,7 @@ typedef enum { /** * @brief Enumeration for Hangul Syllable Type constants. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 */ typedef enum { I18N_UCHAR_U_HST_NOT_APPLICABLE, /**< [NA] */ @@ -1284,7 +1284,7 @@ typedef enum { /** * @brief Enumeration for Sentence Break constants. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 */ typedef enum { I18N_UCHAR_U_SB_OTHER, /**< [XX] */ @@ -1307,7 +1307,7 @@ typedef enum { /** * @brief Enumeration for Word Break constants. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 */ typedef enum { I18N_UCHAR_U_WB_OTHER, /**< [XX] */ @@ -1337,7 +1337,7 @@ typedef enum { /** * @brief Enumeration for Grapheme Cluster Break constants. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 */ typedef enum { I18N_UCHAR_U_GCB_OTHER, /**< [XX] */ @@ -1432,14 +1432,14 @@ typedef i18n_ubool (*i18n_uchar_enum_char_name_cb)(void *context, /** * @brief Structure representing a collator object instance. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 */ typedef void *i18n_ucollator_h; /** * @brief Enumeration for attributes that collation service understands. * All the attributes can take #I18N_UCOLLATOR_DEFAULT value, as well as the values specific to each one. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 */ typedef enum { I18N_UCOLLATOR_FRENCH_COLLATION, /**< Attribute for direction of secondary weights - used in Canadian French. Acceptable values are #I18N_UCOLLATOR_ON, which results in secondary weights being considered backwards, and #I18N_UCOLLATOR_OFF which treats secondary weights in the order they appear */ @@ -1457,7 +1457,7 @@ typedef enum { * @brief Enumeration containing attribute values for controlling collation behavior. * Here are all the allowable values. Not every attribute can take every value. * The only universal value is #I18N_UCOLLATOR_DEFAULT, which resets the attribute value to the predefined value for that locale. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 */ typedef enum { I18N_UCOLLATOR_DEFAULT = -1, /**< Accepted by most attributes */ @@ -1486,7 +1486,7 @@ typedef enum { * Uppercase and lowercase versions of the same character represent a tertiary difference. Set comparison level to #I18N_UCOLLATOR_TERTIARY to include all comparison differences. Use this to set the strength of an #i18n_ucollator_h. Example of tertiary difference, "abc" <<< "ABC". * Two characters are considered "identical" when they have the same unicode spellings. #I18N_UCOLLATOR_IDENTICAL. For example, "ä" == "ä". * #i18n_ucollator_strength_e is also used to determine the strength of sort keys generated from #i18n_ucollator_h. These values can now be found in the #i18n_ucollator_attribute_value_e enum. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 */ typedef i18n_ucollator_attribute_value_e i18n_ucollator_strength_e; @@ -1495,7 +1495,7 @@ typedef i18n_ucollator_attribute_value_e i18n_ucollator_strength_e; * #I18N_UCOLLATOR_LESS is returned if the source string is compared to be less than the target string in the {@link i18n_ucollator_str_collator() } method. * #I18N_UCOLLATOR_EQUAL is returned if the source string is compared to be equal to the target string in the {@link i18n_ucollator_str_collator() } method. * #I18N_UCOLLATOR_GREATER is returned if the source string is compared to be greater than the target string in the {@link #i18n_ucollator_str_collator() } method. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 */ typedef enum { I18N_UCOLLATOR_EQUAL = 0, /**< string a == string b */ @@ -1561,7 +1561,7 @@ typedef enum { /** * @brief i18n_unormalizer_h. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * */ @@ -1570,7 +1570,7 @@ typedef const void *i18n_unormalizer_h; /** * @brief Enumeration of constants for normalization modes. * For details about standard Unicode normalization forms and about the algorithms which are also used with custom mapping tables see http://www.unicode.org/reports/tr15/ - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 */ typedef enum { I18N_UNORMALIZATION_COMPOSE, /**< Decomposition followed by composition. Same as standard NFC when using an "nfc" instance. Same as standard NFKC when using an "nfkc" instance. @@ -1609,7 +1609,7 @@ typedef enum { /** * @brief i18n_usearch_h. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 */ typedef void *i18n_usearch_h; @@ -1624,7 +1624,7 @@ typedef void *i18n_usearch_h; /** * @brief i18n_ucalendar_h. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 */ typedef void *i18n_ucalendar_h; @@ -1636,7 +1636,7 @@ typedef void *i18n_ucalendar_h; /** * @brief Enumeration for possible fields in an #i18n_ucalendar_h. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 */ typedef enum { I18N_UCALENDAR_ERA, /**< Field number indicating the era, e.g., AD or BC in the Gregorian (Julian) calendar */ @@ -1690,7 +1690,7 @@ typedef enum { /** * @brief Enumeration for possible months in an #i18n_ucalendar_h. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 */ typedef enum { I18N_UCALENDAR_TRADITIONAL, /**< Despite the name, #I18N_UCALENDAR_TRADITIONAL designates the locale's default calendar, which may be the Gregorian calendar or some other calendar */ @@ -1700,7 +1700,7 @@ typedef enum { /** * @brief Enumeration for possible months in an #i18n_ucalendar_h. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 */ typedef enum { I18N_UCALENDAR_JANUARY, /**< January */ @@ -1719,7 +1719,7 @@ typedef enum { /** * @brief Enumeration for possible formats of an #i18n_ucalendar_h's display name. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 */ typedef enum { I18N_UCALENDAR_STANDARD, /**< Standard display name */ @@ -1730,7 +1730,7 @@ typedef enum { /** * @brief Enumeration for types of #i18n_ucalendar_h attributes. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 */ typedef enum { I18N_UCALENDAR_LENIENT, /**< Lenient parsing */ @@ -1740,7 +1740,7 @@ typedef enum { /** * @brief System time zone type constants. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 */ typedef enum { I18N_UCALENDAR_ZONE_TYPE_ANY, /**< Any system zones. */ @@ -1819,19 +1819,19 @@ typedef enum { /** * @brief Date and Time data type. * @details This is a primitive data type that holds the date and time as the number of milliseconds since 1970-jan-01, 00:00 UTC. UTC leap seconds are ignored. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 */ typedef double i18n_udate; /** * @brief A date formatter. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 */ typedef void *i18n_udate_format_h; /** * @brief A struct representing a range of text containing a specific field. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 */ typedef struct { int32_t field; /**< The field. */ @@ -1841,13 +1841,13 @@ typedef struct { /** * @brief Handle to struct representing a range of text containing a specific field. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 */ typedef i18n_ufield_position_s *i18n_ufield_position_h; /** * @brief Enumeration for the possible date/time format styles. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 */ typedef enum { I18N_UDATE_FULL, /**< Full style */ @@ -2249,7 +2249,7 @@ typedef enum { /** * @brief Handle for a date/time pattern generator object. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 */ typedef void *i18n_udatepg_h; @@ -2312,19 +2312,19 @@ typedef enum { /** * @brief A number formatter. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 */ typedef void *i18n_unumber_format_h; /** * @brief Definition of context length. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 */ #define I18N_U_PARSE_CONTEXT_LEN 16 /** * @brief Struct used to returned detailed information about parsing errors. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 */ typedef struct { int32_t line; /**< The line on which the error occurred. */ @@ -2335,7 +2335,7 @@ typedef struct { /** * @brief Enumeration for the possible number format styles. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 */ typedef enum { I18N_UNUMBER_PATTERN_DECIMAL = 0, /**< Decimal format defined by a pattern string */ @@ -2359,7 +2359,7 @@ typedef enum { /** * @brief Enumeration of constants for specifying a number format symbol. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 */ typedef enum { I18N_UNUMBER_DECIMAL_SEPARATOR_SYMBOL = 0, /**< The decimal separator */ @@ -2471,27 +2471,27 @@ typedef enum { * @{ */ -#define I18N_ULOCALE_CHINESE "zh" /**< Useful constant for zh. @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif*/ -#define I18N_ULOCALE_ENGLISH "en" /**< Useful constant for en. @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif*/ -#define I18N_ULOCALE_FRENCH "fr" /**< Useful constant for fr. @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif*/ -#define I18N_ULOCALE_GERMAN "de" /**< Useful constant for de. @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif*/ -#define I18N_ULOCALE_ITALIAN "it" /**< Useful constant for it. @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif*/ -#define I18N_ULOCALE_JAPANESE "ja" /**< Useful constant for ja. @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif*/ -#define I18N_ULOCALE_KOREAN "ko" /**< Useful constant for ko. @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif*/ -#define I18N_ULOCALE_SIMPLIFIED_CHINESE "zh_CN" /**< Useful constant for zh_CN. @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif*/ -#define I18N_ULOCALE_TRADITIONAL_CHINESE "zh_TW" /**< Useful constant for zh_TW. @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif*/ -#define I18N_ULOCALE_CANADA "en_CA" /**< Useful constant for en_CA. @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif*/ -#define I18N_ULOCALE_CANADA_FRENCH "fr_CA" /**< Useful constant for fr_CA. @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif*/ -#define I18N_ULOCALE_CHINA "zh_CN" /**< Useful constant for zh_CN. @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif*/ -#define I18N_ULOCALE_PRC "zh_CN" /**< Useful constant for zh_CN. @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif*/ -#define I18N_ULOCALE_FRANCE "fr_FR" /**< Useful constant for fr_FR. @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif*/ -#define I18N_ULOCALE_GERMANY "de_DE" /**< Useful constant for de_DE. @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif*/ -#define I18N_ULOCALE_ITALY "it_IT" /**< Useful constant for it_IT. @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif*/ -#define I18N_ULOCALE_JAPAN "ja_JP" /**< Useful constant for ja_JP. @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif*/ -#define I18N_ULOCALE_KOREA "ko_KR" /**< Useful constant for ko_KR. @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif*/ -#define I18N_ULOCALE_TAIWAN "zh_TW" /**< Useful constant for zh_TW. @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif*/ -#define I18N_ULOCALE_UK "en_GB" /**< Useful constant for en_GB. @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif*/ -#define I18N_ULOCALE_US "en_US" /**< Useful constant for en_US. @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif*/ +#define I18N_ULOCALE_CHINESE "zh" /**< Useful constant for zh. @since_tizen 2.3*/ +#define I18N_ULOCALE_ENGLISH "en" /**< Useful constant for en. @since_tizen 2.3*/ +#define I18N_ULOCALE_FRENCH "fr" /**< Useful constant for fr. @since_tizen 2.3*/ +#define I18N_ULOCALE_GERMAN "de" /**< Useful constant for de. @since_tizen 2.3*/ +#define I18N_ULOCALE_ITALIAN "it" /**< Useful constant for it. @since_tizen 2.3*/ +#define I18N_ULOCALE_JAPANESE "ja" /**< Useful constant for ja. @since_tizen 2.3*/ +#define I18N_ULOCALE_KOREAN "ko" /**< Useful constant for ko. @since_tizen 2.3*/ +#define I18N_ULOCALE_SIMPLIFIED_CHINESE "zh_CN" /**< Useful constant for zh_CN. @since_tizen 2.3*/ +#define I18N_ULOCALE_TRADITIONAL_CHINESE "zh_TW" /**< Useful constant for zh_TW. @since_tizen 2.3*/ +#define I18N_ULOCALE_CANADA "en_CA" /**< Useful constant for en_CA. @since_tizen 2.3*/ +#define I18N_ULOCALE_CANADA_FRENCH "fr_CA" /**< Useful constant for fr_CA. @since_tizen 2.3*/ +#define I18N_ULOCALE_CHINA "zh_CN" /**< Useful constant for zh_CN. @since_tizen 2.3*/ +#define I18N_ULOCALE_PRC "zh_CN" /**< Useful constant for zh_CN. @since_tizen 2.3*/ +#define I18N_ULOCALE_FRANCE "fr_FR" /**< Useful constant for fr_FR. @since_tizen 2.3*/ +#define I18N_ULOCALE_GERMANY "de_DE" /**< Useful constant for de_DE. @since_tizen 2.3*/ +#define I18N_ULOCALE_ITALY "it_IT" /**< Useful constant for it_IT. @since_tizen 2.3*/ +#define I18N_ULOCALE_JAPAN "ja_JP" /**< Useful constant for ja_JP. @since_tizen 2.3*/ +#define I18N_ULOCALE_KOREA "ko_KR" /**< Useful constant for ko_KR. @since_tizen 2.3*/ +#define I18N_ULOCALE_TAIWAN "zh_TW" /**< Useful constant for zh_TW. @since_tizen 2.3*/ +#define I18N_ULOCALE_UK "en_GB" /**< Useful constant for en_GB. @since_tizen 2.3*/ +#define I18N_ULOCALE_US "en_US" /**< Useful constant for en_US. @since_tizen 2.3*/ /** * @brief Useful constant for the maximum size of the language part of a locale ID. @@ -2634,7 +2634,7 @@ typedef enum { /** * @brief Callback function for i18n_ustring_unescape_at() that returns a character of the source text given an offset and a context pointer.\n * The context pointer will be whatever is passed into i18n_ustring_unescape_at(). - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[in] offset pointer to the offset that will be passed to i18n_ustring_unescape_at(). * @param[in] context an opaque pointer passed directly into i18n_ustring_unescape_at() @@ -2647,14 +2647,14 @@ typedef i18n_uchar(*i18n_ustring_unescape_char_at_cb)(int32_t offset, void *cont /** * @brief Option value for case folding: use default mappings defined in CaseFolding.txt. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 */ #define I18N_USTRING_U_FOLD_CASE_DEFAULT 0 /** * @brief Option bit i18n_ustring_case_compare_with_length(), i18n_ustring_case_compare(), etc: Compare strings in code point order instead of code unit order. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 */ #define I18N_USTRING_U_COMPARE_CODE_POINT_ORDER 0x8000 @@ -2663,7 +2663,7 @@ typedef i18n_uchar(*i18n_ustring_unescape_char_at_cb)(int32_t offset, void *cont * Use the modified set of mappings provided in CaseFolding.txt to handle dotted I and dotless i appropriately for Turkic languages (tr, az).\n * Before Unicode 3.2, CaseFolding.txt contains mappings marked with 'I' that are to be included for default mappings and excluded for the Turkic-specific mappings.\n * Unicode 3.2 CaseFolding.txt instead contains mappings marked with 'T' that are to be excluded for default mappings and included for the Turkic-specific mappings. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 */ #define I18N_USTRING_U_FOLD_CASE_EXCLUDE_SPECIAL_I 1 @@ -2678,14 +2678,14 @@ typedef i18n_uchar(*i18n_ustring_unescape_char_at_cb)(int32_t offset, void *cont /** * @brief handle for object that represents a time zone offset, and also figures out daylight savings.. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 */ typedef void *i18n_timezone_h; /** * @brief Callback function for i18n_timezone_foreach_timezone_id(), i18n_timezone_foreach_timezone_id_with_offset(), and i18n_timezone_foreach_timezone_id_by_country() * that returns an enumeration over all recognized time zone IDs. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[in] timezone_id time zone ID * @param[in] user_data the user data passed to the callback function @@ -2698,7 +2698,7 @@ typedef bool (*i18n_timezone_id_cb)(const char *timezone_id, void *user_data); /** * @brief Enumeration for use with i18n_timezone_get_display_name(), i18n_timezone_get_display_name_with_locale(), and i18n_timezone_get_display_name_with_type(). - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 */ typedef enum { I18N_TIMEZONE_DISPLAY_TYPE_SHORT = 1, /**< Selector for short display name */ @@ -2722,7 +2722,7 @@ typedef enum { /** * @brief i18n_ubreak_iterator_s. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 */ typedef void *i18n_ubreak_iterator_s; diff --git a/src/include/utils_i18n_ucalendar.h b/src/include/utils_i18n_ucalendar.h index 3eb12c8..beb1cd3 100644 --- a/src/include/utils_i18n_ucalendar.h +++ b/src/include/utils_i18n_ucalendar.h @@ -119,7 +119,7 @@ extern "C" { /** * @brief Sets the default time zone. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[in] zone_id null-terminated time zone ID * @@ -132,7 +132,7 @@ int i18n_ucalendar_set_default_timezone(const i18n_uchar *zone_id); /** * @brief Gets the current date and time. * @details The value returned is represented as milliseconds from the epoch. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[out] date The current date and time * @@ -148,7 +148,7 @@ int i18n_ucalendar_get_now(i18n_udate *date); * @details Note: When an unknown TimeZone ID is specified, the #i18n_ucalendar_h returned * by the function is initialized with GMT ("Etc/GMT") without any * errors/warnings. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * @remarks Must release @a calendar using i18n_ucalendar_destroy(). * * @param[in] zone_id The desired TimeZone ID \n @@ -174,7 +174,7 @@ int i18n_ucalendar_create(const i18n_uchar *zone_id, int32_t len, const char *lo /** * @brief Destroys an #i18n_ucalendar_h. * @details Once destroyed, an #i18n_ucalendar_h may no longer be used. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[in] calendar The #i18n_ucalendar_h to destroy * @retval #I18N_ERROR_NONE Successful @@ -185,7 +185,7 @@ int i18n_ucalendar_destroy(i18n_ucalendar_h calendar); /** * @brief Creates a copy of a #i18n_ucalendar_h. * This function performs a deep copy. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[in] cal The #i18n_ucalendar_h to copy * @param[out] identical_to_cal A pointer to a #i18n_ucalendar_h identical to @a cal. @@ -197,7 +197,7 @@ int i18n_ucalendar_clone(const i18n_ucalendar_h cal, i18n_ucalendar_h *identical /** * @brief Gets the display name for a calendar's TimeZone. * @details A display name is suitable for presentation to a user. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[in] calendar The #i18n_ucalendar_h to query * @param[in] type The desired display name format \n @@ -216,7 +216,7 @@ int i18n_ucalendar_get_timezone_displayname(const i18n_ucalendar_h calendar, i18 /** * @brief Determines if an #i18n_ucalendar_h is currently in daylight savings time. * @details Daylight savings time is not used in all parts of the world. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[in] calendar The #i18n_ucalendar_h to query * @param[out] is_in If @c true @a calendar is currently in daylight savings time, @@ -230,7 +230,7 @@ int i18n_ucalendar_is_in_daylight_time(const i18n_ucalendar_h calendar, i18n_ubo /** * @brief Sets the value of a field in a #i18n_ucalendar_h. * @details All fields are represented as 32-bit integers. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[in] cal The #i18n_ucalendar_h to modify * @param[in] field The field to set \n @@ -250,7 +250,7 @@ int i18n_ucalendar_set(i18n_ucalendar_h cal, i18n_ucalendar_date_fields_e field, * @brief Sets a numeric attribute associated with an #i18n_ucalendar_h. * @details Numeric attributes include the first day of the week, or the minimal number * of days in the first week of the month. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[in] calendar The #i18n_ucalendar_h to modify * @param[in] attr The desired attribute \n @@ -268,7 +268,7 @@ int i18n_ucalendar_set_attribute(i18n_ucalendar_h calendar, i18n_ucalendar_attri * @details Numeric attributes include the first day of the week, or the minimal numbers of days * in the first week of the month. * - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[in] calendar The i18n_ucalendar to query * @param[in] attr The desired attribute \n @@ -284,7 +284,7 @@ int i18n_ucalendar_get_attribute(i18n_ucalendar_h calendar, i18n_ucalendar_attri /** * @brief Gets a calendar's current time in milliseconds. * @details The time is represented as milliseconds from the epoch. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[in] calendar The #i18n_ucalendar_h to query * @param[out] date The calendar's current time in milliseconds @@ -299,7 +299,7 @@ int i18n_ucalendar_get_milliseconds(const i18n_ucalendar_h calendar, i18n_udate /** * @brief Sets a calendar's current time in milliseconds. * @details The time is represented as milliseconds from the epoch. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[in] calendar The #i18n_ucalendar_h to set * @param[in] milliseconds The desired date and time @@ -314,7 +314,7 @@ int i18n_ucalendar_set_milliseconds(i18n_ucalendar_h calendar, i18n_udate millis /** * @brief Sets a calendar's current date. * @details The date is represented as a series of 32-bit integers. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[in] calendar The #i18n_ucalendar_h to set * @param[in] year The desired year @@ -337,7 +337,7 @@ int i18n_ucalendar_set_date_time(i18n_ucalendar_h calendar, int32_t year, int32_ * @brief Returns @c true if two #i18n_ucalendar_h calendars are equivalent. * @details Equivalent #i18n_ucalendar_h calendars will behave identically, but they may be set to * different times. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[in] calendar1 The first of the calendars to compare * @param[in] calendar2 The second of the calendars to compare @@ -351,7 +351,7 @@ int i18n_ucalendar_is_equivalent_to(const i18n_ucalendar_h calendar1, const i18n /** * @brief Adds a specified signed amount to a particular field in a #i18n_ucalendar_h. * @details This can modify more significant fields in the calendar. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[in] calendar The #i18n_ucalendar_h to which to add * @param[in] field The field to which to add the signed value\n One of #I18N_UCALENDAR_ERA, #I18N_UCALENDAR_YEAR, #I18N_UCALENDAR_MONTH, @@ -371,7 +371,7 @@ int i18n_ucalendar_add(i18n_ucalendar_h calendar, i18n_ucalendar_date_fields_e f /** * @brief Gets the current value of a field from an #i18n_ucalendar_h. * @details All fields are represented as 32-bit integers. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[in] calendar The #i18n_ucalendar_h to query * @param[in] field The desired field\n One of I18N_UCALENDAR_ERA, I18N_UCALENDAR_YEAR, I18N_UCALENDAR_MONTH, diff --git a/src/include/utils_i18n_uchar.h b/src/include/utils_i18n_uchar.h index 26978dd..83cb67b 100644 --- a/src/include/utils_i18n_uchar.h +++ b/src/include/utils_i18n_uchar.h @@ -130,7 +130,7 @@ extern "C" { i18n_uchar_get_int_property_value(c, I18N_UCHAR_IDEOGRAPHIC, &property_value); is_ideographic = (bool)property_value; * @endcode - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[in] c The code point to test. * @param[in] which The #i18n_uchar_uproperty_e selector constant, identifies which property @@ -154,7 +154,7 @@ int i18n_uchar_get_int_property_value(i18n_uchar32 c, i18n_uchar_uproperty_e whi /** * @brief Gets the Unicode allocation block that contains the character. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[in] c The code point to test * @param[out] block_val The block value for the code point diff --git a/src/include/utils_i18n_ucollator.h b/src/include/utils_i18n_ucollator.h index 4246743..6949988 100644 --- a/src/include/utils_i18n_ucollator.h +++ b/src/include/utils_i18n_ucollator.h @@ -136,7 +136,7 @@ extern "C" { * * The #i18n_ucollator_h is used in all the calls to the Collation service.\n * After finished, collator must be disposed off by calling {@link #i18n_ucollator_destroy()}. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * @remarks Must release @a collator using i18n_ucollator_destroy(). * * @param[in] locale The locale containing the required collation rules\n @@ -213,7 +213,7 @@ int i18n_ucollator_get_contractions_and_expansions(const i18n_ucollator_h collat * @brief Destroys a #i18n_ucollator_h. * @details Once destroyed, the #i18n_ucollator_h should not be used. Every created collator * should be destroyed. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[in] collator The #i18n_ucollator_h to close * @@ -226,7 +226,7 @@ int i18n_ucollator_destroy(i18n_ucollator_h collator); /** * @brief Compares two strings. * @details The strings will be compared using the options already specified. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[in] collator The #i18n_ucollator_h containing the comparison rules * @param[in] src The source string @@ -320,7 +320,7 @@ int i18n_ucollator_greater_or_equal(const i18n_ucollator_h collator, const i18n_ /** * @brief Compares two strings for equality. * @details This function is equivalent to {@link #i18n_ucollator_str_collator()}. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[in] collator The #i18n_ucollator_h containing the comparison rules * @param[in] src The source string @@ -375,7 +375,7 @@ int i18n_ucollator_get_strength(const i18n_ucollator_h collator, i18n_ucollator_ /** * @brief Sets the collation strength used in a collator. * @details The strength influences how strings are compared. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[in] collator The i18n_ucollator_h to set. * @param[in] strength The desired collation strength.\n @@ -796,7 +796,7 @@ int i18n_ucollator_merge_sort_keys(const uint8_t *src1, int32_t src1_length, /** * @brief Sets an attribute's value. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[in] collator The i18n_ucollator_h containing attributes to be changed * @param[in] attr The attribute type diff --git a/src/include/utils_i18n_udate.h b/src/include/utils_i18n_udate.h index e1bb6ca..71eb850 100644 --- a/src/include/utils_i18n_udate.h +++ b/src/include/utils_i18n_udate.h @@ -169,7 +169,7 @@ extern "C" { /** * @brief Creates a new #i18n_udate_format_h for formatting and parsing dates and times. * @details A #i18n_udate_format_h may be used to format dates in calls to {@link i18n_udate_create()}. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * @remarks Must release @a format using i18n_udate_destroy().\n * If @a pattern parameter is used, pass in #I18N_UDATE_PATTERN for @a time_style and @a date_style. \n * #I18N_UDATE_PATTERN can only be used in this case, and has to be set for both @a time_style and @a date_style. @@ -198,7 +198,7 @@ int i18n_udate_create(i18n_udate_format_style_e time_style, i18n_udate_format_st /** * @brief Destroys an #i18n_udate_format_h. * @details Once destroyed, an #i18n_udate_format_h may no longer be used. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[in] format The formatter to destroy. * @@ -210,7 +210,7 @@ int i18n_udate_destroy(i18n_udate_format_h format); /** * @brief Formats a date using an #i18n_udate_format_h. * @details The date will be formatted using the conventions specified in {@link i18n_udate_create()} - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[in] format The formatter to use. * @param[in] date_to_format The date to format. diff --git a/src/include/utils_i18n_udatepg.h b/src/include/utils_i18n_udatepg.h index 5d0a281..2b46fd0 100644 --- a/src/include/utils_i18n_udatepg.h +++ b/src/include/utils_i18n_udatepg.h @@ -168,7 +168,7 @@ extern "C" { /** * @brief Opens a generator according to a given locale. * @remarks Must release @a dtpg using i18n_udatepg_destroy(). - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[in] locale If @c NULL - default locale will be used. * @param[out] dtpg A pointer to #i18n_udatepg_h. Must not be @c NULL. @@ -180,7 +180,7 @@ int i18n_udatepg_create(const char *locale, i18n_udatepg_h *dtpg); /** * @brief Destroys a generator. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[in] dtpg A pointer to #i18n_udatepg_h. Must not be @c NULL. * @@ -197,7 +197,7 @@ int i18n_udatepg_destroy(i18n_udatepg_h dtpg); * rather than creating one for each function call. * Consecutive calls to this function do not affect each other, * but this function cannot be used concurrently on a single generator object. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[in] dtpg A pointer to #i18n_udatepg_h. Must not be @c NULL. * @param[in] skeleton The skeleton is a pattern containing only the variable fields.\n diff --git a/src/include/utils_i18n_ulocale.h b/src/include/utils_i18n_ulocale.h index f62f0ca..195d283 100644 --- a/src/include/utils_i18n_ulocale.h +++ b/src/include/utils_i18n_ulocale.h @@ -178,7 +178,7 @@ extern "C" { * @details The returned string is a snapshot in time, and will remain valid * and unchanged even when i18n_ulocale_set_default() is called. * The returned storage is owned by I18N, and must not be altered or deleted by the caller. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[out] locale The I18N default locale * @@ -195,7 +195,7 @@ int i18n_ulocale_get_default(const char **locale); * Changes to I18N's default locale do not propagate back to the system environment. * * Changes to I18N's default locale to not affect any services that may already be open based on the previous default locale value. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[in] locale_id The new I18N default locale.\n * A value of @c NULL will try to get the system's default locale. @@ -207,7 +207,7 @@ int i18n_ulocale_set_default(const char *locale_id); /** * @brief Gets the language code for the specified locale. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[in] locale_id The locale to get the ISO language code with.\n * @c NULL may be used to specify the default. @@ -223,7 +223,7 @@ int i18n_ulocale_get_language(const char *locale_id, char *language, int32_t lan /** * @brief Gets the country code for the specified locale. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[in] locale_id The locale to get the country code with * @param[out] country The country code for @a locale_id @@ -237,7 +237,7 @@ int32_t i18n_ulocale_get_country(const char *locale_id, char *country, int32_t c /** * @brief Gets the full name suitable for display for the specified locale. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[in] locale_id The locale to get the displayable name with.\n * @c NULL may be used to specify the default. @@ -261,7 +261,7 @@ int i18n_ulocale_get_display_name(const char *locale_id, const char *in_locale_i * The locale name is terminated by a null pointer. * @remarks The specific error code can be obtained using the get_last_result() method. * Error codes are described in Exceptions section. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[in] n The specific locale name index of the available locale list * @@ -275,7 +275,7 @@ const char *i18n_ulocale_get_available(int32_t n); * @brief Gets the size of the all available locale list. * @remarks The specific error code can be obtained using the get_last_result() method. * Error codes are described in Exceptions section. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @return The size of the locale list * @exception #I18N_ERROR_NONE Success diff --git a/src/include/utils_i18n_unormalization.h b/src/include/utils_i18n_unormalization.h index 80d9eaf..eda02cc 100644 --- a/src/include/utils_i18n_unormalization.h +++ b/src/include/utils_i18n_unormalization.h @@ -69,7 +69,7 @@ extern "C" { /** * @brief Gets a i18n_unormalizer_h which uses the specified data file and composes or decomposes text according to the specified mode. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[in] package_name @c NULL for ICU built-in data, otherwise application data package name. * @param[in] name "nfc" or "nfkc" or "nfkc_cf" or the name of the custom data file. @@ -85,7 +85,7 @@ int i18n_unormalization_get_instance(const char *package_name, const char *name, /** * @brief Writes the normalized form of the source string to the destination string(replacing its contents). * @details The source and destination strings must be different buffers. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[in] normalizer An #i18n_unormalizer_h handle. * @param[in] src The source string. diff --git a/src/include/utils_i18n_unumber.h b/src/include/utils_i18n_unumber.h index 660db2e..62e3f78 100644 --- a/src/include/utils_i18n_unumber.h +++ b/src/include/utils_i18n_unumber.h @@ -74,7 +74,7 @@ extern "C" { * @brief Creates and returns a new unumber_format_h for formatting and parsing numbers. * @details A unumber_format_style_e may be used to format numbers by calling i18n_unumber_create(). * The caller must call i18n_unumber_destroy() when done to release resources used by this object. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * @remarks Must release @a num_format using i18n_unumber_destroy(). * * @param[in] style The type of number format to create: one of @@ -110,7 +110,7 @@ int i18n_unumber_create(i18n_unumber_format_style_e style, const i18n_uchar *pat /** * @brief Destroys an #i18n_unumber_format_h. * @details Once destroyed, an #i18n_unumber_format may no longer be used. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[in] fmt The formatter to destroy * @@ -123,7 +123,7 @@ int i18n_unumber_destroy(i18n_unumber_format_h fmt); * @brief Gets a symbol associated with an #i18n_unumber_format_h. * @details An #i18n_unumber_format_h uses symbols to represent the special locale-dependent characters in a number, * for example the percent sign. This API is not supported for rule-based formatters. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[in] fmt The formatter to query. * @param[in] symbol The unumber_format_symbol_e constant for the symbol to get diff --git a/src/include/utils_i18n_usearch.h b/src/include/utils_i18n_usearch.h index c17d806..81bb3ca 100644 --- a/src/include/utils_i18n_usearch.h +++ b/src/include/utils_i18n_usearch.h @@ -105,7 +105,7 @@ int i18n_usearch_create_new(const i18n_uchar *pattern, int32_t pattern_len, cons /** * @brief Destroys and cleans up the i18n_usearch_h. * @details If a collator is created in i18n_usearch_create_new(), it will be destroyed here. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[in] search_iter The i18n_usearch_h to clean up * @@ -123,7 +123,7 @@ int i18n_usearch_destroy(i18n_usearch_h search_iter); * will be returned in status. The result will be NULL-terminated whenever * possible. If the buffer fits the matched text exactly, a NULL-termination * is not possible. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[in] search_iter The search iterator handle * @param[out] result i18n_uchar The buffer to store the matched string @@ -141,7 +141,7 @@ int i18n_usearch_get_matched_text(const i18n_usearch_h search_iter, i18n_uchar * * @details Deleting the returned i18n_ucollator_h before calling * i18n_usearch_destroy() would cause the string search to fail. * i18n_usearch_destroy() will delete the collator if this search owns it. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[in] search_iter The search iterator handle * @param[out] collator The collator @@ -157,7 +157,7 @@ int i18n_usearch_get_collator(const i18n_usearch_h search_iter, i18n_ucollator_h * is the match position if one is found. * If a match is not found, #I18N_USEARCH_DONE will be returned and * the iterator will be adjusted to the index #I18N_USEARCH_DONE. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[in] search_iter The search iterator handle * @param[out] index_first The character index of the first match, diff --git a/src/include/utils_i18n_ustring.h b/src/include/utils_i18n_ustring.h index c563d6f..b5b7aaa 100644 --- a/src/include/utils_i18n_ustring.h +++ b/src/include/utils_i18n_ustring.h @@ -73,7 +73,7 @@ extern "C" { * @brief Determines the length of an array of #i18n_uchar. * @remarks The specific error code can be obtained using the get_last_result() method. * Error codes are described in Exceptions section. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[in] s The array of #i18n_uchar characters, @c NULL (U+0000) terminated. * @@ -89,7 +89,7 @@ int32_t i18n_ustring_get_length(const i18n_uchar *s); * Counting code points involves reading all code units. * @remarks The specific error code can be obtained using the get_last_result() method. * Error codes are described in Exceptions section. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[in] s The input string. * @param[in] length The number of #i18n_uchar code units to be checked, or @c -1 to count @@ -110,7 +110,7 @@ int32_t i18n_ustring_count_char32(const i18n_uchar *s, int32_t length); * A Unicode code point may occupy either one or two #i18n_uchar code units. * @remarks The specific error code can be obtained using the get_last_result() method. * Error codes are described in Exceptions section. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[in] s The input string. * @param[in] length The length of the string, or @c -1 if it is NULL-terminated. @@ -128,7 +128,7 @@ i18n_ubool i18n_ustring_has_more_char32_than(const i18n_uchar *s, int32_t length * The initial copied character from @a src overwrites the NULL terminator in @a dest. * @remarks The specific error code can be obtained using the get_last_result() method. * Error codes are described in Exceptions section. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[out] dest The destination string. * @param[in] src The source string. @@ -145,7 +145,7 @@ i18n_uchar *i18n_ustring_cat(i18n_uchar *dest, const i18n_uchar *src); * The initial copied character from @a src overwrites the NULL terminator in @a dest. * @remarks The specific error code can be obtained using the get_last_result() method. * Error codes are described in Exceptions section. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[out] dest The destination string. * @param[in] src The source string. @@ -164,7 +164,7 @@ i18n_uchar *i18n_ustring_cat_n(i18n_uchar *dest, const i18n_uchar *src, int32_t * Otherwise, the substring edge units would be matched against halves of surrogate pairs. * @remarks The specific error code can be obtained using the get_last_result() method. * Error codes are described in Exceptions section. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[in] s The string to search (NULL-terminated). * @param[in] sub_string The substring to find (NULL-terminated). @@ -189,7 +189,7 @@ i18n_uchar *i18n_ustring_string(const i18n_uchar *s, const i18n_uchar *sub_strin * Otherwise, the substring edge units would be matched against halves of surrogate pairs. * @remarks The specific error code can be obtained using the get_last_result() method. * Error codes are described in Exceptions section. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[in] s The string to search (NULL-terminated). * @param[in] length The length of @a s (number of #i18n_uchar characters), or @c -1 if it is NULL-terminated. @@ -213,7 +213,7 @@ i18n_uchar *i18n_ustring_find_first(const i18n_uchar *s, int32_t length, const i * @details A surrogate code point is found only if its match in the text is not part of a surrogate pair. A NULL character is found at the string terminator. * @remarks The specific error code can be obtained using the get_last_result() method. * Error codes are described in Exceptions section. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[in] s The string to search (NULL-terminated). * @param[in] c The BMP code point to find. @@ -234,7 +234,7 @@ i18n_uchar *i18n_ustring_char(const i18n_uchar *s, i18n_uchar c); * @details A surrogate code point is found only if its match in the text is not part of a surrogate pair. A NULL character is found at the string terminator. * @remarks The specific error code can be obtained using the get_last_result() method. * Error codes are described in Exceptions section. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[in] s The string to search (NULL-terminated). * @param[in] c The code point to find. @@ -257,7 +257,7 @@ i18n_uchar *i18n_ustring_char32(const i18n_uchar *s, i18n_uchar32 c); * Otherwise, the substring edge units would be matched against halves of surrogate pairs. * @remarks The specific error code can be obtained using the get_last_result() method. * Error codes are described in Exceptions section. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[in] s The string to search (NULL-terminated). * @param[in] sub_string The substring to find (NULL-terminated). @@ -280,7 +280,7 @@ i18n_uchar *i18n_ustring_r_string(const i18n_uchar *s, const i18n_uchar *sub_str * Otherwise, the substring edge units would be matched against halves of surrogate pairs. * @remarks The specific error code can be obtained using the get_last_result() method. * Error codes are described in Exceptions section. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[in] s The string to search. * @param[in] length The length of s (number of #i18n_uchar), or @c -1 if it is NULL-terminated. @@ -302,7 +302,7 @@ i18n_uchar *i18n_ustring_find_last(const i18n_uchar *s, int32_t length, const i1 * @details A surrogate code point is found only if its match in the text is not part of a surrogate pair. A NULL character is found at the string terminator. * @remarks The specific error code can be obtained using the get_last_result() method. * Error codes are described in Exceptions section. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[in] s The string to search (NULL-terminated). * @param[in] c The BMP code point to find. @@ -323,7 +323,7 @@ i18n_uchar *i18n_ustring_r_char(const i18n_uchar *s, i18n_uchar c); * @details A surrogate code point is found only if its match in the text is not part of a surrogate pair. A NULL character is found at the string terminator. * @remarks The specific error code can be obtained using the get_last_result() method. * Error codes are described in Exceptions section. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[in] s The string to search (NULL-terminated). * @param[in] c The code point to find. @@ -344,7 +344,7 @@ i18n_uchar *i18n_ustring_r_char32(const i18n_uchar *s, i18n_uchar32 c); * @details Works just like C's strpbrk but with Unicode. * @remarks The specific error code can be obtained using the get_last_result() method. * Error codes are described in Exceptions section. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[in] string The string in which to search, NULL-terminated. * @param[in] match_set A NULL-terminated string defining a set of code points for which to search in the text string. @@ -361,7 +361,7 @@ i18n_uchar *i18n_ustring_pbrk(const i18n_uchar *string, const i18n_uchar *match_ * @details Works just like C's strcspn but with Unicode. * @remarks The specific error code can be obtained using the get_last_result() method. * Error codes are described in Exceptions section. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[in] string The string in which to search, NULL-terminated. * @param[in] match_set A NULL-terminated string defining a set of code points for which to search in the text string. @@ -379,7 +379,7 @@ int32_t i18n_ustring_cspn(const i18n_uchar *string, const i18n_uchar *match_set) * @details Works just like C's strspn but with Unicode. * @remarks The specific error code can be obtained using the get_last_result() method. * Error codes are described in Exceptions section. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[in] string The string in which to search, NULL-terminated. * @param[in] match_set A NULL-terminated string defining a set of code points for which to search in the text string. @@ -396,7 +396,7 @@ int32_t i18n_ustring_spn(const i18n_uchar *string, const i18n_uchar *match_set); * @details Works just like C's strspn but with Unicode. * @remarks The specific error code can be obtained using the get_last_result() method. * Error codes are described in Exceptions section. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[in] src String containing token(s). This string will be modified. After the first call to #i18n_ustring_tokenizer_r(), this argument must be NULL to get to the next token. * @param[in] delim Set of delimiter characters (Unicode code points). @@ -413,7 +413,7 @@ i18n_uchar *i18n_ustring_tokenizer_r(i18n_uchar *src, const i18n_uchar *delim, i * @brief Compares two Unicode strings for bitwise equality (code unit order). * @remarks The specific error code can be obtained using the get_last_result() method. * Error codes are described in Exceptions section. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[in] s1 A string to compare. * @param[in] s2 A string to compare. @@ -430,7 +430,7 @@ int32_t i18n_ustring_compare(const i18n_uchar *s1, const i18n_uchar *s2); * @details See #i18n_ustring_compare() for details. * @remarks The specific error code can be obtained using the get_last_result() method. * Error codes are described in Exceptions section. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[in] s1 A string to compare. * @param[in] s2 A string to compare. @@ -451,7 +451,7 @@ int32_t i18n_ustring_compare_code_point_order(const i18n_uchar *s1, const i18n_u * NULL-terminated strings are possible with length arguments of -1. * @remarks The specific error code can be obtained using the get_last_result() method. * Error codes are described in Exceptions section. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[in] s1 First source string. * @param[in] length1 Length of first source string, or @c -1 if NULL-terminated. @@ -471,7 +471,7 @@ int32_t i18n_ustring_compare_binary_order(const i18n_uchar *s1, int32_t length1, * In code unit order, high BMP code points sort after supplementary code points because they are stored as pairs of surrogates which are at U+d800..U+dfff.\n * This functions works with strings of different explicitly specified lengths unlike the ANSI C-like #i18n_ustring_compare() and i18n_ustring_mem_compare() etc. * NULL-terminated strings are possible with length arguments of -1. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[in] s1 First source string. * @param[in] length1 Length of first source string, or @c -1 if NULL-terminated. @@ -494,7 +494,7 @@ int32_t i18n_ustring_case_compare_with_length(const i18n_uchar *s1, int32_t leng * @details Compares at most n characters. * @remarks The specific error code can be obtained using the get_last_result() method. * Error codes are described in Exceptions section. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[in] s1 A string to compare (can be NULL/invalid if n<=0). * @param[in] s2 A string to compare (can be NULL/invalid if n<=0). @@ -512,7 +512,7 @@ int32_t i18n_ustring_compare_n(const i18n_uchar *s1, const i18n_uchar *s2, int32 * @details This is different in UTF-16 from #i18n_ustring_compare_n() if supplementary characters are present. For details, see #i18n_ustring_compare_binary_order(). * @remarks The specific error code can be obtained using the get_last_result() method. * Error codes are described in Exceptions section. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[in] s1 A string to compare. * @param[in] s2 A string to compare. @@ -529,7 +529,7 @@ int32_t i18n_ustring_compare_n_code_point_order(const i18n_uchar *s1, const i18n * @brief Compare two strings case-insensitively using full case folding. * @remarks The specific error code can be obtained using the get_last_result() method. * Error codes are described in Exceptions section. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[in] s1 A string to compare. * @param[in] s2 A string to compare. @@ -547,7 +547,7 @@ int32_t i18n_ustring_case_compare(const i18n_uchar *s1, const i18n_uchar *s2, ui * @brief Compare two strings case-insensitively using full case folding. * @remarks The specific error code can be obtained using the get_last_result() method. * Error codes are described in Exceptions section. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[in] s1 A string to compare. * @param[in] s2 A string to compare. @@ -566,7 +566,7 @@ int32_t i18n_ustring_case_compare_n(const i18n_uchar *s1, const i18n_uchar *s2, * @brief Compare two strings case-insensitively using full case folding. * @remarks The specific error code can be obtained using the get_last_result() method. * Error codes are described in Exceptions section. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[in] s1 A string to compare. * @param[in] s2 A string to compare. @@ -585,7 +585,7 @@ int32_t i18n_ustring_mem_case_compare(const i18n_uchar *s1, const i18n_uchar *s2 * @brief Copies a ustring. Adds a NULL terminator. * @remarks The specific error code can be obtained using the get_last_result() method. * Error codes are described in Exceptions section. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[out] dest The destination string * @param[in] src The source string @@ -602,7 +602,7 @@ i18n_uchar *i18n_ustring_copy(i18n_uchar *dest, const i18n_uchar *src); * if the length of @a src is less than @a n. * @remarks The specific error code can be obtained using the get_last_result() method. * Error codes are described in Exceptions section. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[out] dest The destination string * @param[in] src The source string @@ -619,7 +619,7 @@ i18n_uchar *i18n_ustring_copy_n(i18n_uchar *dest, const i18n_uchar *src, int32_t * @details Adds a NULL terminator. Performs a host byte to #i18n_uchar conversion. * @remarks The specific error code can be obtained using the get_last_result() method. * Error codes are described in Exceptions section. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[out] dest The destination string * @param[in] src The source string @@ -637,7 +637,7 @@ i18n_uchar *i18n_ustring_copy_ua(i18n_uchar *dest, const char *src); * Performs a host byte to #i18n_uchar conversion. * @remarks The specific error code can be obtained using the get_last_result() method. * Error codes are described in Exceptions section. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[out] dest The destination string * @param[in] src The source string @@ -654,7 +654,7 @@ i18n_uchar *i18n_ustring_copy_ua_n(i18n_uchar *dest, const char *src, int32_t n) * @details Adds a NULL terminator. Performs an #i18n_uchar to host byte conversion. * @remarks The specific error code can be obtained using the get_last_result() method. * Error codes are described in Exceptions section. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[out] dest The destination string * @param[in] src The source string @@ -672,7 +672,7 @@ char *i18n_ustring_copy_au(char *dest, const i18n_uchar *src); * Performs an #i18n_uchar to host byte conversion. * @remarks The specific error code can be obtained using the get_last_result() method. * Error codes are described in Exceptions section. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[out] dest The destination string * @param[in] src The source string @@ -688,7 +688,7 @@ char *i18n_ustring_copy_au_n(char *dest, const i18n_uchar *src, int32_t n); * @brief Synonym for memcpy(), but with #i18n_uchar characters only. * @remarks The specific error code can be obtained using the get_last_result() method. * Error codes are described in Exceptions section. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[out] dest The destination string * @param[in] src The source string (can be NULL/invalid if count<=0) @@ -704,7 +704,7 @@ i18n_uchar *i18n_ustring_mem_copy(i18n_uchar *dest, const i18n_uchar *src, int32 * @brief Synonym for memmove(), but with #i18n_uchar characters only. * @remarks The specific error code can be obtained using the get_last_result() method. * Error codes are described in Exceptions section. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[out] dest The destination string * @param[in] src The source string (can be NULL/invalid if count<=0) @@ -720,7 +720,7 @@ i18n_uchar *i18n_ustring_mem_move(i18n_uchar *dest, const i18n_uchar *src, int32 * @brief Initialize count characters of dest to c. * @remarks The specific error code can be obtained using the get_last_result() method. * Error codes are described in Exceptions section. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[out] dest The destination string * @param[in] c The character to initialize the string. @@ -736,7 +736,7 @@ i18n_uchar *i18n_ustring_mem_set(i18n_uchar *dest, const i18n_uchar c, int32_t c * @brief Compare the first count #i18n_uchar characters of each buffer. * @remarks The specific error code can be obtained using the get_last_result() method. * Error codes are described in Exceptions section. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[in] buf1 The first string to compare. * @param[in] buf2 The second string to compare. @@ -754,7 +754,7 @@ int32_t i18n_ustring_mem_compare(const i18n_uchar *buf1, const i18n_uchar *buf2, * @details This is different in UTF-16 from #i18n_ustring_mem_compare() if supplementary characters are present. For details, see #i18n_ustring_compare_binary_order(). * @remarks The specific error code can be obtained using the get_last_result() method. * Error codes are described in Exceptions section. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[in] s1 A string to compare. * @param[in] s2 A string to compare. @@ -772,7 +772,7 @@ int32_t i18n_ustring_mem_compare_code_point_order(const i18n_uchar *s1, const i1 * @details A surrogate code point is found only if its match in the text is not part of a surrogate pair. A NULL character is found at the string terminator. * @remarks The specific error code can be obtained using the get_last_result() method. * Error codes are described in Exceptions section. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[in] s The string to search (contains count #i18n_uchar characters). * @param[in] c The BMP code point to find. @@ -792,7 +792,7 @@ i18n_uchar *i18n_ustring_mem_char(const i18n_uchar *s, i18n_uchar c, int32_t cou * @details A surrogate code point is found only if its match in the text is not part of a surrogate pair. A NULL character is found at the string terminator. * @remarks The specific error code can be obtained using the get_last_result() method. * Error codes are described in Exceptions section. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[in] s The string to search (contains count #i18n_uchar characters). * @param[in] c The code point to find. @@ -809,7 +809,7 @@ i18n_uchar *i18n_ustring_mem_char32(const i18n_uchar *s, i18n_uchar32 c, int32_t * @details A surrogate code point is found only if its match in the text is not part of a surrogate pair. A NULL character is found at the string terminator. * @remarks The specific error code can be obtained using the get_last_result() method. * Error codes are described in Exceptions section. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[in] s The string to search (contains count #i18n_uchar characters). * @param[in] c The BMP code point to find. @@ -829,7 +829,7 @@ i18n_uchar *i18n_ustring_mem_r_char(const i18n_uchar *s, i18n_uchar c, int32_t c * @details A surrogate code point is found only if its match in the text is not part of a surrogate pair. A NULL character is found at the string terminator. * @remarks The specific error code can be obtained using the get_last_result() method. * Error codes are described in Exceptions section. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[in] s The string to search (contains count #i18n_uchar characters). * @param[in] c The code point to find. @@ -854,7 +854,7 @@ i18n_uchar *i18n_ustring_mem_r_char32(const i18n_uchar *s, i18n_uchar32 c, int32 * If an escape sequence is ill-formed, this method returns an empty string. An example of an ill-formed sequence is "\\u" followed by fewer than 4 hex digits. * @remarks The specific error code can be obtained using the get_last_result() method. * Error codes are described in Exceptions section. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[in] src a zero-terminated string of invariant characters * @param[in] dest pointer to buffer to receive converted and unescaped text and, if there is room, a zero terminator. May be NULL for preflighting, in which case no #i18n_uchar characters will be written, @@ -875,7 +875,7 @@ int32_t i18n_ustring_unescape(const char *src, i18n_uchar *dest, int32_t dest_ca * See documentation of #i18n_ustring_unescape() for a list of recognized sequences. * @remarks The specific error code can be obtained using the get_last_result() method. * Error codes are described in Exceptions section. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[in] char_at callback function that returns a #i18n_uchar of the source text given an offset and a context pointer. * @param[in] offset pointer to the offset that will be passed to char_at. The offset value will be updated upon return to point after the last parsed character of the escape sequence. @@ -896,7 +896,7 @@ i18n_uchar32 i18n_ustring_unescape_at(i18n_ustring_unescape_char_at_cb char_at, * @details Casing is locale-dependent and context-sensitive. * The result may be longer or shorter than the original. * The source string and the destination buffer are allowed to overlap. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[out] dest A buffer for the result string\n The result will be zero-terminated if * the buffer is large enough. @@ -921,7 +921,7 @@ int32_t i18n_ustring_to_upper(i18n_uchar *dest, int32_t dest_capacity, const i18 * @details Casing is locale-dependent and context-sensitive. The result may be longer or shorter than the original. The source string and the destination buffer are allowed to overlap. * The result may be longer or shorter than the original. * The source string and the destination buffer are allowed to overlap. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[out] dest A buffer for the result string. The result will be zero-terminated if the buffer is large enough. * @param[in] dest_capacity The size of the buffer (number of #i18n_uchar characters)\n @@ -984,7 +984,7 @@ int32_t i18n_ustring_to_title_new(i18n_uchar *dest, int32_t dest_capacity, const * but there is an option for whether to include or exclude mappings for dotted I and dotless i.\n * The result may be longer or shorter than the original. * The source string and the destination buffer are allowed to overlap. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[out] dest A buffer for the result string\n * The result will be zero-terminated if the buffer is large enough. @@ -1007,7 +1007,7 @@ int32_t i18n_ustring_fold_case(i18n_uchar *dest, int32_t dest_capacity, const i1 * @brief Convert a UTF-16 string to a wchar_t string. * @details If it is known at compile time that wchar_t strings are in UTF-16 or UTF-32, then this function simply calls the fast, dedicated function for that. * Otherwise, two conversions UTF-16 -> default charset -> wchar_t* are performed. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[out] dest A buffer for the result string. The result will be zero-terminated if the buffer is large enough. * @param[in] dest_capacity The size of the buffer (number of wchar_t's).\n @@ -1029,7 +1029,7 @@ wchar_t *i18n_ustring_to_WCS(wchar_t *dest, int32_t dest_capacity, int32_t *dest * @brief Convert a wchar_t string to UTF-16. * @details If it is known at compile time that wchar_t strings are in UTF-16 or UTF-32, then this function simply calls the fast, dedicated function for that. * Otherwise, two conversions wchar_t* -> default charset -> UTF-16 are performed. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[out] dest A buffer for the result string. The result will be zero-terminated if the buffer is large enough. * @param[in] dest_capacity The size of the buffer (number of #i18n_uchar characters).\n @@ -1050,7 +1050,7 @@ i18n_uchar *i18n_ustring_from_WCS(i18n_uchar *dest, int32_t dest_capacity, int32 /** * @brief Converts a UTF-16 string to UTF-8. * @details If the input string is not well-formed, then the #I18N_ERROR_INVALID_CHAR_FOUND error code is set. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[out] dest A buffer for the result string.\n * The result will be zero-terminated if the buffer is large enough. @@ -1076,7 +1076,7 @@ char *i18n_ustring_to_UTF8(char *dest, int32_t dest_capacity, int32_t *dest_len, /** * @brief Converts a UTF-8 string to UTF-16. * @details If the input string is not well-formed, then the #I18N_ERROR_INVALID_CHAR_FOUND error code is set. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[out] dest A buffer for the result string.\n * The result will be zero-terminated if the buffer is large enough. @@ -1101,7 +1101,7 @@ i18n_uchar *i18n_ustring_from_UTF8(i18n_uchar *dest, int32_t dest_capacity, int3 /** * @brief Convert a UTF-16 string to UTF-8. * Same as #i18n_ustring_to_UTF8() except for the additional sub_char which is output for illegal input sequences, instead of stopping with the #I18N_ERROR_INVALID_CHAR_FOUND error code. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[out] dest A buffer for the result string.\n * The result will be zero-terminated if the buffer is large enough. @@ -1131,7 +1131,7 @@ char *i18n_ustring_to_UTF8_with_sub(char *dest, int32_t dest_capacity, int32_t * /** * @brief Convert a UTF-8 string to UTF-16. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[out] dest A buffer for the result string.\n * The result will be zero-terminated if the buffer is large enough. @@ -1172,7 +1172,7 @@ i18n_uchar *i18n_ustring_from_UTF8_with_sub(i18n_uchar *dest, int32_t dest_capac * - Non-shortest forms are not detected and will result in "spoofing" output.\n * For further performance improvement, if src_len is given (>=0), then it must be dest_capacity>=src_len.\n * There is no inverse i18n_ustring_to_UTF8_lenient() function because there is practically no performance gain from not checking that a UTF-16 string is well-formed. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[out] dest A buffer for the result string.\n * The result will be zero-terminated if the buffer is large enough. @@ -1202,7 +1202,7 @@ i18n_uchar *i18n_ustring_from_UTF8_lenient(i18n_uchar *dest, int32_t dest_capaci /** * @brief Convert a UTF-16 string to UTF-32. * @details If the input string is not well-formed, then the #I18N_ERROR_INVALID_CHAR_FOUND error code is set. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[out] dest A buffer for the result string.\n * The result will be zero-terminated if the buffer is large enough. @@ -1228,7 +1228,7 @@ i18n_uchar32 *i18n_ustring_to_UTF32(i18n_uchar32 *dest, int32_t dest_capacity, i /** * @brief Convert a UTF-32 string to UTF-16. * @details If the input string is not well-formed, then the #I18N_ERROR_INVALID_CHAR_FOUND error code is set. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[out] dest A buffer for the result string.\n * The result will be zero-terminated if the buffer is large enough. @@ -1254,7 +1254,7 @@ i18n_uchar *i18n_ustring_from_UTF32(i18n_uchar *dest, int32_t dest_capacity, int /** * @brief Convert a UTF-16 string to UTF-32. * @details Same as #i18n_ustring_to_UTF32() except for the additional sub_char which is output for illegal input sequences, instead of stopping with the #I18N_ERROR_INVALID_CHAR_FOUND error code. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[out] dest A buffer for the result string.\n * The result will be zero-terminated if the buffer is large enough. @@ -1285,7 +1285,7 @@ i18n_uchar32 *i18n_ustring_to_UTF32_with_sub(i18n_uchar32 *dest, int32_t dest_ca /** * @brief Convert a UTF-32 string to UTF-16. * Same as #i18n_ustring_from_UTF32() except for the additional sub_char which is output for illegal input sequences, instead of stopping with the #I18N_ERROR_INVALID_CHAR_FOUND error code. - * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @since_tizen 2.3 * * @param[out] dest A buffer for the result string.\n * The result will be zero-terminated if the buffer is large enough.