要打印通过结构体指针返回的测试结果，核心是使用`ctypes`模块正确解析从C/C++ DLL返回的结构体数据。以下是具体步骤和代码示例。 ### 1. 定义对应的Python结构体类 首先，需要根据C/C++中的结构体定义，在Python中创建一个对应的类，继承自`ctypes.Structure`。假设C结构体定义如下： ```c typedef struct { unsigned char data1[64]; unsigned char data2[64]; int status; } TestResult; ``` 对应的Python结构体定义为： ```python import ctypes class TestResult(ctypes.Structure): _fields_ = [ ('data1', ctypes.c_ubyte * 64), # 64字节无符号字符数组 ('data2', ctypes.c_ubyte * 64), # 另一个64字节数组 ('status', ctypes.c_int) # 整型状态码 ] ``` 这里使用`ctypes.c_ubyte * 64`来创建长度为64的数组类型，它完全对应C中的`unsigned char[64]` [ref_3][ref_4]。 ### 2. 加载DLL并声明函数原型 接下来，加载动态链接库并声明函数原型，指定参数和返回类型。 ```python # 加载DLL my_dll = ctypes.WinDLL('./mytest.dll') # Windows系统 # 或 my_dll = ctypes.CDLL('./mytest.so') # Linux系统 # 声明函数原型 my_dll.test_function.argtypes = [ctypes.POINTER(TestResult)] # 参数为结构体指针 my_dll.test_function.restype = None # 假设函数返回void ``` `ctypes.POINTER(TestResult)` 表示一个指向`TestResult`结构体的指针类型，这与C语言中`TestResult*`是等价的 [ref_1][ref_3]。 ### 3. 调用函数并获取结果 创建一个结构体实例，并将其指针传递给函数。函数执行后，结果会填充到这个结构体实例中。 ```python # 创建结构体实例 result = TestResult() # 调用函数，传入结构体的指针（引用） my_dll.test_function(ctypes.byref(result)) # 或者使用指针方式 # my_dll.test_function(ctypes.pointer(result)) ``` `ctypes.byref(result)` 是获取结构体引用的高效方式，通常用于输入/输出参数 [ref_3][ref_6]。 ### 4. 打印结构体中的测试结果 打印数据的关键是正确处理字节数组。以下是几种打印方式： **a. 打印为原始字节的十六进制字符串（最直接）** ```python def print_result(res): print("状态码:", res.status) # 将data1数组转换为bytes对象，然后格式化为十六进制字符串 data1_bytes = bytes(res.data1) print("数据1 (十六进制):", data1_bytes.hex()) # 如果需要更可读的格式（如带空格分隔） hex_str = ' '.join(f'{b:02x}' for b in data1_bytes) print("数据1 (格式化):", hex_str) # 同样处理data2 data2_bytes = bytes(res.data2) print("数据2 (十六进制):", data2_bytes.hex()) # 调用打印函数 print_result(result) ``` **b. 如果数组内容是字符串（以null结尾）** ```python def print_as_string(res): print("状态码:", res.status) # 假设data1是一个以null结尾的C字符串 # ctypes.string_at可以获取直到null终止符的数据 str_data1 = ctypes.string_at(ctypes.addressof(res.data1)) print("数据1 (字符串):", str_data1.decode('utf-8', errors='ignore')) # 或者使用cast转换为c_char_p str_ptr = ctypes.cast(res.data1, ctypes.c_char_p) print("数据1 (c_char_p):", str_ptr.value.decode()) # 调用打印函数 print_as_string(result) ``` **c. 逐字节打印（用于调试）** ```python def print_byte_by_byte(res): print("=== 详细数据 ===") print(f"状态码: {res.status}") print("\n数据1 内容:") for i, byte in enumerate(res.data1): print(f" [{i:02d}]: 0x{byte:02x} ({byte:3d})", end=' ') if (i + 1) % 8 == 0: print() # 每8字节换行 print("\n\n数据2 内容:") for i, byte in enumerate(res.data2): print(f" [{i:02d}]: 0x{byte:02x}", end=' ') if (i + 1) % 16 == 0: print() # 每16字节换行 # 调用打印函数 print_byte_by_byte(result) ``` ### 5. 完整示例代码 下面是一个完整的示例，演示了从定义到打印的全过程： ```python import ctypes # 1. 定义结构体 class TestResult(ctypes.Structure): _fields_ = [ ('data1', ctypes.c_ubyte * 64), ('data2', ctypes.c_ubyte * 64), ('status', ctypes.c_int) ] # 2. 加载DLL try: my_dll = ctypes.WinDLL('./mytest.dll') # 根据实际情况修改DLL路径 print("DLL加载成功") except Exception as e: print(f"DLL加载失败: {e}") exit(1) # 3. 设置函数原型 my_dll.test_function.argtypes = [ctypes.POINTER(TestResult)] my_dll.test_function.restype = None # 4. 准备结构体和调用函数 result = TestResult() print("调用测试函数...") my_dll.test_function(ctypes.byref(result)) # 5. 打印结果 print("\n=== 测试结果 ===") print(f"状态码: {result.status}") # 打印数据1 data1_list = list(result.data1) print(f"数据1长度: {len(data1_list)} 字节") print(f"数据1前10字节: {data1_list[:10]}") print(f"数据1十六进制: {bytes(result.data1).hex()[:20]}...") # 只显示前20个字符 # 打印数据2 print(f"\n数据2长度: {len(list(result.data2))} 字节") print(f"数据2十六进制完整: {bytes(result.data2).hex()}") # 6. 高级处理：如果数据是特定格式 # 例如，假设data1前4字节是一个32位整数 if len(data1_list) >= 4: # 小端序解析 int_value = (data1_list[3] << 24) | (data1_list[2] << 16) | (data1_list[1] << 8) | data1_list[0] print(f"\n数据1前4字节解析为整数(小端): {int_value}") # 使用ctypes的cast方法 int_ptr = ctypes.cast(ctypes.addressof(result.data1), ctypes.POINTER(ctypes.c_int32)) print(f"通过cast解析的整数: {int_ptr.contents.value}") ``` ### 关键注意事项 1. **内存对齐**：如果C结构体使用了特殊的对齐方式（如`#pragma pack(1)`），需要在Python结构体定义中指定`_pack_`属性 [ref_3]： ```python class TestResult(ctypes.Structure): _pack_ = 1 # 1字节对齐 _fields_ = [ ... ] ``` 2. **指针与引用**： - `ctypes.byref()`：获取对象的引用，适合用作输入/输出参数 [ref_6] - `ctypes.pointer()`：创建新的指针对象 - `ctypes.POINTER(type)`：创建指针类型 3. **字节序处理**：如果数据中包含多字节整数，需要注意字节序。可以使用`struct`模块进行精确解析： ```python import struct # 解析data1前4字节为大端序整数 int_value = struct.unpack('>I', bytes(result.data1[:4]))[0] ``` 4. **空指针检查**：如果函数可能返回NULL指针，需要检查： ```python if not result: print("函数返回了空指针") ``` 这种方法确保了Python代码能够正确地从C/C++函数接收结构体数据，并以可读的方式打印出来，适用于各种接口测试场景 [ref_2][ref_4]。