7.3. C 模块可变参数

C 模块支持可变参数，使用 *xxx 的输入参数即可，在 C 层会将任意个数的参数打包进 PikaTuple 数据类型中，使用 pikaTuple_getSize() 可以获得可变参数的个数，使用 pikaTuple_getArg() 可以根据可变参数的位置得到 arg。同样支持 pikaTuple_get<Type> api，直接得到指定类型的值。

[注意]

需要内核版本 >= v1.11.7
如何可变参数和位置参数同时存在，则可变参数必须放在位置参数的后面

示例：

# test.pyi
def vals(a:int, *val):...

// test.c
void test_vals(PikaObj* self, int a, PikaTuple* val){
    printf("a: %d\n", a);
    for(int i =0; i< pikaTuple_getSize(val); i++){
        Arg* arg_i = pikaTuple_getArg(val, i);
        printf("val[%d]: %d\n", i, arg_getInt(arg_i));
    }
}

输出结果:

>>> test.vals(1, 2, 3, 4)
a: 1
val[0]: 2
val[1]: 3
val[2]: 4
>>>

7.4. C 模块关键词参数

C 模块支持关键词参数，使用 **xxx 的输入参数即可，在 C 层会将任意个数的参数打包进 PikaDict 数据类型中，使用 pikaDict_getArg() 可以根据关键词得到 arg。同样支持 pikaDict_get<Type>() api, 直接得到指定类型的值。

[注意]

需要内核版本 >= v1.11.7
关键词参数必须放在位置参数和可变参数的后面

示例：

# test.pyi
def keys(a:int, **keys):...

// test.c
void test_keys(PikaObj* self, int a, PikaDict* keys){
    printf("a: %d\n", a);
    printf("keys['b']: %d\n", i, pikaDict_getInt(keys, "b"));
    printf("keys['c']: %d\n", i, pikaDict_getInt(keys, "c"));
}

输出结果:

>>> test.keys(1, b=2, c=3)
a: 1
keys['b']: 2
keys['c']: 3
>>>

7.5. C 模块返回 List/Dict/Tuple

注意：需要内核版本 >= v1.12.5

7.5.1. List

# test.pyi
def test_list() -> list: ...

// test.c
#include "PikaObj.h"
PikaObj* test_test_list(PikaObj* self){
    /* 创建 list 对象 */
    PikaList* list = New_PikaList();
    /* 用 arg_new<type> 的 api 创建 arg, 添加到 list 对象 */
    pikaList_append(list, arg_newStr("aaa"));
    /* 返回列表 */
    return list;
}

7.5.2. Dict

# test.pyi
def test_dict() -> dict: ...

// test.c
#include "PikaObj.h"
PikaObj* test_test_dict(PikaObj* self){
    PikaDict* dict = New_PikaDict();
    pikaDict_set(dict, "para1", arg_newInt(1));
    pikaDict_set(dict, "para1", arg_newStr("2"));
    return dict;
}

7.5.3. Tuple

# test.pyi
def test_tuple() -> tuple: ...

// test.c
#include "PikaObj.h"
PikaObj* test_test_tuple(PikaObj* self){
    return New_PikaTupleFrom(arg_newInt(1), arg_newStr("2"));
}

7.6. C 模块常量

C 模块支持在类中或模块中加入常量，可以使用 val:type 的语法，这些常量需要在初始化时赋值，因此需要定义 __init__() 方法，例如：

class cJSON:
    cJSON_Invalid: int
    cJSON_False: int
    def __init__(self):...
    ...

void pika_cjson_cJSON___init__(PikaObj* self) {
    /* const value */
    obj_setInt(self, "cJSON_Invalid", cJSON_Invalid);
    obj_setInt(self, "cJSON_False", cJSON_False);
	...
}

这些常量可以不创建对象直接使用，即当作类属性来使用。

print(cJSON.cJSON_Invalid)

需要注意的是，PikaPython 的类属性是只读的，对类属性的所有修改都是无效的。

7.7. C 模块初始化

直接在 .pyi 中定义 __init__() 函数即可执行模块初始化，在模块载入时会触发执行，PikaPython 具有模块延时加载机制，import 不会直接触发模块加载，仅仅在第一次真正使用模块时，才会触发加载。

例如:

# test.pyi
def __init__():...
def hello():...

//test.c
void test___init__(PikaObj* self){
    printf("now loading module test...\n");
}

void test_hello(PikaObj* self){
    printf("hello!\n");
};

# main.py
import test
print('before run test.hello()')
test.hello()
print('after run test.hello()')

输出：

before run test.hello()
now loading module test...
hello!
after run test.hello()