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

落磊同学_8882

落磊同学_8882

2026-06-17

452人浏览

原创

必须编码的字符是除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 编码不同

示例片段:

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 = 'a' && c = '0' && c <h3>中文、emoji 等 Unicode 字符怎么处理?</h3><p>它们本身不是单字节,但只要输入 <code>std::string</code> 是合法 UTF-8 编码,上面的循环仍适用 —— 因为 UTF-8 多字节序列中每个字节都独立判断是否需要编码,而 UTF-8 的多字节首字节和后续字节均不属于 unreserved 集合,自然全被转成 <code>%XX</code>。</p><div class="aritcle_card flexRow artxards">
											<div class="artcardd flexRow">
												<a class="aritcle_card_img" rel="nofollow" href="/xiazai/gongju/2823" title="C++14"><img
														src="https://img.php.cn/upload/manual/001/431/639/6ac8b33c327c4749.png" alt="C++14" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
												<div class="aritcle_card_info flexColumn">
													<a rel="nofollow" href="/xiazai/gongju/2823" title="C++14" class="overflowclass">C++14</a>
													<p class="overflowclass">C++14 对 C++11 的修正与增强版本,适合旧系统维护和较老工具链兼容。</p>
												</div>
												<a rel="nofollow" href="/xiazai/gongju/2823" title="C++14" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span>
												</a>
											</div>
										</div><p>验证方式:用 <code>"你好"</code>(UTF-8 是 <code>\xE4\xBD\xA0\xE5\xA5\xBD</code>)喂给上面函数,输出应为 <code>%E4%B8%AD%E5%9B%BD</code>(注意大小写,RFC 推荐大写十六进制)。</p>
  • 不要尝试用 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 字符串”的转换,不负责决定“该不该编码”。

C++免费学习笔记(深入):立即使用
在学习笔记中,你将探索 C++ 的入门与实战技巧!

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

c++

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

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

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

2024.03.14

2268

9

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

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

2024.03.14

1039

6

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

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

2024.03.14

447

5

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

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

2024.03.14

327

5

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

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

2024.03.14

426

5

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

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

2024.03.14

600

5

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

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

2024.03.21

1429

9

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

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

2024.03.22

1237

7

c++和c语言学习顺序推荐
c++和c语言学习顺序推荐

对于初学者,建议先学习C语言,掌握编程基础后再转入C++,便于理解面向对象编程概念。有编程经验者可直接学习C++,快速接触高级编程技术。想了解更多c++和c语言的相关内容,可以阅读本专题下面的文章。

2024.03.25

1325

9

热门下载

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

精品课程

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

共0课时 | 0人学习

C++ Reference
C++ Reference

共0课时 | 0人学习

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

共0课时 | 0人学习