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

C++如何实现字符串的URL编码(Percent Encoding)

落磊同学_8882

落磊同学_8882

发布时间:2026-06-17 13:17:51

|

452人浏览过

|

来源于php中文网

原创

必须编码的字符是除A-Z、a-z、0-9、-、.、_、~以外的所有字符,包括空格(%20)、/、?、#、%等;中文和emoji按UTF-8字节逐字节编码,且输入必须为UTF-8字符串。

c++如何实现字符串的url编码(percent encoding)

哪些字符必须被编码?

URL 编码不是对所有字符都处理,只对非 unreserved 字符做 %XX 转义。RFC 3986 明确规定,A-Z、a-z、0-9、-、.、_、~ 这些是 unreserved 字符,可原样保留;空格要变 %20,斜杠 /、问号 ?、井号 # 等在 URL 中有特殊含义的字符,若作为数据内容出现,也必须编码(除非你明确知道它处于 URL 的哪一段且语义安全)。

常见错误是“看到非 ASCII 就 hex 编码”,比如把中文直接按 UTF-8 字节逐个转 %XX —— 这是对的,但前提是先确保输入是 UTF-8 编码字符串;如果源字符串是 GBK 或其他编码,直接编码会导致乱码 URL。

如何用 C++ 标准库(无第三方依赖)实现

C++11 及以上没有内置 URL 编码函数,得手写。核心逻辑就三步:遍历每个字节 → 判断是否需编码 → 是则转成 %XX 格式。

  • 对 std::string 输入,**假设它是 UTF-8 编码**(这是现代 Web 场景事实标准)
  • 不能简单用 isalnum(),因为它按 locale 判断,且不包含 -._~
  • 推荐用查表法或 lambda 匿名判断:例如 [&](unsigned char c) { return !((c >= 'A' && c = 'a' && c = '0' && c
  • 注意:空格(ASCII 32)必须编码为 %20,不是 + —— 后者是 application/x-www-form-urlencoded 的规则,和纯 URL 编码不同

示例片段:

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

C++14
C++14

C++14 对 C++11 的修正与增强版本,适合旧系统维护和较老工具链兼容。

下载
std::string url_encode(const std::string& s) {
    std::string out;
    out.reserve(s.size() * 3);
    for (unsigned char c : s) {
        if ((c >= 'A' && c <= 'Z') || (c >= 'a' && c <= 'z') ||
            (c >= '0' && c <= '9') || c == '-' || c == '.' || c == '_' || c == '~') {
            out += c;
        } else {
            out += '%';
            out += "0123456789ABCDEF"[c / 16];
            out += "0123456789ABCDEF"[c % 16];
        }
    }
    return out;
}

中文、emoji 等 Unicode 字符怎么处理?

它们本身不是单字节,但只要输入 std::string 是合法 UTF-8 编码,上面的循环仍适用 —— 因为 UTF-8 多字节序列中每个字节都独立判断是否需要编码,而 UTF-8 的多字节首字节和后续字节均不属于 unreserved 集合,自然全被转成 %XX。

验证方式:用 "你好"(UTF-8 是 \xE4\xBD\xA0\xE5\xA5\xBD)喂给上面函数,输出应为 %E4%B8%AD%E5%9B%BD(注意大小写,RFC 推荐大写十六进制)。

  • 不要尝试用 std::wstring + std::codecvt_utf8 —— std::codecvt_utf8 在 C++17 已被弃用,且跨平台行为不一致
  • 如果输入是 std::u8string(C++20),可直接遍历,但底层仍是 UTF-8 字节流,处理逻辑不变
  • 浏览器地址栏显示的“中文 URL”是 UI 层解码结果,实际 HTTP 请求中仍是百分号编码形式

性能与边界情况要注意什么?

高频调用时,out += 可能触发多次内存重分配。用 reserve() 是基本优化,但更稳的方式是预估最大长度(原始长度 × 3)并一次性分配。

  • 空字符串、全 unreserved 字符串(如 "hello-world")应零编码,返回原串
  • '%' 字符本身必须编码为 %25,否则会破坏 URL 结构 —— 上面逻辑已覆盖(因为 '%' 不在 unreserved 表中)
  • 不处理 %AB 这类已编码片段的双重编码问题 —— URL 编码是“原始数据→编码”,不是“解码再编码”。若需对已有 URL 的 query 值二次编码,应先提取原始值,而非对整个 URL 字符串操作
  • Windows 下若读文件得到 \r\n,别忘了换行符也要编码(\r → %0D,\n → %0A)

真正容易被忽略的是编码上下文:query 参数值、path segment、fragment 内容的编码规则一致,但 host 和 scheme 绝对不能编码 —— 函数只负责“字符串到 percent-encoded 字符串”的转换,不负责决定“该不该编码”。

热门AI工具

更多
WorkBuddy

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

二狗PPT
二狗PPT Hot

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

立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

Seko
Seko Hot

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

音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

豆包大模型

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

DeepSeek

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

讯飞绘文

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

相关专题

更多
c++和c语言的区别有哪些
c++和c语言的区别有哪些

c++和c语言的区别:1、面向对象编程(OOP)支持不同;2、新增特性不同;3、标准库不同;4、编译方式不同;5、命名空间不同等等。想了解更多c++的相关内容,可以阅读本专题下面的文章。

2268

2024.03.14

c++和python学习顺序推荐
c++和python学习顺序推荐

一般建议先学习C++,再学习Python,因为这样可以逐步从较为底层的编程语言向更高级的语言过渡。想了解更多python的相关内容,可以阅读本专题下面的文章。

1039

2024.03.14

python和c++学习性价比分析
python和c++学习性价比分析

Python易于学习,广泛应用于Web开发、数据科学和人工智能等领域,但性能较低。C语言性能高,适用于对性能要求较高的场景,如游戏开发和系统编程,但学习曲线陡峭,错误处理复杂。想了解更多python的相关内容,可以阅读本专题下面的文章。

447

2024.03.14

c语言和c++一样吗
c语言和c++一样吗

c语言和c++是两种不同的编程语言,虽然有相似之处,但存在显著差异。c语言专注于过程式编程和系统级开发,以简洁、高效著称。c++作为c语言的超集,引入了面向对象编程,增强了代码组织和管理能力,但学习曲线也更陡峭。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

327

2024.03.14

c语言和c++先学哪个好
c语言和c++先学哪个好

初学者选择学习c语言还是c++语言,需要根据个人学习目标、背景以及编程兴趣和预期应用方向来决定。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

426

2024.03.14

c语言和c++的区别和联系
c语言和c++的区别和联系

c语言和c++是计算机科学领域应用广泛的编程语言。虽然它们有着相似的基础,但它们在语言类型、语法功能和内存管理方面存在着显著差异。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

600

2024.03.14

c++软件中文更改教程
c++软件中文更改教程

对于 ide,可通过打开设置,找到语言设置,选择中文,并保存更改。对于非 ide 应用程序,可查找设置或选项,选择语言设置,更改为中文,并保存更改。想了解更多c++的相关内容,可以阅读本专题下面的文章。

1429

2024.03.21

python和java和c++学习性价比分析
python和java和c++学习性价比分析

Python以其易学性、丰富的库和活跃的社区而著称,适合数据科学、人工智能和Web开发。Java以其跨平台性、企业级应用开发和Android应用开发而闻名。C++以其底层控制能力、高效性能和游戏开发而著称。选择哪种语言取决于个人兴趣、职业方向和特定需求。想了解更多python和java和c++的相关内容,可以阅读本专题下面的文章。

1237

2024.03.22

Gradle插件开发入门教程
Gradle插件开发入门教程

本专题介绍Gradle插件开发的基本流程,涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法,帮助你理解插件如何组织构建逻辑,减少多个项目之间的重复配置。

100

2026.10.22

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
C++ Core Guidelines
C++ Core Guidelines

共0课时 | 0人学习

C++ Reference
C++ Reference

共0课时 | 0人学习

C++ 官方标准说明
C++ 官方标准说明

共0课时 | 0人学习

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

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