/**
* @brief The attribute key denoting "time of day".
- * @details This can be used as left operands of context_trigger_rule_entry_add_comparison_int().@n
+ * @details This can be used as a key of context_trigger_rule_entry_add_option_string(),
+ * or left operands of context_trigger_rule_entry_add_comparison_int().@n
+ * When being used as option, it is time interval of the day. For example, "13-15" denotes "from 1 PM to 3 PM".
* When being used with #CONTEXT_TRIGGER_EVENT_TIME or #CONTEXT_TRIGGER_CONDITION_TIME, it's unit is "minute",
* the valid range of the corresponding right operands is thus from 0 (12:00 AM) to 1439 (11:59 PM).
* @since_tizen 2.4
/**
* @brief The attribute key denoting "day of week".
- * @details This can be used as left operands of context_trigger_rule_entry_add_comparison_string().@n
+ * @details This can be used as a key of context_trigger_rule_entry_add_option_string(),
+ * or left operands of context_trigger_rule_entry_add_comparison_string().@n
* As the right operands of this attribute, one of the following values are allowed:
- * #CONTEXT_TRIGGER_MON, #CONTEXT_TRIGGER_TUE, #CONTEXT_TRIGGER_WED, #CONTEXT_TRIGGER_THU,
- * #CONTEXT_TRIGGER_FRI, #CONTEXT_TRIGGER_SAT, and #CONTEXT_TRIGGER_SUN.
+ * #CONTEXT_TRIGGER_MON, #CONTEXT_TRIGGER_TUE, #CONTEXT_TRIGGER_WED, #CONTEXT_TRIGGER_THU, #CONTEXT_TRIGGER_FRI,
+ * #CONTEXT_TRIGGER_SAT, #CONTEXT_TRIGGER_SUN, #CONTEXT_TRIGGER_WEEKDAY, and #CONTEXT_TRIGGER_WEEKEND.
* @since_tizen 2.4
*/
#define CONTEXT_TRIGGER_DAY_OF_WEEK "DayOfWeek"
/**
* @brief The attribute value denoting Monday.
- * @details This can be used as right operands of context_trigger_rule_entry_add_comparison_string().@n
- * See the programming guide to find the corresponding left operand attribute keys.
+ * @details This can be used as a value of context_trigger_rule_entry_add_option_string()
+ * or right operands of context_trigger_rule_entry_add_comparison_string().@n
+ * See the programming guide to find the corresponding option keys or left operand attribute keys.
* @since_tizen 2.4
*/
#define CONTEXT_TRIGGER_MON "Mon"
/**
* @brief The attribute value denoting Tuesday.
- * @details This can be used as right operands of context_trigger_rule_entry_add_comparison_string().@n
- * See the programming guide to find the corresponding left operand attribute keys.
+ * @details This can be used as a value of context_trigger_rule_entry_add_option_string()
+ * or right operands of context_trigger_rule_entry_add_comparison_string().@n
+ * See the programming guide to find the corresponding option keys or left operand attribute keys.
* @since_tizen 2.4
*/
#define CONTEXT_TRIGGER_TUE "Tue"
/**
* @brief The attribute value denoting Wednesday.
- * @details This can be used as right operands of context_trigger_rule_entry_add_comparison_string().@n
- * See the programming guide to find the corresponding left operand attribute keys.
+ * @details This can be used as a value of context_trigger_rule_entry_add_option_string()
+ * or right operands of context_trigger_rule_entry_add_comparison_string().@n
+ * See the programming guide to find the corresponding option keys or left operand attribute keys.
* @since_tizen 2.4
*/
#define CONTEXT_TRIGGER_WED "Wed"
/**
* @brief The attribute value denoting Thursday.
- * @details This can be used as right operands of context_trigger_rule_entry_add_comparison_string().@n
- * See the programming guide to find the corresponding left operand attribute keys.
+ * @details This can be used as a value of context_trigger_rule_entry_add_option_string()
+ * or right operands of context_trigger_rule_entry_add_comparison_string().@n
+ * See the programming guide to find the corresponding option keys or left operand attribute keys.
* @since_tizen 2.4
*/
#define CONTEXT_TRIGGER_THU "Thu"
/**
* @brief The attribute value denoting Friday.
- * @details This can be used as right operands of context_trigger_rule_entry_add_comparison_string().@n
- * See the programming guide to find the corresponding left operand attribute keys.
+ * @details This can be used as a value of context_trigger_rule_entry_add_option_string()
+ * or right operands of context_trigger_rule_entry_add_comparison_string().@n
+ * See the programming guide to find the corresponding option keys or left operand attribute keys.
* @since_tizen 2.4
*/
#define CONTEXT_TRIGGER_FRI "Fri"
/**
* @brief The attribute value denoting Saturday.
- * @details This can be used as right operands of context_trigger_rule_entry_add_comparison_string().@n
- * See the programming guide to find the corresponding left operand attribute keys.
+ * @details This can be used as a value of context_trigger_rule_entry_add_option_string()
+ * or right operands of context_trigger_rule_entry_add_comparison_string().@n
+ * See the programming guide to find the corresponding option keys or left operand attribute keys.
* @since_tizen 2.4
*/
#define CONTEXT_TRIGGER_SAT "Sat"
/**
* @brief The attribute value denoting Sunday.
- * @details This can be used as right operands of context_trigger_rule_entry_add_comparison_string().@n
- * See the programming guide to find the corresponding left operand attribute keys.
+ * @details This can be used as a value of context_trigger_rule_entry_add_option_string()
+ * or right operands of context_trigger_rule_entry_add_comparison_string().@n
+ * See the programming guide to find the corresponding option keys or left operand attribute keys.
* @since_tizen 2.4
*/
#define CONTEXT_TRIGGER_SUN "Sun"
/**
* @brief The attribute value denoting Weekdays.
- * @details This can be used as right operands of context_trigger_rule_entry_add_comparison_string().@n
- * See the programming guide to find the corresponding left operand attribute keys.
+ * @details This can be used as a value of context_trigger_rule_entry_add_option_string()
+ * or right operands of context_trigger_rule_entry_add_comparison_string().@n
+ * See the programming guide to find the corresponding option keys or left operand attribute keys.
* @since_tizen 2.4
*/
#define CONTEXT_TRIGGER_WEEKDAY "Weekday"
/**
* @brief The attribute value denoting Weekends.
- * @details This can be used as right operands of context_trigger_rule_entry_add_comparison_string().@n
- * See the programming guide to find the corresponding left operand attribute keys.
+ * @details This can be used as a value of context_trigger_rule_entry_add_option_string()
+ * or right operands of context_trigger_rule_entry_add_comparison_string().@n
+ * See the programming guide to find the corresponding option keys or left operand attribute keys.
* @since_tizen 2.4
*/
#define CONTEXT_TRIGGER_WEEKEND "Weekend"
* @brief Gets a rule stored in the system by rule ID.
* @since_tizen 2.4
*
- * @remarks The @c rule must be released using context_trigger_rule_entry_destroy().
+ * @remarks The @c rule must be released using context_trigger_rule_destroy().
*
* @param[in] rule_id The ID of the rule to be retrieved
* @param[out] rule The rule retrieved
* @retval #CONTEXT_TRIGGER_ERROR_NONE Successful
* @retval #CONTEXT_TRIGGER_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #CONTEXT_TRIGGER_ERROR_OUT_OF_MEMORY Memory allocation failed
+ *
+ * @see context_trigger_rule_destroy()
*/
int context_trigger_rule_create(context_trigger_logical_type_e logical_type, context_trigger_rule_h* rule);
* @retval #CONTEXT_TRIGGER_ERROR_NONE Successful
* @retval #CONTEXT_TRIGGER_ERROR_INVALID_PARAMETER Invalid parameter
*
- * @see context_trigger_rule_create()
- * @see context_Trigger_get_rule_by_id()
+ * @pre context_trigger_rule_create()
+ * @see context_trigger_get_rule_by_id()
*/
int context_trigger_rule_destroy(context_trigger_rule_h rule);
* @retval #CONTEXT_TRIGGER_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #CONTEXT_TRIGGER_ERROR_OUT_OF_MEMORY Out of memory
* @retval #CONTEXT_TRIGGER_ERROR_OPERATION_FAILED Operation failed
+ *
+ * @see context_trigger_rule_get_description()
*/
int context_trigger_rule_set_description(context_trigger_rule_h rule, const char* description);
* @retval #CONTEXT_TRIGGER_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #CONTEXT_TRIGGER_ERROR_OUT_OF_MEMORY Out of memory
* @retval #CONTEXT_TRIGGER_ERROR_OPERATION_FAILED Operation failed
+ *
+ * @see context_trigger_rule_set_description()
*/
int context_trigger_rule_get_description(context_trigger_rule_h rule, char** description);
* @retval #CONTEXT_TRIGGER_ERROR_NONE Successful
* @retval #CONTEXT_TRIGGER_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #CONTEXT_TRIGGER_ERROR_OUT_OF_MEMORY Memory allocation failed
+ *
+ * @see context_trigger_rule_entry_destroy()
*/
int context_trigger_rule_event_create(context_trigger_event_e event_item, context_trigger_logical_type_e logical_type, context_trigger_rule_entry_h* entry);
* @retval #CONTEXT_TRIGGER_ERROR_NONE Successful
* @retval #CONTEXT_TRIGGER_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #CONTEXT_TRIGGER_ERROR_OUT_OF_MEMORY Memory allocation failed
+ *
+ * @see context_trigger_rule_entry_destroy()
*/
int context_trigger_rule_condition_create(context_trigger_condition_e condition_item, context_trigger_logical_type_e logical_type, context_trigger_rule_entry_h* entry);
* @retval #CONTEXT_TRIGGER_ERROR_NONE Successful
* @retval #CONTEXT_TRIGGER_ERROR_INVALID_PARAMETER Invalid parameter
*
- * @see context_trigger_rule_event_create()
- * @see context_trigger_rule_condition_create()
+ * @pre context_trigger_rule_event_create()
+ * @pre context_trigger_rule_condition_create()
*/
int context_trigger_rule_entry_destroy(context_trigger_rule_entry_h entry);
* @retval #CONTEXT_TRIGGER_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #CONTEXT_TRIGGER_ERROR_OUT_OF_MEMORY Out of memory
* @retval #CONTEXT_TRIGGER_ERROR_INVALID_RULE Invalid rule
+ *
+ * @see context_trigger_rule_entry_add_option()
+ * @see context_trigger_rule_entry_add_option_string()
*/
int context_trigger_rule_entry_add_option_int(context_trigger_rule_entry_h entry, const char* option_key, int value);
* @retval #CONTEXT_TRIGGER_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #CONTEXT_TRIGGER_ERROR_OUT_OF_MEMORY Out of memory
* @retval #CONTEXT_TRIGGER_ERROR_INVALID_RULE Invalid rule
+ *
+ * @see context_trigger_rule_entry_add_option()
+ * @see context_trigger_rule_entry_add_option_int()
*/
int context_trigger_rule_entry_add_option_string(context_trigger_rule_entry_h entry, const char* option_key, const char* value);
* @retval #CONTEXT_TRIGGER_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #CONTEXT_TRIGGER_ERROR_OUT_OF_MEMORY Out of memory
* @retval #CONTEXT_TRIGGER_ERROR_INVALID_RULE Invalid rule
+ *
+ * @see context_trigger_rule_entry_add_option_int()
+ * @see context_trigger_rule_entry_add_option_string()
*/
int context_trigger_rule_entry_add_option(context_trigger_rule_entry_h entry, const char* option_key, const char* event_data_key);
* @retval #CONTEXT_TRIGGER_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #CONTEXT_TRIGGER_ERROR_OUT_OF_MEMORY Out of memory
* @retval #CONTEXT_TRIGGER_ERROR_INVALID_RULE Invalid rule
+ *
+ * @post context_trigger_rule_entry_add_comparison()
+ * @post context_trigger_rule_entry_add_comparison_int()
+ * @post context_trigger_rule_entry_add_comparison_string()
*/
int context_trigger_rule_entry_add_key(context_trigger_rule_entry_h entry, context_trigger_logical_type_e logical_type, const char* key);
/**
* @brief Adds a comparison between an attribute key and an integer.
* @details The key needs to be registered in advance, via context_trigger_rule_entry_add_key().
- * As the comparison operator, one of the following operators is allowed: "==", "!=", "<", ">", "<=", and ">=".
+ * As the comparison operator, one of the following operators is allowed:
+ * #CONTEXT_TRIGGER_EQUAL_TO, #CONTEXT_TRIGGER_NOT_EQUAL_TO, #CONTEXT_TRIGGER_LESS_THAN,
+ * #CONTEXT_TRIGGER_GREATER_THAN, #CONTEXT_TRIGGER_LESS_THAN_OR_EQUAL_TO
+ * and #CONTEXT_TRIGGER_GREATER_THAN_OR_EQUAL_TO.
* @since_tizen 2.4
*
* @param[in] entry The event or condition entry
* @retval #CONTEXT_TRIGGER_ERROR_OUT_OF_MEMORY Out of memory
* @retval #CONTEXT_TRIGGER_ERROR_NO_DATA The key was not added in the entry
* @retval #CONTEXT_TRIGGER_ERROR_INVALID_RULE Invalid rule
+ *
+ * @pre context_trigger_rule_entry_add_key()
+ * @see context_trigger_rule_entry_add_comparison()
+ * @see context_trigger_rule_entry_add_comparison_string()
*/
int context_trigger_rule_entry_add_comparison_int(context_trigger_rule_entry_h entry, const char* key, const char* comp_operator, int value);
/**
* @brief Adds a comparison between an attribute key and a string.
* @details The key needs to be registered in advance, via context_trigger_rule_entry_add_key().
- * As the comparison operator, one of the following operators is allowed: "==" and "!=".
+ * As the comparison operator, one of the following operators is allowed:
+ * #CONTEXT_TRIGGER_EQUAL_TO and #CONTEXT_TRIGGER_NOT_EQUAL_TO.
* @since_tizen 2.4
*
* @param[in] entry The event or condition entry
* @retval #CONTEXT_TRIGGER_ERROR_OUT_OF_MEMORY Out of memory
* @retval #CONTEXT_TRIGGER_ERROR_NO_DATA The key was not added in the entry
* @retval #CONTEXT_TRIGGER_ERROR_INVALID_RULE Invalid rule
+ *
+ * @pre context_trigger_rule_entry_add_key()
+ * @see context_trigger_rule_entry_add_comparison()
+ * @see context_trigger_rule_entry_add_comparison_int()
*/
int context_trigger_rule_entry_add_comparison_string(context_trigger_rule_entry_h entry, const char* key, const char* comp_operator, const char* value);
* @retval #CONTEXT_TRIGGER_ERROR_OUT_OF_MEMORY Out of memory
* @retval #CONTEXT_TRIGGER_ERROR_NO_DATA The key was not added in the entry
* @retval #CONTEXT_TRIGGER_ERROR_INVALID_RULE Invalid rule
+ *
+ * @pre context_trigger_rule_entry_add_key()
+ * @see context_trigger_rule_entry_add_comparison_int()
+ * @see context_trigger_rule_entry_add_comparison_string()
*/
int context_trigger_rule_entry_add_comparison(context_trigger_rule_entry_h entry, const char* key, const char* comp_operator, const char* event_data_key);