字符串类型 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] ===========================================================