Release version 0.9.10
[platform/core/base/bundle.git] / include / bundle.h
index 1cb307a..0c9d29e 100644 (file)
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2000 - 2016 Samsung Electronics Co., Ltd. All rights reserved.
+ * Copyright (c) 2000 - 2020 Samsung Electronics Co., Ltd. All rights reserved.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
 extern "C" {
 # endif
 
-#define API __attribute__((visibility("default")))
-#define likely(x) __builtin_expect(x, 1)
-#define unlikely(x) __builtin_expect(x, 0)
-
 /**
  * @brief Enumeration for error codes of Bundle.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
@@ -130,7 +126,7 @@ typedef void (*bundle_iterator_t) (const char *key, const int type, const bundle
  bundle_free(b); // Free the bundle
  * @endcode
  */
-API bundle *bundle_create(void);
+bundle *bundle_create(void);
 
 
 /**
@@ -149,7 +145,7 @@ API bundle *bundle_create(void);
  bundle_free(b); // Free the bundle
  * @endcode
  */
-API int bundle_free(bundle *b);
+int bundle_free(bundle *b);
 
 
 /**
@@ -175,7 +171,7 @@ API int bundle_free(bundle *b);
  bundle_free(b);
  * @endcode
  */
-API int bundle_add_str_array(bundle *b, const char *key, const char **str_array, const int len);
+int bundle_add_str_array(bundle *b, const char *key, const char **str_array, const int len);
 
 
 /**
@@ -198,7 +194,7 @@ API int bundle_add_str_array(bundle *b, const char *key, const char **str_array,
  bundle_free(b);
  * @endcode
  */
-API int bundle_del(bundle *b, const char *key);
+int bundle_del(bundle *b, const char *key);
 
 
 /**
@@ -232,7 +228,7 @@ API int bundle_del(bundle *b, const char *key);
  bundle_free(b);
  * @endcode
  */
-API const char **bundle_get_str_array(bundle *b, const char *key, int *len);
+const char **bundle_get_str_array(bundle *b, const char *key, int *len);
 
 
 /**
@@ -253,7 +249,7 @@ API const char **bundle_get_str_array(bundle *b, const char *key, int *len);
  bundle_free(b);
  * @endcode
  */
-API int bundle_get_count(bundle *b);
+int bundle_get_count(bundle *b);
 
 
 /**
@@ -267,9 +263,9 @@ API int bundle_get_count(bundle *b);
  * @exception #BUNDLE_ERROR_INVALID_PARAMETER Invalid parameter
  * @exception #BUNDLE_ERROR_KEY_NOT_AVAILABLE Key not available
  * @pre @a b must be a valid bundle object.
- * @see bundle_type_t
+ * @see bundle_type
  */
-API int bundle_get_type(bundle *b, const char *key);
+int bundle_get_type(bundle *b, const char *key);
 
 
 /**
@@ -282,7 +278,7 @@ API int bundle_get_type(bundle *b, const char *key);
  *         @c NULL - Failure
  * @exception #BUNDLE_ERROR_NONE Success
  * @exception #BUNDLE_ERROR_INVALID_PARAMETER Invalid parameter
- * @pre @a b must be a valid bundle object.
+ * @pre @a b_from must be a valid bundle object.
  *
  * @code
  #include <bundle.h>
@@ -294,7 +290,7 @@ API int bundle_get_type(bundle *b, const char *key);
  bundle_free(b_dup);
  * @endcode
  */
-API bundle *bundle_dup(bundle *b_from);
+bundle *bundle_dup(bundle *b_from);
 
 
 /**
@@ -350,7 +346,7 @@ API bundle *bundle_dup(bundle *b_from);
  }
  * @endcode
  */
-API void bundle_foreach(bundle *b, bundle_iterator_t iter, void *user_data);
+void bundle_foreach(bundle *b, bundle_iterator_t iter, void *user_data);
 
 
 /**
@@ -365,7 +361,7 @@ API void bundle_foreach(bundle *b, bundle_iterator_t iter, void *user_data);
  * @pre @a kv must be a valid bundle_keyval_t object.
  * @see bundle_foreach()
  */
-API int bundle_keyval_get_type(bundle_keyval_t *kv);
+int bundle_keyval_get_type(bundle_keyval_t *kv);
 
 
 /**
@@ -381,7 +377,7 @@ API int bundle_keyval_get_type(bundle_keyval_t *kv);
  * @pre @a kv must be a valid bundle_keyval_t object.
  * @see bundle_foreach()
  */
-API int bundle_keyval_type_is_array(bundle_keyval_t *kv);
+int bundle_keyval_type_is_array(bundle_keyval_t *kv);
 
 
 /**
@@ -398,7 +394,7 @@ API int bundle_keyval_type_is_array(bundle_keyval_t *kv);
  * @post @a val and @a size are set.
  * @see bundle_foreach()
  */
-API int bundle_keyval_get_basic_val(bundle_keyval_t *kv, void **val, size_t *size);
+int bundle_keyval_get_basic_val(bundle_keyval_t *kv, void **val, size_t *size);
 
 
 /**
@@ -415,7 +411,7 @@ API int bundle_keyval_get_basic_val(bundle_keyval_t *kv, void **val, size_t *siz
  * @post @a array_val, @a array_len, @a array_element_size are set.
  * @see bundle_foreach()
  */
-API int bundle_keyval_get_array_val(bundle_keyval_t *kv, void ***array_val, unsigned int *array_len, size_t **array_element_size);
+int bundle_keyval_get_array_val(bundle_keyval_t *kv, void ***array_val, unsigned int *array_len, size_t **array_element_size);
 
 
 /**
@@ -441,7 +437,7 @@ API int bundle_keyval_get_array_val(bundle_keyval_t *kv, void ***array_val, unsi
  bundle_free(b);
  * @endcode
  */
-API int bundle_encode(bundle *b, bundle_raw **r, int *len);
+int bundle_encode(bundle *b, bundle_raw **r, int *len);
 
 
 /**
@@ -474,7 +470,7 @@ API int bundle_encode(bundle *b, bundle_raw **r, int *len);
  bundle_free(b_dup);
  * @endcode
  */
-API bundle *bundle_decode(const bundle_raw *r, const int len);
+bundle *bundle_decode(const bundle_raw *r, const int len);
 
 
 /**
@@ -498,7 +494,7 @@ API bundle *bundle_decode(const bundle_raw *r, const int len);
  bundle_free(b);
  * @endcode
  */
-API int bundle_add_str(bundle *b, const char *key, const char *str);
+int bundle_add_str(bundle *b, const char *key, const char *str);
 
 
 /**
@@ -528,7 +524,7 @@ API int bundle_add_str(bundle *b, const char *key, const char *str);
  bundle_free(b);
  * @endcode
  */
-API int bundle_add_byte(bundle *b, const char *key, const void *bytes, const size_t size);
+int bundle_add_byte(bundle *b, const char *key, const void *bytes, const size_t size);
 
 
 /**
@@ -557,7 +553,7 @@ API int bundle_add_byte(bundle *b, const char *key, const void *bytes, const siz
  v = NULL;
  * @endcode
  */
-API int bundle_get_str(bundle *b, const char *key, char **str);
+int bundle_get_str(bundle *b, const char *key, char **str);
 
 
 /**
@@ -592,7 +588,7 @@ API int bundle_get_str(bundle *b, const char *key, char **str);
  bundle_free(b); // After freeing b, v and n become a dangling pointer
  * @endcode
  */
-API int bundle_get_byte(bundle *b, const char *key, void **bytes, size_t *size);
+int bundle_get_byte(bundle *b, const char *key, void **bytes, size_t *size);
 
 /**
  * @brief Adds an 'array of byte sequences' type key-value pair into a bundle.
@@ -613,7 +609,7 @@ API int bundle_get_byte(bundle *b, const char *key, void **bytes, size_t *size);
  * @see bundle_get_byte_array()
  * @see bundle_set_byte_array_element()
  */
-API int bundle_add_byte_array(bundle *b, const char *key, const unsigned int len);
+int bundle_add_byte_array(bundle *b, const char *key, const unsigned int len);
 
 /**
  * @brief Sets an element of an array of byte sequences.
@@ -636,7 +632,7 @@ API int bundle_add_byte_array(bundle *b, const char *key, const unsigned int len
  * @see bundle_add_byte_array()
  * @see bundle_get_byte_array()
  */
-API int bundle_set_byte_array_element(bundle *b, const char *key, const unsigned int idx, const void *bytes, const size_t size);
+int bundle_set_byte_array_element(bundle *b, const char *key, const unsigned int idx, const void *bytes, const size_t size);
 
 /**
  * @brief Gets the array of byte sequences with the given key.
@@ -658,7 +654,7 @@ API int bundle_set_byte_array_element(bundle *b, const char *key, const unsigned
  * @see bundle_add_byte_array()
  * @see bundle_set_byte_array_element()
 */
-API int bundle_get_byte_array(bundle *b, const char *key, void ***byte_array, unsigned int *len, unsigned int **array_element_size);
+int bundle_get_byte_array(bundle *b, const char *key, void ***byte_array, unsigned int *len, unsigned int **array_element_size);
 
 #ifdef __cplusplus
 }