GothenburgBitFactory/taskwarrior
1
0
Fork 0
mirror of https://github.com/GothenburgBitFactory/taskwarrior.git synced 2025-06-26 10:54:26 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions 1

implement TCTags as an array

Browse source
This commit is contained in:
Dustin J. Mitchell 2022-02-02 03:28:54 +00:00
parent 8b160c7ee8
commit 3dd2ae5011
6 changed files with 226 additions and 8 deletions
Download patch file Download diff file Expand all files Collapse all files

40
lib/taskchampion.h
View file

@ -88,6 +88,30 @@ typedef struct TCString TCString;
*/
typedef struct TCTask TCTask;
/**
* TCTags represents a list of tags associated with a task.
*
* The content of this struct must be treated as read-only.
*
* The lifetime of a TCTags instance is independent of the task, and it
* will remain valid even if the task is freed.
*/
typedef struct TCTags {
/**
* strings representing each tag. these remain owned by the
* TCTags instance and will be freed by tc_tags_free.
*/
struct TCString *const *tags;
/**
* number of tags in tags
*/
size_t num_tags;
/**
* total size of tags (internal use only; do not change)
*/
size_t _capacity;
} TCTags;
/**
* TCUuid is used as a task identifier. Uuids do not contain any pointers and need not be freed.
* Uuids are typically treated as opaque, but the bytes are available in big-endian format.
@ -101,6 +125,12 @@ typedef struct TCUuid {
extern "C" {
#endif // __cplusplus
/**
* Free a TCTags instance. The given pointer must not be NULL. The instance must not be used
* after this call.
*/
void tc_tags_free(struct TCTags *tctags);
/**
* Create a new TCReplica with an in-memory database. The contents of the database will be
* lost when it is freed.
@ -297,6 +327,11 @@ bool tc_task_is_active(struct TCTask *task);
*/
bool tc_task_has_tag(struct TCTask *task, struct TCString *tag);
/**
* Get the tags for the task. The task must not be NULL.
*/
struct TCTags tc_task_get_tags(struct TCTask *task);
/**
* Set a mutable task's status.
*/
@ -348,6 +383,11 @@ TCResult tc_task_delete(struct TCTask *task);
*/
TCResult tc_task_add_tag(struct TCTask *task, struct TCString *tag);
/**
* Remove a tag from a mutable task.
*/
TCResult tc_task_remove_tag(struct TCTask *task, struct TCString *tag);
/**
* Get the latest error for a task, or NULL if the last operation succeeded. Subsequent calls
* to this function will return NULL. The task pointer must not be NULL. The caller must free the