py cApi中 __annotations__怎么用

在Python中，`__annotations__`是Python 3.6及以上版本引入的一个特性，它允许你在函数和类的定义中提供类型注解，这是一种对变量预期类型的声明，并非强制约束，主要用于文档和静态类型检查工具。当你使用`pyc-api`（也就是C API）访问这个属性时，它是作为Python字典存在的，键是变量名，值是对应的类型注解。

例如，在一个函数定义里：

def calculate(a: int, b: float) -> float:
    """返回a和b的和"""
    return a + b
calculate.__annotations__

在C API层面，你可以这样做来获取这个信息：

PyObject* annotations_dict = PyDict_GetItemString(PyObject* func_obj, "__annotations__");
if (annotations_dict != NULL) {
    // 现在你可以遍历这个字典，获取每个变量及其对应的类型注解
    PyObject* key, *value;
    while (PyDict_Next(annotations_dict, &key, &value, NULL)) {
        const char* key_str = PyUnicode_AsUTF8(key);
        const char* value_str = PyUnicode_AsUTF8(value);  // 假设类型注解是字符串形式
        printf("Key: %s, Type: %s\n", key_str, value_str);
    }
}

请注意，实际应用时你需要处理可能出现的NULL值和错误情况，因为`__annotations__`并不是所有函数都有，也不是所有的类型注解都能转换成字符串。