如何在方法签名中注释指向 C 字符数组的指针？

Question

我正在为 Python 中的 C 库编写包装器。我正在尝试正确注释所有方法，因此我的 IDE 可以帮助我捕获错误。我在注释一种方法时卡住了，你能帮我找出正确的注释吗？

C 库中的一个方法的工作原理如下：

接受一个参数：指向字符缓冲区的指针
- 缓冲区通过以下方式创建：char_buffer = ctypes.create_string_buffer(16)
用输出值填充字符缓冲区
- 通过CMethod(char_buffer)

然后通过执行类似 char_buffer.value.

的操作来解析缓冲区

如何注释包装器方法以查找指向字符缓冲区的指针？目前，我有以下内容，但我认为这是不正确的，因为 POINTER 似乎只是 _ctypes.py.

中的一个函数

from ctypes import POINTER

def wrapped_method(char_buffer: POINTER):
    CMethod(char_buffer)

Answer 1

根据[Python.Docs]: ctypes.create_string_buffer(init_or_size, size=None)：

This function creates a mutable character buffer. The returned object is a ctypes array of c_char.

示例：

>>> import ctypes
>>>
>>> CharArr16 = ctypes.c_char * 16
>>> s = ctypes.create_string_buffer(16)
>>>
>>> isinstance(s, CharArr16)
True
>>> isinstance(s, ctypes.c_char * 15)
False
>>> isinstance(s, ctypes.c_char * 17)
False
>>>
>>> # A more general form, but it WILL FAIL for non array instances
...
>>> isinstance(s, s._type_ * s._length_)
True
>>>
>>> # A more general form that WILL WORK
...
>>> issubclass(CharArr16, ctypes.Array)
True
>>> isinstance(s, ctypes.Array)
True

如何在方法签名中注释指向 C 字符数组的指针？

How to annotate pointer to C character array in method signature?

python

ctypes

pointers

annotations