path: root/include/calendar.h

/*
 * Copyright (c) 2011 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.
 * You may obtain a copy of the License at
 *
 * http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an AS IS BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */


#ifndef __TIZEN_SOCIAL_CALENDAR_CALENDAR_H__
#define __TIZEN_SOCIAL_CALENDAR_CALENDAR_H__

#include <tizen.h>
#include <time.h>
#include "calendar_attendee.h"
#include "calendar_types.h"


#ifdef __cplusplus
extern "C" {
#endif

/**
 * @addtogroup CAPI_SOCIAL_CALENDAR_MODULE
 * @{
 */

/**
 * @brief Connects to the calendar service.
 *
 * @details Opening connection is necessary to access the calendar database.
 * All operations like inserting, updating, or deleting calendar require opened connection to work properly.
 *
 * @return  0 on success, otherwise a negative error value.
 * @retval  #CALENDAR_ERROR_NONE Successful
 * @retval  #CALENDAR_ERROR_DB_FAILED No access to database
 *
 * @see calendar_disconnect()
 *
 */
int calendar_connect(void);

/**
 * @brief Disconnects the calendar service.
 *
 * @return  0 on success, otherwise a negative error value.
 * @retval  #CALENDAR_ERROR_NONE Successful
 * @retval  #CALENDAR_ERROR_DB_FAILED No access to database
 *
 * @see calendar_connect()
 *
 */
int calendar_disconnect(void);

/**
 * @brief Begins transaction to calendar database
 *
 * @return  0 on success, otherwise a negative error value.
 * @retval  #CALENDAR_ERROR_NONE Successful
 * @retval  #CALENDAR_ERROR_DB_FAILED No access to database
 *
 * @pre     This function requires an open connection to the calendar service by calendar_connect().
 *
 * @see calendar_connect()
 * @see calendar_rollback_transaction()
 * @see calendar_commit_transaction()
 */
int calendar_begin_transaction(void);

/**
 * @brief Rollbacks transaction to calendar database
 *
 * @return  0 on success, otherwise a negative error value.
 * @retval  #CALENDAR_ERROR_NONE Successful
 * @retval  #CALENDAR_ERROR_DB_FAILED No access to database
 *
 * @pre     This function requires an open connection to the calendar service by calendar_connect().
 *
 * @see calendar_connect()
 * @see calendar_begin_transaction()
 * @see calendar_commit_transaction()
 */
int calendar_rollback_transaction(void);

/**
 * @brief Commits transaction to calendar database
 *
 * @return  0 on success, otherwise a negative error value.
 * @retval  #CALENDAR_ERROR_NONE Successful
 * @retval  #CALENDAR_ERROR_DB_FAILED No access to database
 *
 * @pre     This function requires an open connection to the calendar service by calendar_connect().
 *
 * @see calendar_connect()
 * @see calendar_begin_transaction()
 * @see calendar_rollback_transaction()
 */
int calendar_commit_transaction(void);


/**
 * @brief  Registers a callback function to be invoked when any database change occurs.
 *
 * @param[in]   callback    The callback function to invoke
 * @param[in]   type    	The notification type to subscribe
 * @param[in]   user_data    The user data to be passed to the callback function
 *
 * @return  0 on success, otherwise a negative error value.
 * @retval  #CALENDAR_ERROR_NONE                Successful
 * @retval  #CALENDAR_ERROR_INVALID_PARAMETER   Invalid parameter
 *
 * @pre     This function requires an open connection to the calendar service by calendar_connect().
 * @post  calendar_db_changed_cb() will be invoked.
 *
 * @see calendar_db_changed_cb()
 * @see calendar_remove_db_changed_cb()
 * @see	calendar_book_insert_to_db()
 * @see	calendar_book_update_to_db()
 * @see	calendar_book_delete_from_db()
 * @see	calendar_event_insert_to_db()
 * @see	calendar_event_update_to_db()
 * @see	calendar_event_delete_from_db()
 * @see	calendar_todo_insert_to_db()
 * @see	calendar_todo_update_to_db()
 * @see	calendar_todo_delete_from_db()
 */
int calendar_add_db_changed_cb(calendar_db_changed_cb callback, calendar_db_changed_cb_type_e type, void *user_data);

/**
 * @brief	Unregisters the callback function.
 *
 * @param[in]	callback	The callback function to unregister
 * @param[in]   type    	The notification type to unregister callback
 *
 * @return  0 on success, otherwise a negative error value.
 * @retval  #CALENDAR_ERROR_NONE                Successful
 * @retval  #CALENDAR_ERROR_INVALID_PARAMETER   Invalid parameter
 *
 * @pre     This function requires an open connection to the calendar service by calendar_connect().
 * @see calendar_db_changed_cb()
 * @see calendar_add_db_changed_cb()
 */
int calendar_remove_db_changed_cb(calendar_db_changed_cb callback, calendar_db_changed_cb_type_e type);

/**
 * @brief	Gets the calendar database version.
 *
 * @return  0 on success, otherwise a negative error value.
 * @retval  #CALENDAR_ERROR_NONE	Successful
 * @retval	#CALENDAR_ERROR_INVALID_PARAMETER   Invalid parameter
 * @retval  #CALENDAR_ERROR_DB_FAILED	Database operation failure
 *
 * @see calendar_connect()
 * @see calendar_query_event_by_version()
 * @see calendar_query_todo_by_version()
 */
int calendar_get_db_version(int* calendar_db_version);

/**
 * @}
 */

/**
 * @addtogroup CAPI_SOCIAL_CALENDAR_EVENT_MODULE
 * @{
 */


/**
 * @brief Creates a handle to the calendar event.
 * @remarks The calendar event handle must be released with calendar_event_destroy() by you.
 * @remarks   The created handle is not added to calendar database until calendar_event_insert_to_db() is called
 *
 * @param[out] event A new handle to calendar event
 *
 * @return   0 on success, otherwise a negative error value.
 * @retval  #CALENDAR_ERROR_NONE                Successful
 * @retval  #CALENDAR_ERROR_INVALID_PARAMETER   Invalid parameter
 * @retval  #CALENDAR_ERROR_OUT_OF_MEMORY       Out of memory
 *
 * @see calendar_event_destroy()
 *
 */
int calendar_event_create(calendar_event_h *event);

/**
 * @brief Destroys the calendar event handle and releases all its resources.
 *
 * @param[out]  event   The calendar event handle
 *
 * @return  0 on success, otherwise a negative error value.
 * @retval  #CALENDAR_ERROR_NONE                Successful
 * @retval  #CALENDAR_ERROR_INVALID_PARAMETER   Invalid parameter
 *
 * @see calendar_event_create()
 *
 */
int calendar_event_destroy(calendar_event_h event);

/**
 * @brief Adds a calendar event to the calendar database.
 *
 * @param[in]	event               The calendar event handle
 * @param[in]   calendar_book_db_id      The calendar book database ID to which the event insert. \n
 *                       #DEFAULT_EVENT_CALENDAR_BOOK_DB_ID means the default event calendar book on the device
 * @param[out]	event_db_id         The event database ID associated with the calendar event \n
 * If the function fails, it is -1.
 *
 * @return 0 on success, otherwise a negative error value.
 * @retval #CALENDAR_ERROR_NONE Successful
 * @retval #CALENDAR_ERROR_DB_FAILED No access to database
 *
 * @pre     This function requires an open connection to the calendar service by calendar_connect().
 *
 * @see calendar_connect()
 * @see calendar_event_update_to_db()
 * @see calendar_event_delete_from_db()
 */
int calendar_event_insert_to_db(calendar_event_h event, int calendar_book_db_id, int *event_db_id);

/**
 * @brief Removes the calendar event from the calendar database.
 *
 * @param[in]   event_db_id  The database event ID to delete
 *
 * @return 0 on success, otherwise a negative error value.
 * @retval #CALENDAR_ERROR_NONE Successful
 * @retval #CALENDAR_ERROR_DB_FAILED No access to database
 *
 * @pre	This function requires an open connection to the calendar service by calendar_connect().
 *
 * @see calendar_connect()
 * @see	calendar_event_insert_to_db()
 * @see	calendar_event_update_to_db()
 */
int calendar_event_delete_from_db(int event_db_id);

/**
 * @brief Updates the calendar event in the calendar database.
 * @details calendar_event_get_db_id() is called internally to update in the calendar database to get the event ID in the calendar database.
 *
 * @param[in]   event The calendar event handle
 *
 * @return 0 on success, otherwise a negative error value.
 * @retval #CALENDAR_ERROR_NONE					Successful
 * @retval #CALENDAR_ERROR_INVALID_PARAMETER	Invalid parameter
 * @retval #CALENDAR_ERROR_DB_FAILED 			No access to database
 *
 * @pre     This function requires an open connection to the calendar service by calendar_connect().
 * @pre		The event is supposed to be in the calendar database already.
 *
 * @see calendar_connect()
 * @see calendar_event_insert_to_db()
 * @see calendar_event_delete_from_db()
 * @see calendar_event_get_from_db()
 * @see calendar_event_get_db_id()
 */
int calendar_event_update_to_db(calendar_event_h event);

/**
 * @brief Gets the calendar event from the calendar database.
 * @details This function gets the new calendar event handle with the given event database ID from the calendar database. \n
 * The new calendar event handle will be created.
 *
 * @remarks The created calendar event handle must be released with calendar_event_destroy() by you.
 *
 *
 * @param[in]   event_id	The event ID
 * @param[out]  event	The calendar event handle associated with the event database ID
 *
 * @return  0 on success, otherwise a negative error value.
 * @retval  #CALENDAR_ERROR_NONE  Successful
 * @retval  #CALENDAR_ERROR_INVALID_PARAMETER   Invalid parameter
 * @retval  #CALENDAR_ERROR_OUT_OF_MEMORY       Out of memory
 *
 * @pre     This function requires an open connection to the calendar service by calendar_connect().
 *
 * @see calendar_event_destroy()
 */
int calendar_event_get_from_db(int event_db_id, calendar_event_h *event);

/**
 * @brief   Gets the database ID associated with the given calendar event handle.
 *
 * @param[in]   event	The calendar event handle
 * @param[out]  event_db_id	The event database ID fetched from the calendar event handle (default : 0)  \n
 * 0 means the event is not in calendar database.
 *
 * @return  0 on success, otherwise a negative error value.
 * @retval  #CALENDAR_ERROR_NONE                Successful
 * @retval  #CALENDAR_ERROR_INVALID_PARAMETER   Invalid parameter
 *
 * @see calendar_event_insert_to_db()
 * @see calendar_event_delete_from_db()
 */
int calendar_event_get_db_id(calendar_event_h event, int *event_db_id);

/**
 * @brief   Gets The calendar book database ID associated with the given calendar event handle.
 *
 * @param[in]   event			The calendar event handle
 * @param[out]  calendar_book_db_id	The calendar book database ID fetched from the calendar event handle (default : 0)  \n
 * 0 means the event is not in calendar database.
 *
 * @return  0 on success, otherwise a negative error value.
 * @retval  #CALENDAR_ERROR_NONE                Successful
 * @retval  #CALENDAR_ERROR_INVALID_PARAMETER   Invalid parameter
 *
 * @see calendar_event_insert_to_db()
 */
int calendar_event_get_calendar_book_db_id(calendar_event_h event, int *calendar_book_db_id);

/**
 * @brief Gets the subject of the event from the calendar event handle .
 *
 * @remarks @a subject must be released with free() by you.
 *
 * @param [in] event The calendar event handle
 * @param [out] subject The subject of the event  \n If the subject does not exist, it is NULL
 *
 * @return 0 on success, otherwise a negative error value.
 * @retval #CALENDAR_ERROR_NONE Successful
 * @retval #CALENDAR_ERROR_INVALID_PARAMETER Invalid parameter
 *
 * @see calendar_event_set_subject()
 *
*/
int calendar_event_get_subject(calendar_event_h event, char **subject);

/**
 * @brief Sets the subject of the event in the calendar event handle.
 *
 * @param [in] event The calendar event handle
 * @param [in] subject The subject of the event
 *
 * @return 0 on success, otherwise a negative error value.
 * @retval #CALENDAR_ERROR_NONE Successful
 * @retval #CALENDAR_ERROR_INVALID_PARAMETER Invalid parameter
 *
 * @see calendar_event_get_subject()
 */
int calendar_event_set_subject(calendar_event_h event, const char *subject);

/**
 * @brief Gets the description of the event from the calendar event handle.
 *
 * @remarks @a description must be released with free() by you.
 *
 * @param [in] event The calendar event handle
 * @param [out] description The description of the event \n If the description does not exist, it is NULL
 *
 * @return 0 on success, otherwise a negative error value.
 * @retval #CALENDAR_ERROR_NONE					Successful
 * @retval #CALENDAR_ERROR_INVALID_PARAMETER	Invalid parameter
 *
 * @see calendar_event_set_description()
 */
int calendar_event_get_description(calendar_event_h event, char **description);

/**
 * @brief Sets a description of the event in the calendar event handle.
 *
 * @param [in] event The calendar event handle
 * @param [in] description The description of the event
 *
 * @return 0 on success, otherwise a negative error value.
 * @retval #CALENDAR_ERROR_NONE Successful
 * @retval #CALENDAR_ERROR_INVALID_PARAMETER Invalid parameter
 *
 * @see calendar_event_get_description()
 */
int calendar_event_set_description(calendar_event_h event, const char *description);

/**
 * @brief Gets the start time of the event from the calendar event handle.
 *
 * @param [in] event The calendar event handle
 * @param [out] start_time The start date of the event \n
 *								The @a start_time is a unix timestamp since 00:00, Jan 1 1970 UTC.
 *
 * @return 0 on success, otherwise a negative error value.
 * @retval #CALENDAR_ERROR_NONE Successful
 * @retval #CALENDAR_ERROR_INVALID_PARAMETER Invalid parameter
 * @retval #CALENDAR_ERROR_NO_DATA				Data not found
 *
 * @see calendar_event_set_start_time()
 */
int calendar_event_get_start_time(calendar_event_h event, long long int *start_time);

/**
 * @brief Sets a start time of the event in the calendar event handle.
 *
 * @param [in] event The calendar event handle
 * @param [in] start_time The start date of the event \n
 *								The @a start_time is a unix timestamp since 00:00, Jan 1 1970 UTC.
 *
 * @return 0 on success, otherwise a negative error value.
 * @retval #CALENDAR_ERROR_NONE Successful
 * @retval #CALENDAR_ERROR_INVALID_PARAMETER Invalid parameter
 *
 * @see calendar_event_get_start_time()
 */
int calendar_event_set_start_time(calendar_event_h event, long long int start_time);

/**
 * @brief Gets the end time of the event from the calendar event handle.
 *
 * @param [in] event The calendar event handle
 * @param [out] end_time The end date of the event\n
 *								The @a end_time is a unix timestamp since 00:00, Jan 1 1970 UTC.
 *
 * @return 0 on success, otherwise a negative error value.
 * @retval #CALENDAR_ERROR_NONE Successful
 * @retval #CALENDAR_ERROR_INVALID_PARAMETER Invalid parameter
 * @retval #CALENDAR_ERROR_NO_DATA				Data not found
 *
 * @see calendar_event_set_end_time()
 */
int calendar_event_get_end_time(calendar_event_h event, long long int *end_time);

/**
 * @brief Sets the end time of the event in the calendar event handle.
 *
 * @param[in]   event The calendar event handle
 * @param[in]   end_time    The end date of the event\n
 *								The @a end_time is a unix timestamp since 00:00, Jan 1 1970 UTC.
 *
 * @return  0 on success, otherwise a negative error value.
 * @retval  #CALENDAR_ERROR_NONE                Successful
 * @retval  #CALENDAR_ERROR_INVALID_PARAMETER   Invalid parameter
 *
 * @see calendar_event_get_end_time()
 */
int calendar_event_set_end_time(calendar_event_h event, long long int end_time);

/**
 * @brief Gets an all-day event property of the calendar event handle.
 *
 * @param [in] event The calendar event handle
 * @param [out] is_all_day_event @c true if the event lasts for an entire day, otherwise @c false \n
 * (default : @c false)
 *
 * @return 0 on success, otherwise a negative error value.
 * @retval #CALENDAR_ERROR_NONE Successful
 * @retval #CALENDAR_ERROR_INVALID_PARAMETER Invalid parameter
 *
 * @see calendar_event_set_is_all_day_event()
 */
int calendar_event_get_is_all_day_event(calendar_event_h event, bool *is_all_day_event);

/**
 * @brief Sets an all-day event with date range
 *
 * @param [in] event				The calendar event handle
 * @param [in] start_year			Year of start date
 * @param [in] start_month			Month of start date
 * @param [in] start_day			Day of start date
 * @param [in] end_year				Year of end date
 * @param [in] end_month			Month of end date
 * @param [in] end_day				Day of end date
 *
 * @return 0 on success, otherwise a negative error value.
 * @retval #CALENDAR_ERROR_NONE Successful
 * @retval #CALENDAR_ERROR_INVALID_PARAMETER Invalid parameter
 *
 * @see calendar_event_get_is_all_day_event()
 * @see calendar_event_get_all_day_event()
 */
int calendar_event_set_all_day_event(calendar_event_h event, int start_year, int start_month, int start_day,
							int end_year, int end_month, int end_day);

/**
 * @brief Gets an all-day event date range
 *
 * @param [in] event				The calendar event handle
 * @param [out] start_year			Year of start date
 * @param [out] start_month			Month of start date
 * @param [out] start_day			Day of start date
 * @param [out] end_year			Year of end date
 * @param [out] end_month			Month of end date
 * @param [out] end_day				Day of end date
 *
 * @return 0 on success, otherwise a negative error value.
 * @retval #CALENDAR_ERROR_NONE Successful
 * @retval #CALENDAR_ERROR_INVALID_PARAMETER Invalid parameter
 *
 * @see calendar_event_get_is_all_day_event()
 * @see calendar_event_set_all_day_event()
 */
int calendar_event_get_all_day_event(calendar_event_h event, int *start_year, int *start_month, int *start_day,
							int *end_year, int *end_month, int *end_day);

/**
 * @brief Gets the location of the event from the calendar event handle.
 *
 * @remarks @a location must be released with free() by you.
 *
 * @param [in] event The calendar event handle
 * @param [out] location The location of the event \n If the location does not exist, it is NULL
 *
 * @return 0 on success, otherwise a negative error value.
 * @retval #CALENDAR_ERROR_NONE Successful
 * @retval #CALENDAR_ERROR_INVALID_PARAMETER Invalid parameter
 *
 * @see calendar_event_set_location()
 */
int calendar_event_get_location(calendar_event_h event, char **location);

/**
 * @brief Sets a location of the event in the calendar event handle.
 *
 * @param [in] event The calendar event handle
 * @param [in] location The location of the event
 *
 * @return 0 on success, otherwise a negative error value.
 * @retval #CALENDAR_ERROR_NONE Successful
 * @retval #CALENDAR_ERROR_INVALID_PARAMETER Invalid parameter
 *
 * @see calendar_event_get_location()
 */
int calendar_event_set_location(calendar_event_h event, const char *location);

/**
 * @brief Gets the reminder of the event from the calendar event handle.
 * @details The function returns reminder type and interval of the event.
 *
 *
 * @param [in] event The calendar event handle
 * @param [out] reminder_interval_type  The reminder type
 * @param [out] reminder_interval       The interval
 *
 * @return  0 on success, otherwise a negative error value.
 * @retval  #CALENDAR_ERROR_NONE                Successful
 * @retval  #CALENDAR_ERROR_INVALID_PARAMETER   Invalid parameter
 *
 * @see calendar_event_set_reminder()
 */
int calendar_event_get_reminder(calendar_event_h event, calendar_reminder_interval_type_e *reminder_interval_type, int *reminder_interval);

/**
 * @brief Sets a reminder of the event in the calendar event handle.
 *
 * @remarks If reminder is set, the alarm will remind the event with in-house calendar application.
 *
 * @param [in] event The calendar event handle
 * @param [in] reminder_interval_type  The reminder interval type
 * @param [in] reminder_interval  The reminder interval
 *
 * @return 0 on success, otherwise a negative error value.
 * @retval #CALENDAR_ERROR_NONE                 Successful
 * @retval #CALENDAR_ERROR_INVALID_PARAMETER    Invalid parameter
 *
 * @see calendar_event_get_reminder()
 */
int calendar_event_set_reminder(calendar_event_h event, calendar_reminder_interval_type_e reminder_interval_type, int reminder_interval);

/**
 * @brief       Gets the sound file path from the event handle.
 *
 * @remarks @a sound_file_path must be released with free() by you.
 *
 * @param[in]   event          		The calendar event handle
 * @param[out]  sound_file_path		The  sound file path \n
 *						   If @a sound_file_path does not exist, it is NULL
 *
 * @return  0 on success, otherwise a negative error value.
 * @retval  #CALENDAR_ERROR_NONE                    Successful
 * @retval  #CALENDAR_ERROR_INVALID_PARAMETER       Invalid parameter
 *
 * @see  calendar_event_set_reminder_sound_file_path()
 */
int calendar_event_get_reminder_sound_file_path(calendar_event_h event, char **sound_file_path);

/**
 * @brief       Sets the  sound file path to the event handle.
 *
 * @param[in]   event          		The calendar event handle
 * @param[in]   sound_file_path		The  sound file path to set
 *
 * @return 0 on success, otherwise a negative error value.
 * @retval  #CALENDAR_ERROR_NONE                    Successful
 * @retval  #CALENDAR_ERROR_INVALID_PARAMETER       Invalid parameter
 *
 * @see calendar_event_get_reminder_sound_file_path()
 */
int calendar_event_set_reminder_sound_file_path(calendar_event_h event, const char *sound_file_path);

/**
 * @brief   Creates a attendee handle and make adds it to the calendar event.
 *
 * @remarks   The created handle is not added to calendar database until calendar_event_insert_to_db() is called
 *
 * @param[in]   event The calendar event handle
 * @param[out]  attendee A new attendee handle
 *
 * @return  0 on success, otherwise a negative error value.
 * @retval  #CALENDAR_ERROR_NONE            Successful
 * @retval  #CALENDAR_ERROR_OUT_OF_MEMORY   Out of memory
 * @retval  #CALENDAR_ERROR_INVALID_PARAMETER Invalid parameter
 *
 * @see calendar_event_remove_attendee()
 * @see calendar_attendee_set_name()
 * @see calendar_attendee_set_email()
 * @see calendar_attendee_set_phone_number()
 * @see calendar_event_get_attendee_iterator()
 */
int calendar_event_add_attendee(calendar_event_h event, calendar_attendee_h* attendee);

/**
 * @brief   Creates a attendee handle with contact ID and adds it to the calendar event.
 *
 * @details Adds an existing contact as an attendee to an event.  A new attendee record is created, and the name, email address and phone number are populated from the values in the contact record.
 * @remarks   The created handle is not added to calendar database until calendar_event_insert_to_db() is called
 *
 *
 * @param[in]   event The calendar event handle
 * @param[in]   contact_db_id The contact DB ID which is related to attendee
 * @param[out]  attendee A new attendee handle from contact ID in the contacts database
 *
 * @return  0 on success, otherwise a negative error value.
 * @retval  #CALENDAR_ERROR_NONE            Successful
 * @retval  #CALENDAR_ERROR_OUT_OF_MEMORY   Out of memory
 * @retval  #CALENDAR_ERROR_INVALID_PARAMETER Invalid parameter
 *
 * @pre     This function requires an open connection to Contacts Service by contacts_connect().
 *
 * @see calendar_event_remove_attendee()
 * @see calendar_attendee_set_name()
 * @see calendar_attendee_set_email()
 * @see calendar_attendee_set_phone_number()
 * @see calendar_event_get_attendee_iterator()
 * @see contact_get_db_id()
 * @see contact_get_from_db()
 * @see calendar_attendee_get_phone_number()
 */
int calendar_event_add_attendee_with_contact(calendar_event_h event, int contact_db_id, calendar_attendee_h* attendee);

/**
 * @brief Removes the attendee from the calendar event handle.
 *
 *
 * @param[in]   event The calendar event handle
 * @param[in]   attendee The attendee handle
 *
 * @return  0 on success, otherwise a negative error value.
 * @retval  #CALENDAR_ERROR_NONE Successful
 * @retval  #CALENDAR_ERROR_INVALID_PARAMETER Invalid parameter
 *
 * @see calendar_event_add_attendee()
 * @see calendar_event_get_attendee_iterator()
 */
int calendar_event_remove_attendee(calendar_event_h event, calendar_attendee_h attendee);

/**
 * @brief Gets the attendee iterator handle from the event handle.
 *
 * @param[in]   event      The calendar event handle
 * @param[out]  iterator    The attendee iterator handle
 *
 * @return  0 on success, otherwise a negative error value.
 * @retval  #CALENDAR_ERROR_NONE Successful
 * @retval  #CALENDAR_ERROR_INVALID_PARAMETER Invalid parameter
 *
 * @see calendar_attendee_iterator_has_next()
 * @see calendar_attendee_iterator_next()
 *
 */
int calendar_event_get_attendee_iterator(calendar_event_h event, calendar_attendee_iterator_h *iterator);

/**
 * @brief	Gets the last modified time of the event handle.
 *
 * @param[in]   event       The calendar event handle
 * @param[out]  modified_time The last modified time of event \n
 *								The @a modified_time is a unix timestamp since 00:00, Jan 1 1970 UTC.
 *
 * @return  0 on success, otherwise a negative error value.
 * @retval  #CALENDAR_ERROR_NONE				Successful
 * @retval  #CALENDAR_ERROR_INVALID_PARAMETER	Invalid parameter
 * @retval  #CALENDAR_ERROR_NO_DATA             Data not found
 *
 * @see calendar_event_insert_to_db()
 * @see calendar_event_update_to_db()
 */
int calendar_event_get_last_modified_time(calendar_event_h event, long long int *modified_time);

/**
 * @brief   Gets the visibility for the given calendar event handle.
 *
 * @param[in]   event   		The calendar event handle
 * @param[out]  visibility	The visibility of the event \n (default : #CALENDAR_VISIBILITY_PUBLIC)
 *
 * @return  0 on success, otherwise a negative error value.
 * @retval  #CALENDAR_ERROR_NONE                Successful
 * @retval  #CALENDAR_ERROR_INVALID_PARAMETER   Invalid parameter
 *
 * @see calendar_event_set_visibility()
 */
int calendar_event_get_visibility(calendar_event_h event, calendar_visibility_e *visibility);

/**
 * @brief   Sets the visibility for the given calendar event handle.
 *
 * @param[in]   event   		The calendar event handle
 * @param[in]	visibility		The visibility of the event
 *
 * @return  0 on success, otherwise a negative error value.
 * @retval  #CALENDAR_ERROR_NONE                Successful
 * @retval  #CALENDAR_ERROR_INVALID_PARAMETER   Invalid parameter
 *
 * @see calendar_event_get_visibility()
 */
int calendar_event_set_visibility(calendar_event_h event, calendar_visibility_e visibility);

/**
 * @brief   Gets the category for the given calendar event handle.
 * @remarks @a categories must be released with free() by you.
 *
 * @param[in]   event   		The calendar event handle
 * @param[out]  categories	    The category of the event \n Multiple categories are seperated by ","
 *
 * @return  0 on success, otherwise a negative error value.
 * @retval  #CALENDAR_ERROR_NONE                Successful
 * @retval  #CALENDAR_ERROR_INVALID_PARAMETER   Invalid parameter
 *
 * @see calendar_event_set_categories()
 */
int calendar_event_get_categories(calendar_event_h event, char **categories);

/**
 * @brief   Sets the category for the given calendar event handle.
 *
 * @param[in]   event   		The calendar event handle
 * @param[in]	categories		The category of the event \n Multiple categories are seperated by ","
 *
 * @return  0 on success, otherwise a negative error value.
 * @retval  #CALENDAR_ERROR_NONE                Successful
 * @retval  #CALENDAR_ERROR_INVALID_PARAMETER   Invalid parameter
 *
 * @see calendar_event_get_categories()
 */
int calendar_event_set_categories(calendar_event_h event, const char *categories);

/**
 * @brief   Gets the status for the given calendar event handle.
 *
 * @param[in]   event	   		The calendar event handle
 * @param[out]  status			The status of the event \n (default : #CALENDAR_EVENT_STATUS_NONE)
 *
 * @return  0 on success, otherwise a negative error value.
 * @retval  #CALENDAR_ERROR_NONE                Successful
 * @retval  #CALENDAR_ERROR_INVALID_PARAMETER   Invalid parameter
 *
 * @see calendar_event_set_status()
 */
int calendar_event_get_status(calendar_event_h event, calendar_event_status_e *status);

/**
 * @brief   Sets a status for the given calendar event handle.
 *
 * @param[in]  event   		The calendar event handle
 * @param[in]  status		The status of the event
 *
 * @return  0 on success, otherwise a negative error value.
 * @retval  #CALENDAR_ERROR_NONE                Successful
 * @retval  #CALENDAR_ERROR_INVALID_PARAMETER   Invalid parameter
 *
 * @see calendar_event_get_status()
 */
int calendar_event_set_status(calendar_event_h event, calendar_event_status_e status);

/**
 * @brief   Gets the busy status for the given calendar event handle.
 *
 * @param[in]   event	   		The calendar event handle
 * @param[out]  busy_status		The busy status of the event \n (default : #CALENDAR_EVENT_BUSY_STATUS_FREE)
 *
 * @return  0 on success, otherwise a negative error value.
 * @retval  #CALENDAR_ERROR_NONE                Successful
 * @retval  #CALENDAR_ERROR_INVALID_PARAMETER   Invalid parameter
 *
 * @see calendar_event_set_busy_status()
 */
int calendar_event_get_busy_status(calendar_event_h event, calendar_event_busy_status_e *busy_status);

/**
 * @brief   Sets a busy status for the given calendar event handle.
 *
 * @param[in]  event   		The calendar event handle
 * @param[in]  busy_status		The busy status of the event
 *
 * @return  0 on success, otherwise a negative error value.
 * @retval  #CALENDAR_ERROR_NONE                Successful
 * @retval  #CALENDAR_ERROR_INVALID_PARAMETER   Invalid parameter
 *
 * @see calendar_event_get_busy_status()
 */
int calendar_event_set_busy_status(calendar_event_h event, calendar_event_busy_status_e busy_status);

/**
 * @brief   Gets the priority for the given calendar event handle.
 *
 * @param[in]   event	   		The calendar event handle
 * @param[out]  priority		The priority of the event \n (default : #CALENDAR_EVENT_PRIORITY_LOW)
 *
 * @return  0 on success, otherwise a negative error value.
 * @retval  #CALENDAR_ERROR_NONE                Successful
 * @retval  #CALENDAR_ERROR_INVALID_PARAMETER   Invalid parameter
 *
 * @see calendar_event_set_priority()
 */
int calendar_event_get_priority(calendar_event_h event, calendar_event_priority_e *priority);

/**
 * @brief   Sets a priority for the given calendar event handle.
 *
 * @param[in]  todo   		The calendar event handle
 * @param[in]  priority		The priority of the event
 *
 * @return  0 on success, otherwise a negative error value.
 * @retval  #CALENDAR_ERROR_NONE                Successful
 * @retval  #CALENDAR_ERROR_INVALID_PARAMETER   Invalid parameter
 *
 * @see calendar_event_get_priority()
 */
int calendar_event_set_priority(calendar_event_h event, calendar_event_priority_e priority);

/**
 * @brief Gets the UID of the event from the calendar event handle.
 *
 * @remarks @a uid must be released with free() by you.
 *
 * @param [in] event The calendar event handle
 * @param [out] uid The UID of the event \n If the uid does not exist, it is NULL
 *
 * @return 0 on success, otherwise a negative error value.
 * @retval #CALENDAR_ERROR_NONE Successful
 * @retval #CALENDAR_ERROR_INVALID_PARAMETER Invalid parameter
 *
 * @see calendar_event_set_uid()
 */
int calendar_event_get_uid(calendar_event_h event, char **uid);

/**
 * @brief Sets a UID of the event in the calendar event handle.
 *
 * @param [in] event The calendar event handle
 * @param [in] uid The UID of the event
 *
 * @return 0 on success, otherwise a negative error value.
 * @retval #CALENDAR_ERROR_NONE Successful
 * @retval #CALENDAR_ERROR_INVALID_PARAMETER Invalid parameter
 *
 * @see calendar_event_get_uid()
 */
int calendar_event_set_uid(calendar_event_h event, const char *uid);

/**
 * @brief   Gets the timezone details for the given calendar event handle.
 *
 * @remark @a timezone_name must be released with free() by you.
 *
 * @param[in]   event   					The calendar event handle
 * @param[out]  timezone_name				The time zone name
 *
 * @return  0 on success, otherwise a negative error value.
 * @retval  #CALENDAR_ERROR_NONE                Successful
 * @retval  #CALENDAR_ERROR_INVALID_PARAMETER   Invalid parameter
 *
 * @see calendar_foreach_timezone()
 * @see calendar_event_set_timezone()
 */
int calendar_event_get_timezone(calendar_event_h event, char** timezone_name);

/**
 * @brief   Sets a timezone for the given calendar event handle.
 *
 * @param[in]   event   					The calendar event handle
 * @param[in]  timezone_name			The time zone name
 *
 * @return  0 on success, otherwise a negative error value.
 * @retval  #CALENDAR_ERROR_NONE                Successful
 * @retval  #CALENDAR_ERROR_INVALID_PARAMETER   Invalid parameter
 *
 * @see calendar_foreach_timezone()
 * @see calendar_event_get_timezone()
 */
int calendar_event_set_timezone(calendar_event_h event, const char* timezone_name);

/**
 * @brief   Gets events as array from vCalendar
 *
 * @remarks     @a event_array must be released with calendar_event_free_event_array() by you.
 *
 * @param[in]   vcalendar_stream        The vCalendar stream to convert
 * @param[out]   event_array				The event array
 * @param[out]   length						The length of the event array
 *
 * @return  0 on success, otherwise a negative error value.
 * @retval  #CALENDAR_ERROR_NONE                Successful
 * @retval  #CALENDAR_ERROR_OUT_OF_MEMORY       Out of memory
 * @retval  #CALENDAR_ERROR_INVALID_PARAMETER   Invalid parameter
 * @retval  #CALENDAR_ERROR_OUT_OF_MEMORY       Out of memory
 *
 * @see calendar_event_free_event_array()
 * @see calendar_event_get_vcalendar_from_db()
 */
int calendar_event_get_event_array_from_vcalendar(const char *vcalendar_stream, calendar_event_h **event_array, int *length);

/**
 * @brief   Gets vCalendar with event database ID from the calendar database
 *
 * @remarks @a vcalendar_stream must be released with free() by you.
 *
 * @param[in]   event_db_id_array		The event database ID array
 * @param[in]   length     		  		Length of event database ID array
 * @param[out]  vcalendar_stream           The vCalendar stream to convert
 *
 * @return  0 on success, otherwise a negative error value.
 * @retval  #CALENDAR_ERROR_NONE                Successful
 * @retval  #CALENDAR_ERROR_INVALID_PARAMETER   Invalid parameter
 *
 * @see calendar_connect()
 * @see calendar_event_get_event_array_from_vcalendar()
 */
int calendar_event_get_vcalendar_from_db(int *event_db_id_array, int length, char **vcalendar_stream);

/**
 * @brief Gets information whether an event is recurrence or not.
 *
 * @param [in] event The calendar event handle
 * @param [out] is_recurrence @c true if the event is recurrence event, otherwise @c false \n
 * (default : @c false)
 *
 * @return 0 on success, otherwise a negative error value.
 * @retval #CALENDAR_ERROR_NONE Successful
 * @retval #CALENDAR_ERROR_INVALID_PARAMETER Invalid parameter
 *
 * @see calendar_event_set_recurrence_frequency()
 */
int calendar_event_get_is_recurrence(calendar_event_h event, bool *is_recurrence);

/**
 * @brief Gets the recurrence frequency of the event from the calendar event handle.
 *
 * @param[in]   event The calendar event handle
 * @param[out]  recurrence_frequency    The recurrence frequency of the event
 *
 * @return 0 on success, otherwise a negative error value.
 * @retval  #CALENDAR_ERROR_NONE                Successful
 * @retval  #CALENDAR_ERROR_INVALID_PARAMETER   Invalid parameter
 *
 * @see calendar_event_set_recurrence_frequency()
 * @see calendar_event_set_recurrence_byday()
 * @see calendar_event_get_recurrence_byday()
 */
int calendar_event_get_recurrence_frequency(calendar_event_h event, calendar_recurrence_frequency_e *recurrence_frequency);

/**
 * @brief Sets a recurrence frequency of the event to the calendar event handle.
 *
 * @param [in] event The calendar event handle
 * @param [in] recurrence_frequency The recurrence frequency of the event \n
 * If you set it to #CALENDAR_RECURRENCE_WEEKLY, you have to set calendar_event_set_recurrence_byday().
 *
 * @return 0 on success, otherwise a negative error value.
 * @retval #CALENDAR_ERROR_NONE Successful
 * @retval #CALENDAR_ERROR_INVALID_PARAMETER Invalid parameter
 *
 * @see calendar_event_get_recurrence_frequency()
 * @see calendar_event_set_recurrence_byday()
 * @see calendar_event_get_recurrence_byday()
 */
int calendar_event_set_recurrence_frequency(calendar_event_h event, calendar_recurrence_frequency_e recurrence_frequency);

/**
 * @brief Gets the recurrence interval of the event from the calendar event handle.
 *
 * @param[in]   event The calendar event handle
 * @param[out]  recurrence_interval    The recurrence interval of the event
 *
 * @return 0 on success, otherwise a negative error value.
 * @retval  #CALENDAR_ERROR_NONE                Successful
 * @retval  #CALENDAR_ERROR_INVALID_PARAMETER   Invalid parameter
 *
 * @see calendar_event_set_recurrence_interval()
 * @see calendar_event_get_recurrence_frequency()
 */
int calendar_event_get_recurrence_interval(calendar_event_h event, int *recurrence_interval);

/**
 * @brief Sets a recurrence interval of the event in the calendar event handle.
 *
 * @param [in] event The calendar event handle
 * @param [in] recurrence_interval The recurrence interval of the event
 *
 * @return 0 on success, otherwise a negative error value.
 * @retval #CALENDAR_ERROR_NONE Successful
 * @retval #CALENDAR_ERROR_INVALID_PARAMETER Invalid parameter
 *
 * @see calendar_event_get_recurrence_interval()
 * @see calendar_event_set_recurrence_frequency()
 */
int calendar_event_set_recurrence_interval(calendar_event_h event, int recurrence_interval);

/**
 * @brief Gets the recurrence count of the event from the calendar event handle.
 *
 * @param[in]   event The calendar event handle
 * @param[out]  recurrence_count    The recurrence type of the event
 *
 * @return 0 on success, otherwise a negative error value.
 * @retval  #CALENDAR_ERROR_NONE                Successful
 * @retval  #CALENDAR_ERROR_INVALID_PARAMETER   Invalid parameter
 *
 * @see calendar_event_set_recurrence_count()
 * @see calendar_event_get_recurrence_frequency()
 */
int calendar_event_get_recurrence_count(calendar_event_h event, int *recurrence_count);

/**
 * @brief Sets a recurrence count of the event to the calendar event handle.
 *
 * @param [in] event The calendar event handle
 * @param [in] recurrence_count The recurrence count of the event
 *
 * @return 0 on success, otherwise a negative error value.
 * @retval #CALENDAR_ERROR_NONE Successful
 * @retval #CALENDAR_ERROR_INVALID_PARAMETER Invalid parameter
 *
 * @see calendar_event_get_recurrence_count()
 * @see calendar_event_set_recurrence_frequency()
 */
int calendar_event_set_recurrence_count(calendar_event_h event, int recurrence_count);

/**
 * @brief Gets the recurrence ending time of the event from the calendar event handle.
 * @details  If recurrence frequency of the event is activated, then @a recurrence_until_date indicates recurrence ending time.
 *
 * @param [in] event The calendar event handle
 * @param [out] recurrence_until_date The ending time of the recurrence event \n
 *								The @a recurrence_until_date is a unix timestamp since 00:00, Jan 1 1970 UTC.
 *
 * @return 0 on success, otherwise a negative error value.
 * @retval #CALENDAR_ERROR_NONE Successful
 * @retval #CALENDAR_ERROR_INVALID_PARAMETER Invalid parameter
 * @retval #CALENDAR_ERROR_NO_DATA				Data not found
 *
 * @see calendar_event_set_recurrence_until_date()
 */
int calendar_event_get_recurrence_until_date(calendar_event_h event, long long int *recurrence_until_date);

/**
 * @brief Sets a recurrence end time of the event in the calendar event handle.
 *
 * @param [in] event The calendar event handle
 * @param [in] recurrence_until_date  The end time of the recurrence event \n
 *								The @a recurrence_until_date is a unix timestamp since 00:00, Jan 1 1970 UTC.
 *
 *
 * @return 0 on success, otherwise a negative error value.
 * @retval #CALENDAR_ERROR_NONE Successful
 * @retval #CALENDAR_ERROR_INVALID_PARAMETER Invalid parameter
 *
 * @pre @a event has a recurrence frequency property using calendar_event_set_recurrence_frequency().
 *
 * @see calendar_event_get_recurrence_until_date()
 */
int calendar_event_set_recurrence_until_date(calendar_event_h event, long long int recurrence_until_date);

/**
 * @brief Gets the recurrence ending date for all day event
 * @details  If recurrence frequency of the event is activated, then @a recurrence_until_date indicates recurrence ending time.
 *
 * @param [in] event				The calendar event handle
 * @param [out] until_year			Year of until date
 * @param [out] until_month			Month of until date
 * @param [out] until_day				Day of until date
 *
 * @return 0 on success, otherwise a negative error value.
 * @retval #CALENDAR_ERROR_NONE Successful
 * @retval #CALENDAR_ERROR_INVALID_PARAMETER Invalid parameter
 * @retval #CALENDAR_ERROR_NO_DATA				Data not found
 *
 * @see calendar_event_set_all_day_recurrence_until_date()
 */
int calendar_event_get_all_day_recurrence_until_date(calendar_event_h event, int *until_year, int *until_month, int *until_day);

/**
 * @brief Sets a recurrence end date for all day event
 *
 * @param [in] event				The calendar event handle
 * @param [in] until_year				Year of until date
 * @param [in] until_month			Month of until date
 * @param [in] until_day				Day of until date
 *
 * @return 0 on success, otherwise a negative error value.
 * @retval #CALENDAR_ERROR_NONE Successful
 * @retval #CALENDAR_ERROR_INVALID_PARAMETER Invalid parameter
 *
 * @pre @a event has a recurrence frequency property using calendar_event_set_recurrence_frequency().
 *
 * @see calendar_event_get_all_day_recurrence_until_date()
 */
int calendar_event_set_all_day_recurrence_until_date(calendar_event_h event, int until_year, int until_month, int until_day);

/**
 * @brief Gets the recurrence frequency of the event from the calendar event handle.
 * @details This rule is "BYDAY" rule in RFC 5545 iCalendar http://http://www.ietf.org/rfc/rfc2445.txt
 *
 * @remarks @a byday must be released with free() by you.
 *
 * @param[in]   event		The calendar event handle
 * @param[out]  byday		The "BYDAY" of the reccurrence event \n combination of [[-]1~5]MO, TU, WE, TH, FR, SA, SU with ","
 *
 * @return 0 on success, otherwise a negative error value.
 * @retval  #CALENDAR_ERROR_NONE                Successful
 * @retval  #CALENDAR_ERROR_INVALID_PARAMETER   Invalid parameter
 *
 * @see calendar_event_set_recurrence_byday()
 * @see calendar_event_set_recurrence_frequency()
 * @see calendar_event_get_recurrence_frequency()
 */
int calendar_event_get_recurrence_byday(calendar_event_h event, char **byday);

/**
 * @brief   Sets the days of week flag to the calendar event handle.
 * @details This rule is "BYDAY" rule in RFC 5545 iCalendar http://http://www.ietf.org/rfc/rfc2445.txt
 *
 * @param[in]   event	 	The calendar event handle
 * @param[in]   byday    	The "BYDAY" of the reccurrence event \n combination of [[-]1~5]MO, TU, WE, TH, FR, SA, SU with ","
 *
 * @return 0 on success, otherwise a negative error value.
 * @retval  #CALENDAR_ERROR_NONE                Successful
 * @retval  #CALENDAR_ERROR_INVALID_PARAMETER   Invalid parameter
 *
 * @see calendar_event_get_recurrence_byday()
 * @see calendar_event_set_recurrence_frequency()
 * @see calendar_event_get_recurrence_frequency()
 */
int calendar_event_set_recurrence_byday(calendar_event_h event, const char* byday);

/**
 * @brief Gets the recurrence position flag of the event from the calendar event handle.
 * @details This rule is "BYSETPOS" rule in RFC 5545 iCalendar http://http://www.ietf.org/rfc/rfc2445.txt
 *
 * @remarks @a bysetpos must be released with free() by you.
 *
 * @param[in]   event The calendar event handle
 * @param[out]  bysetpos    The "BYSETPOS" of the reccurrence event \n combination of 1 to 366 or -366 to -1 with ","
 *
 * @return 0 on success, otherwise a negative error value.
 * @retval  #CALENDAR_ERROR_NONE                Successful
 * @retval  #CALENDAR_ERROR_INVALID_PARAMETER   Invalid parameter
 *
 * @see calendar_event_set_recurrence_bysetpos()
 */
int calendar_event_get_recurrence_bysetpos(calendar_event_h event, char **bysetpos);

/**
 * @brief Sets a recurrence position flag of the event to the calendar event handle.
 * @details This rule is "BYSETPOS" rule in RFC 5545 iCalendar http://http://www.ietf.org/rfc/rfc2445.txt
 *
 * @param[in] event The calendar event handle
 * @param[in] bysetpos		The "BYSETPOS" of the reccurrence event \n combination of 1 to 366 or -366 to -1 with ","
 *
 * @return 0 on success, otherwise a negative error value.
 * @retval #CALENDAR_ERROR_NONE Successful
 * @retval #CALENDAR_ERROR_INVALID_PARAMETER Invalid parameter
 *
 * @see calendar_event_get_recurrence_bysetpos()
 */
int calendar_event_set_recurrence_bysetpos(calendar_event_h event, const char* bysetpos);

/**
 * @brief Gets a recurrence BYMONTHDAY of the event to the calendar event handle.
 * @details This rule is "BYMONTHDAY" rule in RFC 5545 iCalendar http://http://www.ietf.org/rfc/rfc2445.txt
 *
 * @remarks @a bymonthday must be released with free() by you.
 *
 * @param[in] event				The calendar event handle
 * @param[out] bymonthday		The BYMONTHDAY of the reccurrence event \n combination of 1 to 31 or -31 to -1 with ","
 *
 * @return 0 on success, otherwise a negative error value.
 * @retval #CALENDAR_ERROR_NONE Successful
 * @retval #CALENDAR_ERROR_INVALID_PARAMETER Invalid parameter
 */
int calendar_event_get_recurrence_bymonthday(calendar_event_h event, char **bymonthday);

/**
 * @brief Sets a recurrence BYMONTHDAY of the event to the calendar event handle.
 * @details This rule is "BYMONTHDAY" rule in RFC 5545 iCalendar http://http://www.ietf.org/rfc/rfc2445.txt
 *
 * @param[in] event				The calendar event handle
 * @param[in] bymonthday		The BYMONTHDAY of the reccurrence event \n combination of 1 to 31 or -31 to -1 with ","
 *
 * @return 0 on success, otherwise a negative error value.
 * @retval #CALENDAR_ERROR_NONE Successful
 * @retval #CALENDAR_ERROR_INVALID_PARAMETER Invalid parameter
 */
int calendar_event_set_recurrence_bymonthday(calendar_event_h event, const char* bymonthday);

/**
 * @brief Gets a recurrence BYMONTH of the event to the calendar event handle.
 * @details This rule is "BYMONTH" rule in RFC 5545 iCalendar http://http://www.ietf.org/rfc/rfc2445.txt
 *
 * @remarks @a bymonth must be released with free() by you.
 *
 * @param[in] event				The calendar event handle
 * @param[out] bymonth			The BYMONTH of the reccurrence event \n combination of 1 to 12 with ","
 *
 * @return 0 on success, otherwise a negative error value.
 * @retval #CALENDAR_ERROR_NONE Successful
 * @retval #CALENDAR_ERROR_INVALID_PARAMETER Invalid parameter
 */
int calendar_event_get_recurrence_bymonth(calendar_event_h event, char** bymonth);

/**
 * @brief Sets a recurrence BYMONTH of the event to the calendar event handle.
 * @details This rule is "BYMONTH" rule in RFC 5545 iCalendar http://http://www.ietf.org/rfc/rfc2445.txt
 *
 * @param[in] event				The calendar event handle
 * @param[in] bymonth			The BYMONTH of the reccurrence event \n combination of 1 to 12 with ","
 *
 * @return 0 on success, otherwise a negative error value.
 * @retval #CALENDAR_ERROR_NONE Successful
 * @retval #CALENDAR_ERROR_INVALID_PARAMETER Invalid parameter
 */
int calendar_event_set_recurrence_bymonth(calendar_event_h event, const char* bymonth);

/**
 * @brief Gets the first day of the week.
 *
 * @param[in]   event			The calendar event handle
 * @param[out]  week_start		The first day of the week for the recurrence
 *
 * @return 0 on success, otherwise a negative error value.
 * @retval  #CALENDAR_ERROR_NONE                Successful
 * @retval  #CALENDAR_ERROR_INVALID_PARAMETER   Invalid parameter
 *
 * @see calendar_event_set_recurrence_week_start()
 */
int calendar_event_get_recurrence_week_start(calendar_event_h event, calendar_week_flag_e *week_start);

/**
 * @brief   Sets the first day of the week
 *
 * @param[in]   event The calendar event handle
 * @param[in]   week_start    The first day of the week for the recurrence
 *
 * @return 0 on success, otherwise a negative error value.
 * @retval  #CALENDAR_ERROR_NONE                Successful
 * @retval  #CALENDAR_ERROR_INVALID_PARAMETER   Invalid parameter
 *
 * @see calendar_event_get_recurrence_week_start()
 */
int calendar_event_set_recurrence_week_start(calendar_event_h event, calendar_week_flag_e week_start);

/**
 * @brief Removes the recurrence event instance from the calendar database.
 *
 * @param[in]   event_db_id  The event database ID to delete
 * @param[in]   start_time  The recurrence instance start time to delete
 *
 * @return 0 on success, otherwise a negative error value.
 * @retval #CALENDAR_ERROR_NONE Successful
 * @retval #CALENDAR_ERROR_DB_FAILED No access to database
 *
 * @pre	This function requires an open connection to the calendar service by calendar_connect().
 *
 * @see calendar_connect()
 * @see	calendar_event_get_recurrence_exdate()
 */
int calendar_event_delete_recurrence_instance_from_db(int event_db_id, long long int start_time);

/**
 * @brief Removes the recurrence all day event instance from the calendar database.
 *
 * @param[in]   event_db_id		The event database ID to delete
 * @param[in]   year			The year of recurrence all instance
 * @param[in]   month			The month of recurrence all instance
 * @param[in]   day				The day of recurrence all instance
 *
 * @return 0 on success, otherwise a negative error value.
 * @retval #CALENDAR_ERROR_NONE Successful
 * @retval #CALENDAR_ERROR_DB_FAILED No access to database
 *
 * @pre	This function requires an open connection to the calendar service by calendar_connect().
 *
 * @see calendar_connect()
 * @see	calendar_event_get_recurrence_exdate()
 */
int calendar_event_delete_recurrence_all_day_instance_from_db(int event_db_id, int year, int month, int day);

/**
 * @brief Gets a recurrence EXDATE of the event to the calendar event handle.
 * @details This rule is "EXDATE" rule in RFC 5545 iCalendar http://http://www.ietf.org/rfc/rfc2445.txt
 *
 * @remarks @a exdate must be released with free() by you.
 *
 * @param[in] event				The calendar event handle
 * @param[out] exdate			The EXDATE of the reccurrence event
 *
 * @return 0 on success, otherwise a negative error value.
 * @retval #CALENDAR_ERROR_NONE Successful
 * @retval #CALENDAR_ERROR_INVALID_PARAMETER Invalid parameter
 *
 * @see calendar_event_delete_recurrence_instance_from_db()
 * @see calendar_event_delete_recurrence_all_day_instance_from_db()
 */
int calendar_event_get_recurrence_exdate(calendar_event_h event, char** exdate);

/**
 * @brief        Frees event array
 *
 * @param[out]   event_array		The event array
 *
 * @return  0 on success, otherwise a negative error value.
 * @retval  #CALENDAR_ERROR_NONE                Successful
 * @retval  #CALENDAR_ERROR_INVALID_PARAMETER   Invalid parameter
 *
 * @see calendar_event_search_event_by_calendar_book()
 */
int calendar_event_free_event_array(calendar_event_h *event_array);

/**
 * @brief        Frees modified event array
 *
 * @param[out]   modified_event_array		The modified event array
 *
 * @return  0 on success, otherwise a negative error value.
 * @retval  #CALENDAR_ERROR_NONE                Successful
 * @retval  #CALENDAR_ERROR_INVALID_PARAMETER   Invalid parameter
 *
 * @see calendar_event_search_event_by_version()
 */
int calendar_event_free_modified_event_array(pcalendar_modified_event_s *modified_event_array);

/**
 * @brief       Retrieves all events as array from calendar book
 *
 * @remarks     @a event_array must be released with calendar_event_free_event_array() by you.
 *
 * @param[in]   calendar_book_db_id		 The calendar book database ID to filter \n
 *                       #DEFAULT_EVENT_CALENDAR_BOOK_DB_ID means the default event calendar book on the device \n
 *                       #CALENDAR_BOOK_FILTER_ALL means all calendar books on the device
 * @param[out]   event_array				The event array
 * @param[out]   length						The length of the event array
 *
 * @return  0 on success, otherwise a negative error value.
 * @retval  #CALENDAR_ERROR_NONE                Successful
 * @retval  #CALENDAR_ERROR_OUT_OF_MEMORY       Out of memory
 * @retval  #CALENDAR_ERROR_INVALID_PARAMETER   Invalid parameter
 * @retval  #CALENDAR_ERROR_DB_FAILED           Database operation failure
 *
 * @pre     This function requires an open connection to the calendar service by calendar_connect().
 *
 * @see calendar_connect()
 * @see calendar_event_free_event_array()
 */
int calendar_event_search_event_by_calendar_book(int calendar_book_db_id, calendar_event_h **event_array, int *length);

/**
 * @brief   Retrieves extend event instances within specified time range.
 *
 * @remarks     @a event_array must be released with calendar_event_free_event_array() by you.
 *
 * @param[in]   calendar_book_db_id      The calendar book database ID to filter \n
 *                       #DEFAULT_EVENT_CALENDAR_BOOK_DB_ID means the default event calendar book on the device \n
 *                       #CALENDAR_BOOK_FILTER_ALL means all calendar books on the device
 * @param[in]   period_start_time  The start of the time range\n
 *								The @a start_time is a unix timestamp since 00:00, Jan 1 1970 UTC.
 * @param[in]   period_end_time    The end of the time range\n
 *								The @a end_time is a unix timestamp since 00:00, Jan 1 1970 UTC.
 * @param[out]   event_array				The event array
 * @param[out]   length						The length of the event array
 *
 * @return  0 on success, otherwise a negative error value.
 * @retval  #CALENDAR_ERROR_NONE                Successful
 * @retval  #CALENDAR_ERROR_INVALID_PARAMETER   Invalid parameter
 * @retval  #CALENDAR_ERROR_DB_FAILED           No access to database
 *
 * @pre     This function requires an open connection to the calendar service by calendar_connect().
 *
 * @see calendar_connect()
 * @see calendar_event_free_event_array()
 */
int calendar_event_search_extend_instance_by_period(int calendar_book_db_id,
	long long int period_start_time, long long int period_end_time,
	calendar_event_h **event_array, int *length);

/**
 * @brief   Retrieves all day extend event instances within specified time range.
 *
 * @remarks     @a event_array must be released with calendar_event_free_event_array() by you.
 *
 * @param[in]   calendar_book_db_id      The calendar book database ID to filter \n
 *                       #DEFAULT_EVENT_CALENDAR_BOOK_DB_ID means the default event calendar book on the device \n
 *                       #CALENDAR_BOOK_FILTER_ALL means all calendar books on the device
 * @param[in]   period_start_year		The start year of the time range
 * @param[in]   period_start_month		The start month of the time range
 * @param[in]   period_start_day		The start day of the time range
 * @param[in]   period_end_year			The end year of the time range
 * @param[in]   period_end_month		The end month of the time range
 * @param[in]   period_end_day			The end day of the time range
 * @param[out]   event_array				The event array
 * @param[out]   length						The length of the event array
 *
 * @return  0 on success, otherwise a negative error value.
 * @retval  #CALENDAR_ERROR_NONE                Successful
 * @retval  #CALENDAR_ERROR_INVALID_PARAMETER   Invalid parameter
 * @retval  #CALENDAR_ERROR_DB_FAILED           No access to database
 *
 * @pre     This function requires an open connection to the calendar service by calendar_connect().
 *
 * @see calendar_connect()
 * @see calendar_event_free_event_array()
 */
int calendar_event_search_all_day_extend_instance_by_period(int calendar_book_db_id,
	int period_start_year, int period_start_month, int period_start_day,
	int period_end_year, int period_end_month, int period_end_day,
	calendar_event_h **event_array, int *length);

/**
 * @brief       Retrieves all modified events information as array that have been modified since the given version.
 *
 * @remarks     @a modified_event_array must be released with calendar_event_free_modified_event_array() by you.
 *
 * @param[in]   calendar_book_db_id		 The calendar book database ID to filter \n
 *                       #DEFAULT_EVENT_CALENDAR_BOOK_DB_ID means the default event calendar book on the device \n
 *                       #CALENDAR_BOOK_FILTER_ALL means all calendar books on the device
 * @param[in]   calendar_db_version  The calendar database version
 * @param[out]   modified_event_array		The modified event information array
 * @param[out]   length						The length of the event array
 *
 * @return  0 on success, otherwise a negative error value.
 * @retval  #CALENDAR_ERROR_NONE                Successful
 * @retval  #CALENDAR_ERROR_OUT_OF_MEMORY       Out of memory
 * @retval  #CALENDAR_ERROR_INVALID_PARAMETER   Invalid parameter
 * @retval  #CALENDAR_ERROR_DB_FAILED           Database operation failure
 *
 * @pre     This function requires an open connection to the calendar service by calendar_connect().
 *
 * @see calendar_connect()
 * @see calendar_event_free_modified_event_array()
 */
int calendar_event_search_event_by_version(int calendar_book_db_id, int calendar_db_version, pcalendar_modified_event_s **modified_event_array, int *length);

/**
 * @}
 */



/**
 * @addtogroup CAPI_SOCIAL_CALENDAR_TODO_MODULE
 * @{
 */

/**
 * @brief Creates a handle to calendar to-do.
 * @remarks The calendar to-do handle must be released with calendar_todo_destroy() by you.
 * @remarks   The created handle is not added to calendar database until calendar_todo_insert_to_db() is called
 *
 * @param[out] todo		The new calendar to-do handle
 *
 * @return  0 on success, otherwise a negative error value.
 * @retval  #CALENDAR_ERROR_NONE                Successful
 * @retval  #CALENDAR_ERROR_INVALID_PARAMETER   Invalid parameter
 * @retval  #CALENDAR_ERROR_OUT_OF_MEMORY       Out of memory
 *
 * @see calendar_todo_destroy()
 *
 */
int calendar_todo_create(calendar_todo_h *todo);

/**
 * @brief Destroys the calendar to-do handle
 *
 * @param[in]  todo   The calendar to-do handle
 *
 * @return  0 on success, otherwise a negative error value.
 * @retval  #CALENDAR_ERROR_NONE                Successful
 * @retval  #CALENDAR_ERROR_INVALID_PARAMETER   Invalid parameter
 *
 * @see calendar_todo_create()
 *
 */
int calendar_todo_destroy(calendar_todo_h todo);

/**
 * @brief Adds the given to-do item to the calendar database.
 *
 * @param[in]   todo		The calendar to-do handle
 * @param[in]   calendar_book_db_id      The calendar book database ID to which the to-do insert. \n
 *                       #DEFAULT_TODO_CALENDAR_BOOK_DB_ID means the default to-do calendar book on the device
 * @param[out]  todo_db_id		The to-do ID to be assigned to the to-do item
 *
 * @return 0 on success, otherwise a negative error value.
 * @retval #CALENDAR_ERROR_NONE Successful
 * @retval #CALENDAR_ERROR_DB_FAILED No access to database
 *
 * @pre     This function requires an open connection to the calendar service by calendar_connect().
 * @see calendar_todo_delete_from_db()
 * @see calendar_todo_update_to_db()
 *
 */
int calendar_todo_insert_to_db(calendar_todo_h todo, int calendar_book_db_id, int *todo_db_id);

/**
 * @brief Removes the to-do item from the calendar database.
 *
 * @param[in]   todo_id  The to-do ID to delete
 *
 * @return 0 on success, otherwise a negative error value.
 * @retval #CALENDAR_ERROR_NONE Successful
 * @retval #CALENDAR_ERROR_INVALID_PARAMETER Invalid parameter
 * @retval #CALENDAR_ERROR_DB_FAILED No access to database
 *
 * @pre     This function requires an open connection to the calendar service by calendar_connect().
 * @see calendar_todo_insert_to_db()
 * @see calendar_todo_update_to_db()
 */
int calendar_todo_delete_from_db(int todo_id);

/**
 * @brief Updates the to-do item on the calendar database.
 * @details calendar_todo_get_db_id() is called internally to update the to-do item in the calendar database.
 *
 * @param[in]   todo		The calendar to-do handle
 *
 * @return 0 on success, otherwise a negative error value.
 * @retval #CALENDAR_ERROR_NONE Successful
 * @retval #CALENDAR_ERROR_INVALID_PARAMETER   Invalid parameter
 * @retval #CALENDAR_ERROR_DB_FAILED No access to database
 *
 * @pre     This function requires an open connection to the calendar service by calendar_connect().
 *
 * @see calendar_todo_insert_to_db()
 * @see calendar_todo_delete_from_db()
 * @see calendar_todo_get_from_db()
 * @see calendar_todo_get_db_id()
 */
int calendar_todo_update_to_db(calendar_todo_h todo);

/**
 * @brief Gets the to-do item handle associated with the given to-do DB ID.
 * @details This function gets the new to-do handle with the given to-do database ID from the calendar database.
 * A new calendar to-do handle will be created.
 *
 * @remarks The new to-do handle must be released with calendar_todo_destroy() by you.
 *
 * @param[in]   todo_id			The to-do Database ID
 * @param[out]  todo			The calendar to-do handle
 *
 * @return  0 on success, otherwise a negative error value.
 * @retval  #CALENDAR_ERROR_NONE    Successful
 * @retval  #CALENDAR_ERROR_INVALID_PARAMETER   Invalid parameter
 * @retval  #CALENDAR_ERROR_OUT_OF_MEMORY       Out of memory
 *
 * @pre     This function requires an open connection to the calendar service by calendar_connect().
 *
 * @see calendar_todo_destroy()
 * @see calendar_todo_get_db_id()
 */
int calendar_todo_get_from_db(int todo_id, calendar_todo_h *todo);

/**
 * @brief   Gets the database ID for the given calendar to-do handle.
 *
 * @param[in]   todo			The calendar to-do handle
 * @param[out]  todo_db_id		The database ID of the to-do item (default : 0) \n
 *  0 means the to-do is not in calendar database
 *
 * @return  0 on success, otherwise a negative error value.
 * @retval  #CALENDAR_ERROR_NONE                Successful
 * @retval  #CALENDAR_ERROR_INVALID_PARAMETER   Invalid parameter
 *
 * @see calendar_todo_insert_to_db()
 * @see calendar_todo_delete_from_db()
 */
int calendar_todo_get_db_id(calendar_todo_h todo, int *todo_db_id);

/**
 * @brief   Gets The calendar book database ID associated with the given calendar to-do handle.
 *
 * @param[in]   todo			The calendar to-do handle
 * @param[out]  calendar_book_db_id	The calendar book database ID fetched from the calendar to-do handle (default : 0)  \n
 * 0 means the to-do is not in calendar database.
 *
 * @return  0 on success, otherwise a negative error value.
 * @retval  #CALENDAR_ERROR_NONE                Successful
 * @retval  #CALENDAR_ERROR_INVALID_PARAMETER   Invalid parameter
 *
 * @see calendar_todo_insert_to_db()
 */
int calendar_todo_get_calendar_book_db_id(calendar_todo_h todo, int *calendar_book_db_id);

/**
 * @brief Gets the subject of the to-do from the calendar to-do handle.
 *
 * @remarks @a subject must be released with free() by you.
 *
 * @param [in] todo				The calendar to-do handle
 * @param [out] subject			The subject of the to-do \n If the subject does not exist, it is NULL
 *
 * @return 0 on success, otherwise a negative error value.
 * @retval #CALENDAR_ERROR_NONE Successful
 * @retval #CALENDAR_ERROR_INVALID_PARAMETER Invalid parameter
 *
 * @see calendar_todo_set_subject()
 */
int calendar_todo_get_subject(calendar_todo_h todo, char **subject);

/**
 * @brief Sets a subject of the to-do handle.
 *
 * @param [in] todo		The calendar to-do handle
 * @param [in] subject	The subject of the to-do
 *
 * @return 0 on success, otherwise a negative error value.
 * @retval #CALENDAR_ERROR_NONE Successful
 * @retval #CALENDAR_ERROR_INVALID_PARAMETER Invalid parameter
 *
 * @see calendar_todo_get_subject()
 */
int calendar_todo_set_subject(calendar_todo_h todo, const char *subject);

/**
 * @brief Gets description of the to-do from the calendar to-do handle.
 *
 * @remarks @a description must be released with free() by you.
 *
 * @param [in] todo				The calendar to-do handle
 * @param [out] description		The description of the to-do \n If the description does not exist, it is NULL
 *
 * @return 0 on success, otherwise a negative error value.
 * @retval #CALENDAR_ERROR_NONE Successful
 * @retval #CALENDAR_ERROR_INVALID_PARAMETER Invalid parameter
 *
 * @see calendar_todo_set_description()
 */
int calendar_todo_get_description(calendar_todo_h todo, char **description);

/**
 * @brief Sets a description of the to-do in the calendar to-do handle.
 *
 * @param [in] todo				The calendar to-do handle
 * @param [in] description		The description of the to-do
 * @return 0 on success, otherwise a negative error value.
 * @retval #CALENDAR_ERROR_NONE Successful
 * @retval #CALENDAR_ERROR_INVALID_PARAMETER Invalid parameter
 *
 * @see calendar_todo_get_description()
 *
 */
int calendar_todo_set_description(calendar_todo_h todo, const char *description);

/**
 * @brief   Gets the priority for the given calendar to-do handle.
 *
 * @param[in]   todo	   		The calendar to-do handle
 * @param[out]  priority			The priority of the to-do
 *
 * @return  0 on success, otherwise a negative error value.
 * @retval  #CALENDAR_ERROR_NONE                Successful
 * @retval  #CALENDAR_ERROR_INVALID_PARAMETER   Invalid parameter
 *
 * @see calendar_todo_set_priority()
 */
int calendar_todo_get_priority(calendar_todo_h todo, calendar_todo_priority_e *priority);

/**
 * @brief   Sets a priority for the given calendar to-do handle.
 *
 * @param[in]  todo   		The calendar to-do handle
 * @param[in]  priority		The priority of the to-do
 *
 * @return  0 on success, otherwise a negative error value.
 * @retval  #CALENDAR_ERROR_NONE                Successful
 * @retval  #CALENDAR_ERROR_INVALID_PARAMETER   Invalid parameter
 *
 * @see calendar_todo_get_priority()
 */
int calendar_todo_set_priority(calendar_todo_h todo, calendar_todo_priority_e priority);

/**
 * @brief   Gets the status for the given calendar to-do handle.
 *
 * @param[in]   todo	   		The calendar to-do handle
 * @param[out]  status			The status of the to-do
 *
 * @return  0 on success, otherwise a negative error value.
 * @retval  #CALENDAR_ERROR_NONE                Successful
 * @retval  #CALENDAR_ERROR_INVALID_PARAMETER   Invalid parameter
 *
 * @see calendar_todo_set_status()
 */
int calendar_todo_get_status(calendar_todo_h todo, calendar_todo_status_e *status);

/**
 * @brief   Sets a status for the given calendar to-do handle.
 *
 * @param[in]   todo   		The calendar to-do handle
 * @param[in]  status		The status of the to-do
 *
 * @return  0 on success, otherwise a negative error value.
 * @retval  #CALENDAR_ERROR_NONE                Successful
 * @retval  #CALENDAR_ERROR_INVALID_PARAMETER   Invalid parameter
 *
 * @see calendar_todo_get_status()
 */
int calendar_todo_set_status(calendar_todo_h todo, calendar_todo_status_e status);

/**
 * @brief   Gets the visibility for the given calendar to-do handle.
 *
 * @param[in]   todo	   		The calendar to-do handle
 * @param[out]  visibility		The visibility of the to-do \n (default : #CALENDAR_VISIBILITY_PUBLIC)
 *
 * @return  0 on success, otherwise a negative error value.
 * @retval  #CALENDAR_ERROR_NONE                Successful
 * @retval  #CALENDAR_ERROR_INVALID_PARAMETER   Invalid parameter
 *
 * @see calendar_todo_set_visibility()
 */
int calendar_todo_get_visibility(calendar_todo_h todo, calendar_visibility_e *visibility);

/**
 * @brief   Sets a visibility for the given calendar to-do handle.
 *
 * @param[in]   todo   		The calendar to-do handle
 * @param[in]  visibility	The visibility of the to-do
 *
 * @return  0 on success, otherwise a negative error value.
 * @retval  #CALENDAR_ERROR_NONE                Successful
 * @retval  #CALENDAR_ERROR_INVALID_PARAMETER   Invalid parameter
 *
 * @see calendar_todo_get_visibility()
 */
int calendar_todo_set_visibility(calendar_todo_h todo, calendar_visibility_e visibility);

/**
 * @brief Gets the location of the to-do from the calendar to-do handle.
 *
 * @remarks @a location must be released with free() by you.
 *
 * @param [in] todo The calendar to-do handle
 * @param [out] location The location of the to-do \n If the location does not exist, it is NULL
 *
 * @return 0 on success, otherwise a negative error value.
 * @retval #CALENDAR_ERROR_NONE Successful
 * @retval #CALENDAR_ERROR_INVALID_PARAMETER Invalid parameter
 *
 * @see calendar_todo_set_location()
 *
 */
int calendar_todo_get_location(calendar_todo_h todo, char **location);

/**
 * @brief Sets a location of the to-do in the calendar to-do handle.
 *
 * @param [in] todo The calendar to-do handle
 * @param [in] location The location of the to-do
 *
 * @return 0 on success, otherwise a negative error value.
 * @retval #CALENDAR_ERROR_NONE Successful
 * @retval #CALENDAR_ERROR_INVALID_PARAMETER Invalid parameter
 *
 * @see calendar_todo_get_location()
 */
int calendar_todo_set_location(calendar_todo_h todo, const char *location);

/**
 * @brief	Gets the last modified time of the to-do item.
 *
 * @param[in]   todo       The calendar to-do handle
 * @param[out]  modified_time The last modified time\n
 *								The @a modified_time is a unix timestamp since 00:00, Jan 1 1970 UTC.
 *
 * @return  0 on success, otherwise a negative error value.
 * @retval  #CALENDAR_ERROR_NONE				Successful
 * @retval  #CALENDAR_ERROR_OUT_OF_MEMORY       Out of memory
 * @retval  #CALENDAR_ERROR_NO_DATA             Data not found
 *
 * @see calendar_todo_insert_to_db()
 * @see calendar_todo_update_to_db()
 *
 */
int calendar_todo_get_last_modified_time(calendar_todo_h todo, long long int *modified_time);
/**
 * @brief   Gets the timezone details for the given calendar to-do handle.
 * @remarks @a timezone_name must be released with free() by you.
 *
 * @param[in]   todo   					The calendar to-do handle
 * @param[out]  timezone_name			The time zone name eg. Europe/Paris
 *
 * @return  0 on success, otherwise a negative error value.
 * @retval  #CALENDAR_ERROR_NONE                Successful
 * @retval  #CALENDAR_ERROR_INVALID_PARAMETER   Invalid parameter
 *
 * @see calendar_todo_set_timezone()
 * @see calendar_foreach_timezone()
 */
int calendar_todo_get_timezone(calendar_todo_h todo, char** timezone_name);

/**
 * @brief   Sets the timezone for the given calendar to-do handle.
 *
 * @param[in]   todo   					The calendar to-do handle
 * @param[in]  timezone_name			The timezone name eg. Europe/Paris
 *
 * @return  0 on success, otherwise a negative error value.
 * @retval  #CALENDAR_ERROR_NONE                Successful
 * @retval  #CALENDAR_ERROR_INVALID_PARAMETER   Invalid parameter
 *
 * @see calendar_todo_get_timezone()
 * @see calendar_foreach_timezone()
 */
int calendar_todo_set_timezone(calendar_todo_h todo, const char* timezone_name);

/**
 * @brief Gets the start time of the to-do from the calendar to-do handle.
 *
 * @param [in] todo The calendar to-do handle
 * @param [out] start_time The start date of the to-do\n
 *								The @a start_time is a unix timestamp since 00:00, Jan 1 1970 UTC.
 *
 * @return 0 on success, otherwise a negative error value.
 * @retval #CALENDAR_ERROR_NONE Successful
 * @retval #CALENDAR_ERROR_INVALID_PARAMETER Invalid parameter
 * @retval #CALENDAR_ERROR_NO_DATA Data not found
 *
 * @see calendar_todo_set_start_time()
 */
int calendar_todo_get_start_time(calendar_todo_h todo, long long int *start_time);

/**
 * @brief Sets a start time of the to-do in the calendar to-do handle.
 *
 * @param [in] todo The calendar todo handle
 * @param [in] start_time The start date of the todo\n
 *								The @a start_time is a unix timestamp since 00:00, Jan 1 1970 UTC.
 *
 * @return 0 on success, otherwise a negative error value.
 * @retval #CALENDAR_ERROR_NONE Successful
 * @retval #CALENDAR_ERROR_INVALID_PARAMETER Invalid parameter
 *
 * @see calendar_todo_get_start_time()
 */
int calendar_todo_set_start_time(calendar_todo_h todo, long long int start_time);

/**
 * @brief Unsets a start time of the to-do in the calendar to-do handle.
 *
 * @param [in] todo The calendar todo handle
 *
 * @return 0 on success, otherwise a negative error value.
 * @retval #CALENDAR_ERROR_NONE Successful
 * @retval #CALENDAR_ERROR_INVALID_PARAMETER Invalid parameter
 *
 * @see calendar_todo_set_start_time()
 */
int calendar_todo_unset_start_time(calendar_todo_h todo);

/**
 * @brief Gets the due time of the to-do from the calendar to-do handle.
 *
 * @param [in] todo The calendar to-do handle
 * @param [out] due_time The due date of the to-do\n
 *								The @a due_time is a unix timestamp since 00:00, Jan 1 1970 UTC.
 *
 * @return 0 on success, otherwise a negative error value.
 * @retval #CALENDAR_ERROR_NONE					Successful
 * @retval #CALENDAR_ERROR_INVALID_PARAMETER	Invalid parameter
 * @retval #CALENDAR_ERROR_NO_DATA				Data not found
 *
 * @see calendar_todo_set_due_time()
 */
int calendar_todo_get_due_time(calendar_todo_h todo, long long int *due_time);

/**
 * @brief Sets a due time of the to-do in the calendar to-do handle.
 *
 * @param[in]   todo The calendar to-do handle
 * @param[in]   due_time    The due date of the to-do\n
 *								The @a due_time is a unix timestamp since 00:00, Jan 1 1970 UTC.
 *
 * @return  0 on success, otherwise a negative error value.
 * @retval  #CALENDAR_ERROR_NONE                Successful
 * @retval  #CALENDAR_ERROR_INVALID_PARAMETER   Invalid parameter
 *
 * @see calendar_todo_get_due_time()
 */
int calendar_todo_set_due_time(calendar_todo_h todo, long long int due_time);

/**
 * @brief Unsets a due time of the to-do in the calendar to-do handle.
 *
 * @param[in]   todo The calendar to-do handle
 *
 * @return  0 on success, otherwise a negative error value.
 * @retval  #CALENDAR_ERROR_NONE                Successful
 * @retval  #CALENDAR_ERROR_INVALID_PARAMETER   Invalid parameter
 *
 * @see calendar_todo_set_due_time()
 */
int calendar_todo_unset_due_time(calendar_todo_h todo);

/**
 * @brief Gets the total number of to-dos from the calendar book.
 *
 * @param[in]   calendar_book_db_id      The calendar book database ID to filter \n
 *                       #DEFAULT_TODO_CALENDAR_BOOK_DB_ID means the default to-do calendar book on the device \n
 *                       #CALENDAR_BOOK_FILTER_ALL means all calendar books on the device
 * @param[in]   todo_priority      The to-do priority(#calendar_todo_priority_e) to filter \n
 *                       Supports "OR"ing of #calendar_todo_priority_e
 * @param[in]   todo_status      The to-do status(#calendar_todo_status_e) to filter \n
 *                       Supports "OR"ing of #calendar_todo_status_e
 * @param[out]  count   The total number of to-dos
 *
 * @return  0 on success, otherwise a negative error value.
 * @retval  #CALENDAR_ERROR_NONE Successful
 * @retval  #CALENDAR_ERROR_INVALID_PARAMETER Invalid parameter
 * @retval #CALENDAR_ERROR_DB_FAILED No access to database
 *
 * @pre     This function requires an open connection to the calendar service by calendar_connect().
 *
 * @see calendar_connect()
 */
int calendar_todo_get_total_count_from_db(int calendar_book_db_id, int todo_priority, int todo_status, int *count);

/**
 * @brief Gets the total number of to-dos within specified time range from the calendar book.
 *
 * @param[in]   calendar_book_db_id      The calendar book database ID to filter \n
 *                       #DEFAULT_TODO_CALENDAR_BOOK_DB_ID means the default to-do calendar book on the device \n
 *                       #CALENDAR_BOOK_FILTER_ALL means all calendar books on the device
 * @param[in]   start_duedate_range  The start of the time range\n
 *								The @a start_duedate_range is a unix timestamp since 00:00, Jan 1 1970 UTC.
 * @param[in]   end_duedate_range    The end of the time range\n
 *								The @a end_duedate_range is a unix timestamp since 00:00, Jan 1 1970 UTC.
 * @param[in]   todo_priority      The to-do priority(#calendar_todo_priority_e) to filter \n
 *                       Supports "OR"ing of #calendar_todo_priority_e
 * @param[in]   todo_status      The to-do status(#calendar_todo_status_e) to filter \n
 *                       Supports "OR"ing of #calendar_todo_status_e
 * @param[out]  count   The total number of to-dos
 *
 * @return  0 on success, otherwise a negative error value.
 * @retval  #CALENDAR_ERROR_NONE Successful
 * @retval  #CALENDAR_ERROR_INVALID_PARAMETER Invalid parameter
 * @retval #CALENDAR_ERROR_DB_FAILED No access to database
 *
 * @pre     This function requires an open connection to the calendar service by calendar_connect().
 *
 * @see calendar_connect()
 */
int calendar_todo_get_total_count_by_duedate_range(int calendar_book_db_id, long long int start_duedate_range, long long int end_duedate_range, int todo_priority, int todo_status, int *count);

/**
 * @brief        Frees to-do array
 *
 * @param[out]   todo_array		The to-do array
 *
 * @return  0 on success, otherwise a negative error value.
 * @retval  #CALENDAR_ERROR_NONE                Successful
 * @retval  #CALENDAR_ERROR_INVALID_PARAMETER   Invalid parameter
 *
 * @see calendar_todo_search_todo_by_calendar_book()
 */
int calendar_todo_free_todo_array(calendar_todo_h *todo_array);

/**
 * @brief        Frees modified to-do array
 *
 * @param[out]   modified_todo_array		The modified to-do array
 * @param[out]   length				The length of the array
 *
 * @return  0 on success, otherwise a negative error value.
 * @retval  #CALENDAR_ERROR_NONE                Successful
 * @retval  #CALENDAR_ERROR_INVALID_PARAMETER   Invalid parameter
 *
 * @see calendar_todo_search_todo_by_version()
 */
int calendar_todo_free_modified_todo_array(pcalendar_modified_todo_s *modified_todo_array);

/**
 * @brief       Retrieves all to-dos as array from calendar book
 *
 * @remarks     @a todo_array must be released with calendar_todo_free_todo_array() by you.
 *
 * @param[in]   calendar_book_db_id		 The calendar book database ID to filter \n
 *                       #DEFAULT_TODO_CALENDAR_BOOK_DB_ID means the default to-do calendar book on the device \n
 *                       #CALENDAR_BOOK_FILTER_ALL means all calendar books on the device
 * @param[in]   todo_priority      The to-do priority(#calendar_todo_priority_e) to filter \n
 *                       Supports "OR"ing of #calendar_todo_priority_e
 * @param[in]   todo_status      The to-do status(#calendar_todo_status_e) to filter \n
 *                       Supports "OR"ing of #calendar_todo_status_e
 * @param[out]   todo_array				The to-do array
 * @param[out]   length						The length of the to-do array
 *
 * @return  0 on success, otherwise a negative error value.
 * @retval  #CALENDAR_ERROR_NONE                Successful
 * @retval  #CALENDAR_ERROR_OUT_OF_MEMORY       Out of memory
 * @retval  #CALENDAR_ERROR_INVALID_PARAMETER   Invalid parameter
 * @retval  #CALENDAR_ERROR_DB_FAILED           Database operation failure
 *
 * @pre     This function requires an open connection to the calendar service by calendar_connect().
 *
 * @see calendar_connect()
 * @see calendar_todo_free_todo_array()
 */
int calendar_todo_search_todo_by_calendar_book(int calendar_book_db_id, int todo_priority, int todo_status, calendar_todo_h **todo_array, int *length);

/**
 * @brief   Retrieves all calendar to-dos as array within specified time range.
 *
 * @remarks     @a todo_array must be released with calendar_todo_free_todo_array() by you.
 *
 * @param[in]   calendar_book_db_id		 The calendar book database ID to filter \n
 *                       #DEFAULT_TODO_CALENDAR_BOOK_DB_ID means the default to-do calendar book on the device \n
 *                       #CALENDAR_BOOK_FILTER_ALL means all calendar books on the device
 * @param[in]   start_duedate_range  The start of the time range\n
 *								The @a start_duedate_range is a unix timestamp since 00:00, Jan 1 1970 UTC.
 * @param[in]   end_duedate_range    The end of the time range\n
 *								The @a end_duedate_range is a unix timestamp since 00:00, Jan 1 1970 UTC.
 * @param[in]   todo_priority      The to-do priority(#calendar_todo_priority_e) to filter \n
 *                       Supports "OR"ing of #calendar_todo_priority_e
 * @param[in]   todo_status      The to-do status(#calendar_todo_status_e) to filter \n
 *                       Supports "OR"ing of #calendar_todo_status_e
 * @param[out]   todo_array				The to-do array
 * @param[out]   length						The length of the todo array
 *
 * @return  0 on success, otherwise a negative error value.
 * @retval  #CALENDAR_ERROR_NONE                Successful
 * @retval  #CALENDAR_ERROR_OUT_OF_MEMORY       Out of memory
 * @retval  #CALENDAR_ERROR_INVALID_PARAMETER   Invalid parameter
 * @retval  #CALENDAR_ERROR_DB_FAILED           Database operation failure
 *
 * @pre     This function requires an open connection to the calendar service by calendar_connect().
 *
 * @see calendar_connect()
 * @see calendar_todo_free_todo_array()
 */
int calendar_todo_search_todo_by_duedate_range(int calendar_book_db_id, long long int start_duedate_range, long long int end_duedate_range, int todo_priority, int todo_status, calendar_todo_h **todo_array, int *length);

/**
 * @brief       Retrieves all modified to-dos information as array that have been modified since the given version.
 *
 * @remarks     @a modified_todo_array must be released with calendar_todo_free_modified_todo_array() by you.
 *
 * @param[in]   calendar_book_db_id		 The calendar book database ID to filter \n
 *                       #DEFAULT_TODO_CALENDAR_BOOK_DB_ID means the default to-do calendar book on the device \n
 *                       #CALENDAR_BOOK_FILTER_ALL means all calendar books on the device
 * @param[in]   calendar_db_version  The calendar database version
 * @param[out]   modified_todo_array		The modified to-do information array
 * @param[out]   length						The length of the to-do array
 *
 * @return  0 on success, otherwise a negative error value.
 * @retval  #CALENDAR_ERROR_NONE                Successful
 * @retval  #CALENDAR_ERROR_OUT_OF_MEMORY       Out of memory
 * @retval  #CALENDAR_ERROR_INVALID_PARAMETER   Invalid parameter
 * @retval  #CALENDAR_ERROR_DB_FAILED           Database operation failure
 *
 * @pre     This function requires an open connection to the calendar service by calendar_connect().
 *
 * @see calendar_connect()
 * @see calendar_todo_free_modified_todo_array()
 */
int calendar_todo_search_todo_by_version(int calendar_book_db_id, int calendar_db_version, pcalendar_modified_todo_s **modified_todo_array, int *length);

/**
 * @}
 */

/**
 * @addtogroup CAPI_SOCIAL_CALENDAR_MULTIPLECALENDAR_MODULE
 * @{
 */

/**
 * @brief Creates a handle to the calendar book.
 * @remarks The calendar book handle must be released with calendar_book_destroy() by you.
 * @remarks   The created handle is not added to calendar database until calendar_insert_to_db() is called
 *
 * @param[out] calendar_book A new handle to calendar book
 *
 * @return   0 on success, otherwise a negative error value.
 * @retval  #CALENDAR_ERROR_NONE                Successful
 * @retval  #CALENDAR_ERROR_INVALID_PARAMETER   Invalid parameter
 * @retval  #CALENDAR_ERROR_OUT_OF_MEMORY       Out of memory
 *
 * @see calendar_book_destroy()
 *
 */
int calendar_book_create(calendar_book_h *calendar_book);

/**
 * @brief Destroys the calendar book handle and releases all its resources.
 *
 * @param[out]  calendar_book   The calendar book handle
 *
 * @return  0 on success, otherwise a negative error value.
 * @retval  #CALENDAR_ERROR_NONE                Successful
 * @retval  #CALENDAR_ERROR_INVALID_PARAMETER   Invalid parameter
 *
 * @see calendar_book_get_from_db()
 */
int calendar_book_destroy(calendar_book_h calendar_book);

/**
 * @brief Gets the calendar book from the calendar database.
 * @details This function gets the new calendar book handle with the given calendar book database ID from the calendar database. \n
 * The new calendar book handle will be created.
 *
 * @remarks The created calendar book handle must be released with calendar_book_destroy() by you.
 *
 * @param[in]   calendar_book_db_id		The calendar book database ID
 * @param[out]  calendar_book			The calendar book handle associated with The calendar book database ID
 *
 * @return  0 on success, otherwise a negative error value.
 * @retval  #CALENDAR_ERROR_NONE  Successful
 * @retval  #CALENDAR_ERROR_INVALID_PARAMETER   Invalid parameter
 * @retval  #CALENDAR_ERROR_OUT_OF_MEMORY       Out of memory
 *
 * @pre     This function requires an open connection to the calendar service by calendar_connect().
 *
 * @see calendar_book_destroy()
 */
int calendar_book_get_from_db(int calendar_book_db_id, calendar_book_h *calendar_book);

/**
 * @brief Adds a calendar book to the calendar database.
 *
 * @param[in]	calendar_book               The calendar book handle
 * @param[out]	calendar_book_db_id         The calendar book database ID associated with the calendar book \n
 * If the function fails, it is -1.
 *
 * @return 0 on success, otherwise a negative error value.
 * @retval #CALENDAR_ERROR_NONE Successful
 * @retval #CALENDAR_ERROR_DB_FAILED No access to database
 *
 * @pre     This function requires an open connection to the calendar service by calendar_connect().
 *
 * @see calendar_connect()
 * @see calendar_book_delete_from_db()
 */
int calendar_book_insert_to_db(calendar_book_h calendar_book, int *calendar_book_db_id);

/**
 * @brief Updates a calendar book to the calendar database.
 *
 * @param[in]	calendar_book               The calendar book handle
 *
 * @return 0 on success, otherwise a negative error value.
 * @retval #CALENDAR_ERROR_NONE Successful
 * @retval #CALENDAR_ERROR_DB_FAILED No access to database
 *
 * @pre     This function requires an open connection to the calendar service by calendar_connect().
 *
 * @see calendar_book_connect()
 */
int calendar_book_update_to_db(calendar_book_h calendar_book);

/**
 * @brief Removes the calendar book from the calendar database.
 *
 * @param[in]   calendar_book_db_id  The calendar book database ID to delete
 *
 * @return 0 on success, otherwise a negative error value.
 * @retval #CALENDAR_ERROR_NONE Successful
 * @retval #CALENDAR_ERROR_DB_FAILED No access to database
 *
 * @pre	This function requires an open connection to the calendar service by calendar_connect().
 *
 * @see calendar_connect()
 */
int calendar_book_delete_from_db(int calendar_book_db_id);

/**
 * @brief Removes the calendar books, events and to-dos from the calendar database.
 *
 * @param[in]   account_db_id  The account database ID to filter
 *
 * @return 0 on success, otherwise a negative error value.
 * @retval #CALENDAR_ERROR_NONE Successful
 * @retval #CALENDAR_ERROR_DB_FAILED No access to database
 *
 * @pre	This function requires an open connection to the calendar service by calendar_connect().
 *
 * @see calendar_connect()
 */
int calendar_book_delete_all_by_account(int account_db_id);

/**
 * @brief   Gets the calendar book database ID associated with the given calendar book handle.
 *
 * @param[in]   calendar_book		The calendar book handle
 * @param[out]  calendar_book_db_id	The calendar book database ID fetched from the calendar book handle
 *
 * @return  0 on success, otherwise a negative error value.
 * @retval  #CALENDAR_ERROR_NONE                Successful
 * @retval  #CALENDAR_ERROR_INVALID_PARAMETER   Invalid parameter
 *
 * @see calendar_book_get_from_db()
 */
int calendar_book_get_db_id(calendar_book_h calendar_book, int *calendar_book_db_id);

/**
 * @brief   Sets the calendar book type associated with the given calendar book handle.
 *
 * @param[in] calendar_book		The calendar book handle
 * @param[in] calendar_book_type	The calendar book type. \n Supports "OR"ing of #calendar_book_type_e
 *
 * @return  0 on success, otherwise a negative error value.
 * @retval  #CALENDAR_ERROR_NONE                Successful
 * @retval  #CALENDAR_ERROR_INVALID_PARAMETER   Invalid parameter
 *
 * @see calendar_book_get_type()
 */
int calendar_book_set_type(calendar_book_h calendar_book, int calendar_book_type);

/**
 * @brief   Gets the calendar book type associated with the given calendar book handle.
 *
 * @param[in]  calendar_book			The calendar book handle
 * @param[out] calendar_book_type	The calendar book type. \n Supports "OR"ing of #calendar_book_type_e
 *
 * @return  0 on success, otherwise a negative error value.
 * @retval  #CALENDAR_ERROR_NONE                Successful
 * @retval  #CALENDAR_ERROR_INVALID_PARAMETER   Invalid parameter
 *
 * @see calendar_book_set_type()
 */
int calendar_book_get_type(calendar_book_h calendar_book, int *calendar_book_type);

/**
 * @brief Gets the status whether the calendar book is default calendar book is or not in the device.
 *
 * @param [in] calendar_book			The calendar book handle
 * @param [out] is_default		@c true if the calendar is the default calendar book in the device @c false \n
 * (default : @c false)
 *
 * @return 0 on success, otherwise a negative error value.
 * @retval #CALENDAR_ERROR_NONE Successful
 * @retval #CALENDAR_ERROR_INVALID_PARAMETER Invalid parameter
 */
int calendar_book_get_is_default(calendar_book_h calendar_book, bool *is_default);

/**
 * @brief Sets the name of the calendar from the calendar book handle.
 *
 * @remarks @a calendar_name must be released with free() by you.
 *
 * @param [in] calendar_book			The calendar book handle
 * @param [in] calendar_book_name	The name of the calendar book
 *
 * @return 0 on success, otherwise a negative error value.
 * @retval #CALENDAR_ERROR_NONE Successful
 * @retval #CALENDAR_ERROR_INVALID_PARAMETER Invalid parameter
 *
 * @see calendar_book_get_name()
 */
int calendar_book_set_name(calendar_book_h calendar_book, const char *calendar_book_name);

/**
 * @brief Gets the name of the calendar book from the calendar book handle.
 *
 * @remarks @a calendar_book_name must be released with free() by you.
 *
 * @param [in] calendar_book			The calendar book handle
 * @param [out] calendar_book_name	The name of the calendar book \n If the name does not exist, it is NULL
 *
 * @return 0 on success, otherwise a negative error value.
 * @retval #CALENDAR_ERROR_NONE Successful
 * @retval #CALENDAR_ERROR_INVALID_PARAMETER Invalid parameter
 *
 * @see calendar_book_set_name()
 */
int calendar_book_get_name(calendar_book_h calendar_book, char **calendar_book_name);

/**
 * @brief Sets the visible status of the calendar book handle.
 *
 * @param [in] calendar_book The calendar book handle
 * @param [in] is_visible @c true if the calendar book is visible in the device, otherwise @c false \n
 * (default : @c false)
 *
 * @return 0 on success, otherwise a negative error value.
 * @retval #CALENDAR_ERROR_NONE Successful
 * @retval #CALENDAR_ERROR_INVALID_PARAMETER Invalid parameter
 *
 * @see calendar_book_get_is_visibile()
 */
int calendar_book_set_is_visible(calendar_book_h calendar_book, bool is_visible);

/**
 * @brief Gets the visible status of the calendar book handle.
 *
 * @param [in] calendar_book The calendar book handle
 * @param [out] is_visible @c true if the calendar book is visible in the device, otherwise @c false \n
 * (default : @c false)
 *
 * @return 0 on success, otherwise a negative error value.
 * @retval #CALENDAR_ERROR_NONE Successful
 * @retval #CALENDAR_ERROR_INVALID_PARAMETER Invalid parameter
 *
 * @see calendar_book_set_is_visibile()
 */
int calendar_book_get_is_visible(calendar_book_h calendar_book, bool *is_visible);

/**
 * @brief Sets the color of the calendar book from the calendar book handle.
 *
 * @param [in] calendar_book The calendar book handle
 * @param [in] red		The calendar book color which represents red among RGB
 * @param [in] green	The calendar book color which represents green among RGB
 * @param [in] blue		The calendar book color which represents blue among RGB
 *
 * @return 0 on success, otherwise a negative error value.
 * @retval #CALENDAR_ERROR_NONE Successful
 * @retval #CALENDAR_ERROR_INVALID_PARAMETER Invalid parameter
 *
 * @see calendar_book_get_color()
 * @see calendar_book_unset_color()
 */
int calendar_book_set_color(calendar_book_h calendar_book, unsigned char red, unsigned char green, unsigned char blue);

/**
 * @brief Unsets the color of the calendar book from the calendar book handle.
 *
 * @param [in] calendar_book The calendar book handle
 *
 * @return 0 on success, otherwise a negative error value.
 * @retval #CALENDAR_ERROR_NONE Successful
 * @retval #CALENDAR_ERROR_INVALID_PARAMETER Invalid parameter
 *
 * @see calendar_book_set_color()
 */
int calendar_book_unset_color(calendar_book_h calendar_book);

/**
 * @brief Gets the color of the calendar book from the calendar book handle.
 *
 * @remarks returns @a CALENDAR_ERROR_NO_DATA means calendar book color is not valid
 *
 * @param [in] calendar_book The calendar book handle
 * @param [out] red		The calendar book color which represents red among RGB
 * @param [out] green	The calendar book color which represents green among RGB
 * @param [out] blue	The calendar book color which represents blue among RGB
 *
 * @return 0 on success, otherwise a negative error value.
 * @retval #CALENDAR_ERROR_NONE Successful
 * @retval #CALENDAR_ERROR_INVALID_PARAMETER Invalid parameter
 * @retval #CALENDAR_ERROR_NO_DATA				Data not found
 *
 * @see calendar_book_set_color()
 */
int calendar_book_get_color(calendar_book_h calendar_book, unsigned char *red, unsigned char *green, unsigned char *blue);

/**
 * @brief   Sets the account database ID associated with the given calendar book handle.
 *
 * @param[in]  calendar_book	The calendar book handle
 * @param[in]  account_db_id	The account database ID(default : 0) \n
 * 0 means the calendar book is not related to any accounts.
 *
 * @return  0 on success, otherwise a negative error value.
 * @retval  #CALENDAR_ERROR_NONE                Successful
 * @retval  #CALENDAR_ERROR_INVALID_PARAMETER   Invalid parameter
 *
 * @see calendar_book_get_account_db_id()
 */
int calendar_book_set_account_db_id(calendar_book_h calendar_book, int account_db_id);

/**
 * @brief   Gets the account database ID associated with the given calendar book handle.
 *
 * @param[in]   calendar_book	The calendar book handle
 * @param[out]  account_db_id	The account database ID(default : 0) \n
 * 0 means the calendar book is not related to any accounts.
 *
 * @return  0 on success, otherwise a negative error value.
 * @retval  #CALENDAR_ERROR_NONE                Successful
 * @retval  #CALENDAR_ERROR_INVALID_PARAMETER   Invalid parameter
 *
 * @see calendar_book_set_account_db_id()
 */
int calendar_book_get_account_db_id(calendar_book_h calendar_book, int *account_db_id);

/**
 * @brief        Frees calendar book array
 *
 * @param[out]   calendar_book_array		The calendar book array
 *
 * @return  0 on success, otherwise a negative error value.
 * @retval  #CALENDAR_ERROR_NONE                Successful
 * @retval  #CALENDAR_ERROR_INVALID_PARAMETER   Invalid parameter
 *
 * @see calendar_book_get_all_calendar_book()
 */
int calendar_book_free_calendar_book_array(calendar_book_h *calendar_book_array);

/**
 * @brief  Retrieves all calendar books as array from database.
 *
 * @remarks     @a calendar_book_array must be released with calendar_book_free_calendar_book_array() by you.
 *
 * @param[out]   calendar_book_array		The calendar book array
 * @param[out]   length						The length of the calendar book array
 *
 * @return	0 on success, otherwise a negative error value.
 * @retval	#CALENDAR_ERROR_NONE                Successful
 * @retval  #CALENDAR_ERROR_INVALID_PARAMETER   Invalid parameter
 * @retval	#CALENDAR_ERROR_DB_FAILED			No access to database
 *
 * @pre     This function requires an open connection to the calendar service by calendar_connect().
 *
 * @see calendar_connect()
 * @see calendar_book_free_calendar_book_array()
 */
int calendar_book_get_all_calendar_book(calendar_book_h **calendar_book_array, int *length);

/**
 * @brief  Retrieves calendar books as array with account database ID from database.
 *
 * @remarks     @a calendar_book_array must be released with calendar_book_free_calendar_book_array() by you.
 *
 * @param[in]   account_db_id				The account database ID to filter
 * @param[out]   calendar_book_array		The calendar book array
 * @param[out]   length						The length of the calendar book array
 *
 * @return	0 on success, otherwise a negative error value.
 * @retval	#CALENDAR_ERROR_NONE                Successful
 * @retval  #CALENDAR_ERROR_INVALID_PARAMETER   Invalid parameter
 * @retval	#CALENDAR_ERROR_DB_FAILED			No access to database
 *
 * @pre     This function requires an open connection to the calendar service by calendar_connect().
 *
 * @see calendar_connect()
 * @see calendar_book_free_calendar_book_array()
 */
int calendar_book_search_calendar_book_by_account(int account_db_id, calendar_book_h **calendar_book_array, int *length);

/**
 * @}
 */

#ifdef __cplusplus
}
#endif


#endif