/**
* @brief Enumeration for error codes of Bundle.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
*/
typedef enum {
BUNDLE_ERROR_NONE = TIZEN_ERROR_NONE, /**< Successful */
/**
* @brief The bundle handle.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
*/
typedef struct _bundle_t bundle;
/**
* @brief The encoded data type.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @see bundle_encode()
* @see bundle_decode()
*/
/**
* @brief Enumeration for key-value pair types.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
*/
enum bundle_type_property {
BUNDLE_TYPE_ARRAY = 0x0100, /**< Array type */
/**
* @brief Enumeration for bundle types.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
*/
enum bundle_type {
BUNDLE_TYPE_NONE = -1, /**< None */
/**
* @brief The key-value pair handle.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @see bundle_iterator_t
*/
typedef struct keyval_t bundle_keyval_t;
/**
* @brief Called for every key-value pair.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] key The key of key-value pair
* @param[in] type The type of bundle
* @param[in] kv The handle of key-value pair
/**
* @brief Creates a bundle object.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @remarks The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.
* @return The bundle object,
* @c NULL - Failure
/**
* @brief Frees the given bundle object with key-value pairs in it.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] b The bundle object to be freed
* @return The operation result
* @retval #BUNDLE_ERROR_NONE Success
/**
* @brief Adds a strings array type key-value pair into a given bundle.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] b The bundle object
* @param[in] key The key
* @param[in] str_array The string type value; if @c NULL, an empty array is created; you can change an item with
/**
* @brief Deletes a key-value object with the given key.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] b The bundle object
* @param[in] key The given key
* @return The operation result
/**
* @brief Gets a string array from a given key.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @remarks You MUST NOT free or modify the returned string. \n
* The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.
* @param[in] b The bundle object
/**
* @brief Gets the number of bundle items.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] b The bundle object
* @return The number of bundle items
* @pre @a b must be a valid bundle object.
/**
* @brief Gets the type of the value with a given key.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @remarks The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.
* @param[in] b A bundle
* @param[in] key A key in the bundle
/**
* @brief Duplicates a given bundle object.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ * @since_tizen 2.4
* @remarks The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.
* The returned value should be released using bundle_free().
* @param[in] b_from The bundle object to be duplicated
/**
* @brief Iterates a callback function for each key-value pair in a given bundle.
* @details Supports all types of values.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @remarks The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section. \n
* This function supports all types.
* @param[in] b The bundle object
/**
* @brief Gets the type of a key-value pair.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @remarks The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.
* @param[in] kv A bundle_keyval_t object
* @return The type of @a kv,
/**
* @brief Determines whether the type of a key-value pair is an array.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @remarks The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.
* @param[in] kv A bundle_keyval_t object
* @return The operation result
/**
* @brief Gets the value and size of the value from a key-value pair of basic type.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @remarks You must not free @a val.
* @param[in] kv A bundle_keyval_t object
* @param[out] val The value
/**
* @brief Gets the value array, length of the array, and size of each array item.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] kv A bundle_keyval_t object
* @param[out] array_val The array pointer of values
* @param[out] array_len The length of @a array_val
/**
* @brief Encodes a bundle to the bundle_raw format (uses base64 format).
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] b The bundle object
* @param[out] r The returned bundle_raw data(byte data)
* @a r MUST BE FREED by free(r)
/**
* @brief Deserializes bundle_raw and gets the bundle object.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @remarks The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.
* The returned value should be released using bundle_free().
* @param[in] r The bundle_raw data to be converted to bundle object
/**
* @brief Adds a string type key-value pair into a bundle.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] b The bundle object
* @param[in] key The key
* @param[in] str The string type value
/**
* @brief Adds a byte sequence type key-value pair into a bundle.
* @details The bundle will contain a copy of the added byte sequence.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] b The bundle object
* @param[in] key The key
* @param[in] bytes The byte sequence
/**
* @brief Gets the string value with the given key.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @remarks You must not free str.
* @param[in] b The bundle object
* @param[in] key The key
/**
* @brief Gets the byte sequence with the given key.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @remarks You must not free @a bytes.
* @param[in] b The bundle object
* @param[in] key The key
/**
* @brief Called for every key-value pair.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @remarks This type is obsolete. You must not use this type any more.
* @see bundle_iterate()
*/
/**
* @brief Adds a string type key-value pair into a given bundle.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] b The bundle object
* @param[in] key The key
* @param[in] val The value
/**
* @brief Gets a value with a given key.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @remarks You MUST NOT free or modify the returned string!
* @remarks The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.
* @param[in] b The bundle object
/**
* @brief Iterates a callback function for each key-value pairs in a given bundle.
* @details (NOTE: Only BUNDLE_TYPE_STR type values come!)
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @remarks The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.
* @remarks This function is obsolete and does not give values whose types are not BUNDLE_TYPE_STR.
* @param[in] b The bundle object
/**
* @brief Determines whether the type of a key-value pair is measurable.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @remarks The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.
* @param[in] kv A bundle_keyval_t object
* @return The operation result
/**
* @brief Frees the encoded rawdata.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] r The rawdata
* @return The operation result
* @retval #BUNDLE_ERROR_NONE Success
/**
* @brief Encodes a bundle to the bundle_raw format.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] b The bundle object
* @param[out] r The returned bundle_raw data(byte data)
* @a r MUST BE FREED by free(r)
/**
* @brief Deserializes bundle_raw and gets a bundle object.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @remarks The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.
* @param[in] r The bundle_raw data to be converted to a bundle object
* @param[in] len The size of @a r
/**
* @brief Exports bundle to @a argv.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @remarks The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.
* @param[in] b The bundle object
* @param[out] argv The pointer of the string array; \n
/**
* @brief Frees the exported @a argv.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @remarks You must not use this API when you use global @a argv.
* @param[in] argc The number of args, which is the return value of bundle_export_to_argv()
* @param[in] argv The array from bundle_export_to_argv()
/**
* @brief Imports a bundle from @a argv.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @remarks The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.
* @param[in] argc The argument count
* @param[in] argv The argument vector
/**
* @brief Sets a value of string array elements.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] b The bundle object
* @param[in] key The key
* @param[in] idx The index of the array element to be changed