字符串类型 KV 示例
该示例主要演示了字符串 KV 的相关功能,字符串 KV 作为一个特殊的 KV 类型,其 Key 与 Value 均为字符串,常被用于参数存储、命令存储等可读性要求较高的场景。
代码说明
示例代码位于 samples/kvdb_type_string.c ,使用一个名为 "temp" 的 KV 来存储温度值,分别演示了字符串 KV 从 创建->读取->修改->删除 的全过程。大致内容如下:
1. void kvdb_type_string_sample(fdb_kvdb_t kvdb)
2. {
3. FDB_INFO("==================== kvdb_type_string_sample ====================\n");
4. { /* CREATE new Key-Value */
5. char temp_data[10] = "36C";
7. /* It will create new KV node when "temp" KV not in database. */
8. fdb_kv_set(kvdb, "temp", temp_data);
9. FDB_INFO("create the 'temp' string KV, value is: %s\n", temp_data);
10. }
12. { /* GET the KV value */
13. char *return_value, temp_data[10] = { 0 };
15. /* Get the "temp" KV value.
16. * NOTE: The return value saved in fdb_kv_get's buffer. Please copy away as soon as possible.
17. */
18. return_value = fdb_kv_get(kvdb, "temp");
19. /* the return value is NULL when get the value failed */
20. if (return_value != NULL) {
21. strncpy(temp_data, return_value, sizeof(temp_data));
22. FDB_INFO("get the 'temp' value is: %s\n", temp_data);
23. }
24. }
26. { /* CHANGE the KV value */
27. char temp_data[10] = "38C";
29. /* change the "temp" KV's value to "38C" */
30. fdb_kv_set(kvdb, "temp", temp_data);
31. FDB_INFO("set 'temp' value to %s\n", temp_data);
32. }
34. { /* DELETE the KV by name */
35. fdb_kv_del(kvdb, "temp");
36. FDB_INFO("delete the 'temp' finish\n");
37. }
39. FDB_INFO("===========================================================\n");
40. }
运行日志
通过日志可以看出:
- 首先创建了一个 KV 名为
"temp",并给予初值 36℃ - 读取
"temp"KV 当前的值,发现与初值相同 - 修改
"temp"KV 的值为 38℃ - 最后删除
"temp"KV
1. [FlashDB][sample][kvdb][string] ==================== kvdb_type_string_sample ====================
2. [FlashDB][sample][kvdb][string] create the 'temp' string KV, value is: 36C
3. [FlashDB][sample][kvdb][string] get the 'temp' value is: 36C
4. [FlashDB][sample][kvdb][string] set 'temp' value to 38C
5. [FlashDB][sample][kvdb][string] delete the 'temp' finish
6. [FlashDB][sample][kvdb][string] ===========================================================
