YottaDB / YDB

Mirrored from https://gitlab.com/YottaDB/DB/YDB
Other
76 stars 37 forks source link

ydb_delete_multi_s() and ydb_set_multi_s() functions #179

Open ksbhaskar opened 6 years ago

ksbhaskar commented 6 years ago

Final Release Note

Description

Functions deferred from initial implementation of Simple API in r1.20

Draft Release Note


ydb_delete_multi_s()

int ydb_delete_multi_s(int deltype,
    int namecount,
    ydb_buffer_t *varname,
    int subs_used,
    ydb_buffer_t *subsarray[, ...]);

namecount (>0) is the number of nodes specified in the call.

Deletes nodes in each of the local or global variable trees or subtrees specified. A value of YDB_DEL_NODE or YDB_DEL_TREE for deltype specifies whether to delete just the node at each root, leaving (sub)trees intact, or to delete nodes as well as (sub)trees.

Intrinsic special variables cannot be deleted.

ydb_delete_multi_s() returns YDB_OK or an error return code.


ydb_set_multi_s()

int ydb_set_multi_s(ydb_buffer_t *value,
    int namecount,
    ydb_buffer_t *varname,
    int subs_used,
    ydb_buffer_t *subsarray[, ...]);

Copies the value->len_used bytes at value->buf_addr as the value of the specified nodes or intrinsic special variables specified, returning YDB_OK or an error return code_. A NULL value parameter is treated as equivalent to one that points to a ydb_buffer_t specifying an empty string.

ydb_set_multi_s() returns YDB_OK or an error return code.