7.3. 泛型参数 Arg

7.3.1. 头文件

  1. #include "dataArg.h"

7.3.2. 概述

  1. arg 泛型参数API是以 arg_ 为前缀的一系列函数。
  2. arg 中可以保存一个任意类型的值。
  3. arg 支持的类型有：int，float，pointer, string, null, bytes。
  4. arg 放入对象后，可以直接在 python 脚本中访问 arg 的值。

    7.3.3. 数据类型

    泛型参数的数据类型是 Arg。
    1. typedef struct Arg Arg;struct Arg {    Arg* next;    uint32_t size;    uint8_t type;    Hash name_hash;    uint8_t content[];};
    泛型参数内部包括头部信息 ( size, type, name_hash )，数据体 (content)，和用于构成链表的指针 (next)。 注意不要直接访问arg 内部的成员，请使用arg API访问arg 。以获得最大的向后兼容性。

    7.3.4. 泛型参数的新建和销毁

    - 从堆中新建一个泛型参数，返回泛型参数的指针。 注意新建的泛型参数需要手动销毁来回收内存。不断新建泛型参数但不销毁会导致内存泄漏。 [注意] 下列 api 需要内核版本不低于 v1.9.2
    1. Arg* arg_newInt(int val);Arg* arg_newFloat(double val);Arg* arg_newPtr(ArgType type, void* pointer);Arg* arg_newStr(char* val);Arg* arg_newNull(void);Arg* arg_newBytes(uint8_t* src, size_t size);
    新建 arg 传入的参数是 arg 的值。 -
    1. void arg_deinit(Arg* self);
    -
    1. Arg* arg_copy(Arg* self);
    传入泛型参数的指针，销毁泛型参数。

    7.3.5. 得到泛型参数的值

    使用以下API可以判断泛型参数的当前类型。
    1. ArgType arg_getType(Arg* self);
    使用以下的API可以将泛型参数转换为基本类型。
    1. int64_t arg_getInt(Arg* self);float arg_getFloat(Arg* self);void* arg_getPtr(Arg* self);char* arg_getStr(Arg* self);uint8_t* arg_getBytes(Arg* self);size_t arg_getBytesSize(Arg* self);

    7.3.6. 重要注意事项

    极易引起 内存泄漏或悬垂引用，导致 致命缺陷。 docker 开发环境 下进行开发，确保充足的单元测试和内存检查。

    7.3.7. 案例

    使用 arg 构建一个字符串列表
    1. #include "PikaStdData_List.h"...    /* 创建 list 对象 */    PikaObj* list = newNormalObj(New_PikaStdData_List);    /* 初始化 list */    PikaStdData_List___init__(list);    /* 用 arg_new<type> 的 api 创建 arg */    Arg* str_arg1 = arg_newStr("aaa");    /* 添加到 list 对象 */    PikaStdData_List_append(list, str_arg1);    /* 销毁 arg */    arg_deinit(str_arg1);...