讲师中心 微信公众号
AI工具推荐 视频效率加速

Python ctypes中传递字符串的正确方法:字节串与宽字符处理

梦强姑娘_2182

梦强姑娘_2182

发布时间:2026-08-28 15:29:09

|

308人浏览过

|

来源于php中文网

原创

Python ctypes中传递字符串的正确方法:字节串与宽字符处理

在Python中使用ctypes调用C函数时,若传入普通Unicode字符串(如"Test")给声明为c_char_p的参数,会因类型不匹配抛出ArgumentError;正确做法是显式传递字节串(如b'Test')或改用c_wchar_p配合Unicode字符串。

在python中使用ctypes调用c函数时,若传入普通unicode字符串(如"test")给声明为`c_char_p`的参数,会因类型不匹配抛出`argumenterror`;正确做法是显式传递字节串(如`b'test'`)或改用`c_wchar_p`配合unicode字符串。

该错误的根本原因在于:ctypes.c_char_p 对应 C 中的 char *,它期望接收一个字节序列(bytes),而非 Python 3 默认的 Unicode 字符串(str)。当您直接写 init_hello("Test") 时,传入的是 str 类型,ctypes 无法自动将其转换为 C 兼容的 char*,因此触发 TypeError: wrong type。

✅ 正确解决方案

方案一:使用字节串(推荐,跨平台、轻量)

将字符串显式编码为 bytes,并以 b'' 前缀书写:

import ctypes

lib = ctypes.cdll.LoadLibrary('./test.so')
hello = lib.hello
hello.argtypes = [ctypes.c_char_p]
hello.restype = None  # 显式声明返回类型更安全(原C函数无返回值)

hello(b"Test")  # ✅ 正确:传入 bytes 对象

⚠️ 注意:b"Test" 是 bytes 类型,等价于 "Test".encode('ascii')。若字符串含非ASCII字符(如 "你好"),需确保编码一致,例如:

hello("你好".encode('utf-8'))  # ✅ 显式 UTF-8 编码

方案二:使用宽字符(适合 Unicode 密集场景)

修改 C 函数签名,使用 wchar_t*,并在 Python 中对应使用 c_wchar_p:

立即学习“Python免费学习笔记(深入)”;

python 查询技能
python 查询技能

查询客流数据,输出JSON格式,可直接导入Bitable等可视化工具

下载

C 端(shared.c):

#include <stdio.h>
#include <wchar.h>

void hello(wchar_t *name) {
    wprintf(L"Hello, %ls\n", name); // 注意 L"..." 和 %ls
}

编译(需链接 wchar 支持):

gcc -shared -fPIC shared.c -o test.so

Python 端:

import ctypes

lib = ctypes.cdll.LoadLibrary('./test.so')
hello = lib.hello
hello.argtypes = [ctypes.c_wchar_p]  # ✅ 匹配 wchar_t*
hello.restype = None

hello("Test")        # ✅ 直接传 str(自动转 wchar_t*)
hello("你好")        # ✅ 原生支持 Unicode

❌ 常见误区澄清

  • create_string_buffer("Test".encode()) 创建的是可变缓冲区,适用于需要 C 函数写入数据的场景(如输出参数),本例中仅需只读传参,无需额外封装。
  • loader.c 中的 hello(char *name); 调用语法错误(不应带类型声明),且 main() 中 hello(char *name) 是非法 C 表达式——该文件实际未被使用,可忽略。
  • restype = c_bool 与 C 函数 void hello(...) 不匹配,应设为 None 或 ctypes.c_void_p。

总结

场景 C 类型 Python 类型 示例
ASCII / UTF-8 字符串(通用) char * bytes b"Hello" 或 "Hello".encode('utf-8')
Unicode 字符串(需 C 端支持宽字符) wchar_t * str "你好"(自动转换)

牢记:ctypes 不做隐式字符串编码转换。明确数据类型边界,是避免 ArgumentError 的关键。

热门AI工具

更多
WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

相关专题

更多
python打包成可执行文件
python打包成可执行文件

本专题为大家带来python打包成可执行文件相关的文章,大家可以免费的下载体验。

1711

2023.07.20

python能做什么
python能做什么

python能做的有:可用于开发基于控制台的应用程序、多媒体部分开发、用于开发基于Web的应用程序、使用python处理数据、系统编程等等。本专题为大家提供python相关的各种文章、以及下载和课程。

4364

2023.07.25

format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

1689

2023.07.31

python教程
python教程

Python已成为一门网红语言,即使是在非编程开发者当中,也掀起了一股学习的热潮。本专题为大家带来python教程的相关文章,大家可以免费体验学习。

25517

2023.08.03

python环境变量的配置
python环境变量的配置

Python是一种流行的编程语言,被广泛用于软件开发、数据分析和科学计算等领域。在安装Python之后,我们需要配置环境变量,以便在任何位置都能够访问Python的可执行文件。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

3107

2023.08.04

python eval
python eval

eval函数是Python中一个非常强大的函数,它可以将字符串作为Python代码进行执行,实现动态编程的效果。然而,由于其潜在的安全风险和性能问题,需要谨慎使用。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

3127

2023.08.04

scratch和python区别
scratch和python区别

scratch和python的区别:1、scratch是一种专为初学者设计的图形化编程语言,python是一种文本编程语言;2、scratch使用的是基于积木的编程语法,python采用更加传统的文本编程语法等等。本专题为大家提供scratch和python相关的文章、下载、课程内容,供大家免费下载体验。

1163

2023.08.11

python合并两个列表
python合并两个列表

Python是一种强大的编程语言,具有许多方便的功能和工具。在Python中,有多种方法可以合并两个列表。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

596

2023.08.10

PixTV官网入口地址合集
PixTV官网入口地址合集

本专题汇总了 PixTV AI 一站式视频创作平台的官方入口与使用教程。无需下载软件,浏览器直接访问即可使用。平台将剧本、图像、视频、声音与剪辑整合在“无限画布”中,接入 GPT Image 2.5、Seedance 2.5 等头部模型。本专题整理了从新建画布、角色锚定、分镜拆分到视频生成与导出的完整操作指南,助你快速上手 AI 短剧与漫剧创作。

80

2026.10.10

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn