课程代码仓库初始化:Part1 (144) + Part3 (29) 全量生成与验证
把川大 wiki「02.Qt方向」课程代码整理为 CMake 管理的可编译运行项目。
Part1 C/C++ 强化 (p01/, 144 目标, host gcc/g++ 构建, 全绿):
- 修复全部编译失败:补 <cstring>/<fstream>/<iomanip>/<vector> 等缺失头
(common_fix + infer_stl_includes 自动检测注入)、修正 pause() 壳注入
(改检测已转换后的 pause 调用)、namespace 提升出函数体、const 成员函数
正确性、dedupe 不再破坏函数重载集、K&R 隐式 int / 动态异常规范等
C++17 移除特性的可编译等价改写。
- 目录采用深缩写 p01/ch04/s03/ (原 part1_cpp/ch04_class_object/03_ctor_dtor)。
Part3 Qt 桌面 (p03/, 29 目标, 隔离 Qt 5.14.2 构建, 全绿):
- gen_part3.py: Qt 外壳模板 (main+QApplication+show, QTimer 自动退出便于
offscreen 验证)、AUTOMOC + .moc include、rewrite_* 处理散文混入/重载/
资源依赖、生成占位 png/gif + .qrc + rundata 样例数据。
- 修正 QLable 笔误、全角分号、.→->、Windows 路径、QApplication 阻塞事件
循环改为 QCoreApplication 等。
任务1 概念/版本验证:
- tools/std_probe.py: 跨 -std= 编译探针 (--pedantic-errors 让已废除特性硬失败)。
- tools/demo_versions/: K&R 隐式 int、三目左值、void* 转换、enum 赋整、
const 经指针、动态异常规范 共 6 个跨版本演示。
- docs/VERSION_NOTES.md: 每条「原文说法→C17/C++17 是否成立→何版本成立→已验证」。
文档: 顶层 README、docs/SOURCE_PAGES.md (页面→目录映射)、
docs/ERRATA.md (Part1 修正)、docs/ERRATA_part3.md (Part3 修正)。
另修复 tools/run.sh / run_qt.sh 的 ${1:?...} 引号语法 bug。
隔离 Qt 验证: ldd 0 系统 Qt 引用; 173/173 目标全绿; p03 offscreen 运行通过。
This commit is contained in:
+437
@@ -0,0 +1,437 @@
|
||||
# ERRATA — 代码修正记录
|
||||
|
||||
本文件由 `tools/gen_part1.py` 自动生成,记录对 wiki 原始代码块的每一处修正。
|
||||
格式:`[pageId:blockIdx]` 类型 → 原内容 → 修正后 → 依据。
|
||||
|
||||
## [58954439:3] illegal-in-function
|
||||
|
||||
- **原文**:`namespace 定义 / 命名空间作用域成员函数定义 写在函数体内(void test(){ namespace A{...} })`
|
||||
- **修正**:`把 namespace 块与成员定义提升到文件作用域,test() 仅使用其成员`
|
||||
- **依据**:C++ 不允许在函数体内定义 namespace 或其成员函数;标准要求它们处于全局/命名空间作用域。原 wiki 写法无法编译;提升后保留教学意图。
|
||||
|
||||
## [58954439:6] illegal-in-function
|
||||
|
||||
- **原文**:`namespace 定义 / 命名空间作用域成员函数定义 写在函数体内(void test(){ namespace A{...} })`
|
||||
- **修正**:`把 namespace 块与成员定义提升到文件作用域,test() 仅使用其成员`
|
||||
- **依据**:C++ 不允许在函数体内定义 namespace 或其成员函数;标准要求它们处于全局/命名空间作用域。原 wiki 写法无法编译;提升后保留教学意图。
|
||||
|
||||
## [58954439:7] illegal-in-function
|
||||
|
||||
- **原文**:`namespace 定义 / 命名空间作用域成员函数定义 写在函数体内(void test(){ namespace A{...} })`
|
||||
- **修正**:`把 namespace 块与成员定义提升到文件作用域,test() 仅使用其成员`
|
||||
- **依据**:C++ 不允许在函数体内定义 namespace 或其成员函数;标准要求它们处于全局/命名空间作用域。原 wiki 写法无法编译;提升后保留教学意图。
|
||||
|
||||
## [58954439:14] removed-feature
|
||||
|
||||
- **原文**:`K&R 隐式 int(int fun1(i)、g(){...})及无类型参数 fun3() 接受任意实参`
|
||||
- **修正**:`显式 int(int fun1(int i)、int g(void){...}),fun2 形参显式为 char*,fun3() → fun3(void)、调用改为 fun3()(C17 不允许向 (void) 函数传参)`
|
||||
- **依据**:隐式 int 与无类型/可变参数在 C99 起被废除,C17 不可编译。原始 C89 形式仍可由 tools/std_probe.py 与 tools/demo_versions/kr_implicit_int.c 在 -std=c89 下演示。
|
||||
|
||||
## [58954439:24] missing-symbol
|
||||
|
||||
- **原文**:`const Person 演示引用 Person,但 Person 定义在另一小节(拆分为独立文件后丢失)`
|
||||
- **修正**:`在本块顶部补一个最小 Person 定义(age 带默认成员初始化,使 const 对象可默认构造)`
|
||||
- **依据**:原 wiki 把 Person 定义与 const 演示放在同节、本应同文件;按「示例相对隔离」拆开后本块自洽编译所需的最小前置定义。const 聚合对象需默认成员初始化才能默认构造(C++17)。
|
||||
|
||||
## [58954439:38] syntax
|
||||
|
||||
- **原文**:`class Person{...}(末尾缺分号)`
|
||||
- **修正**:`class Person{...};`
|
||||
- **依据**:C++ 类/结构体定义后必须有分号。
|
||||
|
||||
## [58954439:41] illegal-in-function
|
||||
|
||||
- **原文**:`namespace A/B 定义(含重载集 MyFunc)写在函数体内(void test(){ namespace A{...} })`
|
||||
- **修正**:`把 namespace 块提升到文件作用域,test() 通过 A::/B:: 调用各重载`
|
||||
- **依据**:C++ 不允许在函数体内定义 namespace;标准要求其处于全局/命名空间作用域。原 wiki 写法无法编译;提升后保留重载集演示意图。
|
||||
|
||||
## [58954439:42] ambiguous-overload
|
||||
|
||||
- **原文**:`main 中 MyFunc("hello") 在 MyFunc(string) 与 MyFunc(string,int=10) 间二义,无法编译`
|
||||
- **修正**:`注释保留二义调用作说明,main 只显式调用双参重载(单参形式因二义不可调用)`
|
||||
- **依据**:函数重载遇上默认参数时,编译器无法在两个可行候选间抉择(二义性)。即使强转 std::string 也无法消除——两候选对单个 string 实参同等匹配。原文意在演示此现象,作为可运行示例只能保留可调用的双参形式并注释说明二义点。
|
||||
|
||||
## [58954439:46] missing-definition
|
||||
|
||||
- **原文**:`main 调用 func1()/func2(),但本文件仅有 extern "C" 声明(定义在配对的 MyModule.c)`
|
||||
- **修正**:`在本文件就地补 func1/func2 的 extern "C" 定义(最小实现)`
|
||||
- **依据**:原 wiki 把声明与定义分属两文件;按「示例相对隔离」拆分为独立目标后,本文件缺少定义导致链接失败。补最小实现使其自洽可运行,保留 extern "C" 声明的教学意图。
|
||||
|
||||
## [58954448:0] missing-include
|
||||
|
||||
- **原文**:`调用 strcpy/strlen/strcmp 等 C 字符串函数但未 #include <cstring>`
|
||||
- **修正**:`由生成模板统一补 #include <cstring>`
|
||||
- **依据**:C 字符串/内存函数声明在 <cstring>(C++)/ <string.h>(C);原 wiki 代码依赖教学环境传递包含,隔离编译时须显式 include。
|
||||
|
||||
## [58954451:0] missing-include
|
||||
|
||||
- **原文**:`调用 strcpy/strlen/strcmp 等 C 字符串函数但未 #include <cstring>`
|
||||
- **修正**:`由生成模板统一补 #include <cstring>`
|
||||
- **依据**:C 字符串/内存函数声明在 <cstring>(C++)/ <string.h>(C);原 wiki 代码依赖教学环境传递包含,隔离编译时须显式 include。
|
||||
|
||||
## [58954451:1] missing-include
|
||||
|
||||
- **原文**:`使用 STL/IO 符号(如 vector/for_each/ifstream/setw 等)但未 #include <algorithm>`
|
||||
- **修正**:`由生成模板统一补 #include <algorithm>`
|
||||
- **依据**:原 wiki 代码假定教学环境已传递包含相应标准库头;按「示例相对隔离」独立编译时须显式 include。检测依据为符号使用(见 gen_sources.infer_stl_includes)。
|
||||
|
||||
## [58954451:2] missing-include
|
||||
|
||||
- **原文**:`使用 STL/IO 符号(如 vector/for_each/ifstream/setw 等)但未 #include <algorithm>`
|
||||
- **修正**:`由生成模板统一补 #include <algorithm>`
|
||||
- **依据**:原 wiki 代码假定教学环境已传递包含相应标准库头;按「示例相对隔离」独立编译时须显式 include。检测依据为符号使用(见 gen_sources.infer_stl_includes)。
|
||||
|
||||
## [58954451:3] missing-include
|
||||
|
||||
- **原文**:`调用 strcpy/strlen/strcmp 等 C 字符串函数但未 #include <cstring>`
|
||||
- **修正**:`由生成模板统一补 #include <cstring>`
|
||||
- **依据**:C 字符串/内存函数声明在 <cstring>(C++)/ <string.h>(C);原 wiki 代码依赖教学环境传递包含,隔离编译时须显式 include。
|
||||
|
||||
## [58954451:7] missing-include
|
||||
|
||||
- **原文**:`调用 strcpy/strlen/strcmp 等 C 字符串函数但未 #include <cstring>`
|
||||
- **修正**:`由生成模板统一补 #include <cstring>`
|
||||
- **依据**:C 字符串/内存函数声明在 <cstring>(C++)/ <string.h>(C);原 wiki 代码依赖教学环境传递包含,隔离编译时须显式 include。
|
||||
|
||||
## [58954451:8] pseudo-code
|
||||
|
||||
- **原文**:`new Person / malloc / 构造函数(中文散文混入语句,不可编译)`
|
||||
- **修正**:`可编译对照程序:new vs malloc+placement new,散文转注释`
|
||||
- **依据**:原文是对照式伪代码(含「相当于:」「构造函数」等中文散文),无法编译。改为可编译的 new 与 malloc 行为对照(用 placement new 对齐构造语义)。
|
||||
|
||||
## [58954451:9] missing-include
|
||||
|
||||
- **原文**:`调用 strcpy/strlen/strcmp 等 C 字符串函数但未 #include <cstring>`
|
||||
- **修正**:`由生成模板统一补 #include <cstring>`
|
||||
- **依据**:C 字符串/内存函数声明在 <cstring>(C++)/ <string.h>(C);原 wiki 代码依赖教学环境传递包含,隔离编译时须显式 include。
|
||||
|
||||
## [58954451:11] missing-include
|
||||
|
||||
- **原文**:`调用 strcpy/strlen/strcmp 等 C 字符串函数但未 #include <cstring>`
|
||||
- **修正**:`由生成模板统一补 #include <cstring>`
|
||||
- **依据**:C 字符串/内存函数声明在 <cstring>(C++)/ <string.h>(C);原 wiki 代码依赖教学环境传递包含,隔离编译时须显式 include。
|
||||
|
||||
## [58954451:12] missing-include
|
||||
|
||||
- **原文**:`调用 strcpy/strlen/strcmp 等 C 字符串函数但未 #include <cstring>`
|
||||
- **修正**:`由生成模板统一补 #include <cstring>`
|
||||
- **依据**:C 字符串/内存函数声明在 <cstring>(C++)/ <string.h>(C);原 wiki 代码依赖教学环境传递包含,隔离编译时须显式 include。
|
||||
|
||||
## [58954451:13] platform
|
||||
|
||||
- **原文**:`system("pause")`
|
||||
- **修正**:`pause()`
|
||||
- **依据**:system("pause") 仅 Windows 可用;改用仓库提供的便携 pause() 壳函数 (读一行 stdin 等待回车),行为一致,Linux 可编译运行。
|
||||
|
||||
## [58954456:1] platform
|
||||
|
||||
- **原文**:`system("pause")`
|
||||
- **修正**:`pause()`
|
||||
- **依据**:system("pause") 仅 Windows 可用;改用仓库提供的便携 pause() 壳函数 (读一行 stdin 等待回车),行为一致,Linux 可编译运行。
|
||||
|
||||
## [58954456:2] platform
|
||||
|
||||
- **原文**:`system("pause")`
|
||||
- **修正**:`pause()`
|
||||
- **依据**:system("pause") 仅 Windows 可用;改用仓库提供的便携 pause() 壳函数 (读一行 stdin 等待回车),行为一致,Linux 可编译运行。
|
||||
|
||||
## [58954456:3] const-correctness
|
||||
|
||||
- **原文**:`const 成员函数 ChangePerson() const 内修改非 mutable 成员 mAge(mAge = 100)`
|
||||
- **修正**:`注释掉对 mAge 的修改,保留对 mutable mID 的修改,并加注释说明`
|
||||
- **依据**:const 成员函数承诺不修改对象的逻辑状态,故不得修改非 mutable 数据成员;mID 被 mutable 修饰例外。原写法在 C++17 下编译报错。
|
||||
|
||||
## [58954457:0] platform
|
||||
|
||||
- **原文**:`system("pause")`
|
||||
- **修正**:`pause()`
|
||||
- **依据**:system("pause") 仅 Windows 可用;改用仓库提供的便携 pause() 壳函数 (读一行 stdin 等待回车),行为一致,Linux 可编译运行。
|
||||
|
||||
## [58954458:3] typo
|
||||
|
||||
- **原文**:`;(全角分号)`
|
||||
- **修正**:`;(半角)`
|
||||
- **依据**:全角分号在 C/C++ 中非法,统一替换为半角。
|
||||
|
||||
## [58954458:3] missing-include
|
||||
|
||||
- **原文**:`调用 strcpy/strlen/strcmp 等 C 字符串函数但未 #include <cstring>`
|
||||
- **修正**:`由生成模板统一补 #include <cstring>`
|
||||
- **依据**:C 字符串/内存函数声明在 <cstring>(C++)/ <string.h>(C);原 wiki 代码依赖教学环境传递包含,隔离编译时须显式 include。
|
||||
|
||||
## [58954458:4] missing-include
|
||||
|
||||
- **原文**:`调用 strcpy/strlen/strcmp 等 C 字符串函数但未 #include <cstring>`
|
||||
- **修正**:`由生成模板统一补 #include <cstring>`
|
||||
- **依据**:C 字符串/内存函数声明在 <cstring>(C++)/ <string.h>(C);原 wiki 代码依赖教学环境传递包含,隔离编译时须显式 include。
|
||||
|
||||
## [58954461:0] prose-in-code
|
||||
|
||||
- **原文**:`class IndexPage 前混入孤立中文散文词「网页类」(非注释非代码)`
|
||||
- **修正**:`把该散文行转为注释`
|
||||
- **依据**:wiki 正文标题词被误纳入代码块,C++ 无法解析;转为注释保留教学上下文。
|
||||
|
||||
## [58954461:9] typo
|
||||
|
||||
- **原文**:`“(全角引号)`
|
||||
- **修正**:`"(半角)`
|
||||
- **依据**:字符串/字符字面量须用半角引号。
|
||||
|
||||
## [58954461:9] typo
|
||||
|
||||
- **原文**:`”(全角引号)`
|
||||
- **修正**:`"(半角)`
|
||||
- **依据**:字符串/字符字面量须用半角引号。
|
||||
|
||||
## [58954469:5] abstract-instantiation
|
||||
|
||||
- **原文**:`test() 中 B b; 试图实例化抽象类 B(B 有纯虚析构函数 virtual ~B()=0)`
|
||||
- **修正**:`注释掉 B b; 并加说明(B 是抽象类不可实例化),A a; 保留`
|
||||
- **依据**:含纯虚函数(含纯虚析构函数)的类是抽象类,C++ 禁止创建其对象。原文此处正是演示该约束,但作为可编译示例需把非法构造注释化。
|
||||
|
||||
## [58954472:5] platform
|
||||
|
||||
- **原文**:`system("pause")`
|
||||
- **修正**:`pause()`
|
||||
- **依据**:system("pause") 仅 Windows 可用;改用仓库提供的便携 pause() 壳函数 (读一行 stdin 等待回车),行为一致,Linux 可编译运行。
|
||||
|
||||
## [58954472:9] platform
|
||||
|
||||
- **原文**:`system("pause")`
|
||||
- **修正**:`pause()`
|
||||
- **依据**:system("pause") 仅 Windows 可用;改用仓库提供的便携 pause() 壳函数 (读一行 stdin 等待回车),行为一致,Linux 可编译运行。
|
||||
|
||||
## [58954472:10] platform
|
||||
|
||||
- **原文**:`system("pause")`
|
||||
- **修正**:`pause()`
|
||||
- **依据**:system("pause") 仅 Windows 可用;改用仓库提供的便携 pause() 壳函数 (读一行 stdin 等待回车),行为一致,Linux 可编译运行。
|
||||
|
||||
## [58954472:11] prose-in-code
|
||||
|
||||
- **原文**:`「测试代码:」中文散文词 + 文件作用域裸语句(MyArray<int> myArrayInt(10);、for 循环、Push_back 调用等)直接铺在类定义之后,无函数包裹`
|
||||
- **修正**:`删除散文词,把测试驱动语句包进 main(),保留 MyArray 模板 + Person 类 + 打印函数`
|
||||
- **依据**:C++ 不允许在文件作用域直接写可执行语句(如 for 循环、函数调用);中文散文词亦非法。原文是把「使用示例」当散文铺排;重写为可编译运行的单文件程序,保留类模板应用的教学意图。
|
||||
|
||||
## [58954473:2] syntax
|
||||
|
||||
- **原文**:`//int b = const_cast<int>(a); }(闭合花括号误入注释行)`
|
||||
- **修正**:`把 } 移出注释作为 test01() 的正常闭合花括号`
|
||||
- **依据**:原 wiki 把 test01() 的闭合 } 误写进注释,导致函数体未结束、后续 test02() 被嵌套在 test01() 内,C++ 禁止函数内定义函数。
|
||||
|
||||
## [58954474:1] platform
|
||||
|
||||
- **原文**:`system("pause")`
|
||||
- **修正**:`pause()`
|
||||
- **依据**:system("pause") 仅 Windows 可用;改用仓库提供的便携 pause() 壳函数 (读一行 stdin 等待回车),行为一致,Linux 可编译运行。
|
||||
|
||||
## [58954474:2] platform
|
||||
|
||||
- **原文**:`system("pause")`
|
||||
- **修正**:`pause()`
|
||||
- **依据**:system("pause") 仅 Windows 可用;改用仓库提供的便携 pause() 壳函数 (读一行 stdin 等待回车),行为一致,Linux 可编译运行。
|
||||
|
||||
## [58954474:3] platform
|
||||
|
||||
- **原文**:`system("pause")`
|
||||
- **修正**:`pause()`
|
||||
- **依据**:system("pause") 仅 Windows 可用;改用仓库提供的便携 pause() 壳函数 (读一行 stdin 等待回车),行为一致,Linux 可编译运行。
|
||||
|
||||
## [58954474:4] platform
|
||||
|
||||
- **原文**:`system("pause")`
|
||||
- **修正**:`pause()`
|
||||
- **依据**:system("pause") 仅 Windows 可用;改用仓库提供的便携 pause() 壳函数 (读一行 stdin 等待回车),行为一致,Linux 可编译运行。
|
||||
|
||||
## [58954474:4] removed-feature
|
||||
|
||||
- **原文**:`动态异常规范 throw(int,char,char*) 与 throw()(C++17 已移除)`
|
||||
- **修正**:`throw() → noexcept;throw(类型...) → noexcept(false),并注释说明旧语义`
|
||||
- **依据**:动态异常规范在 C++11 弃用、C++17 移除,C++17 下是语法错误。throw() 的等价物是 noexcept;带类型列表的动态规范无法在现代 C++ 中精确表达,用 noexcept(false) 近似(表示可能抛异常)。旧规范演示见 tools/demo_versions/dynamic_exception_spec.cpp(在 -std=c++14 下编译)。
|
||||
|
||||
## [58954474:7] platform
|
||||
|
||||
- **原文**:`system("pause")`
|
||||
- **修正**:`pause()`
|
||||
- **依据**:system("pause") 仅 Windows 可用;改用仓库提供的便携 pause() 壳函数 (读一行 stdin 等待回车),行为一致,Linux 可编译运行。
|
||||
|
||||
## [58954474:8] override-noexcept
|
||||
|
||||
- **原文**:`MyOutOfRange::what() const 重写 exception::what() 但缺 noexcept`
|
||||
- **修正**:`补 noexcept(virtual const char* what() const noexcept)`
|
||||
- **依据**:C++11 起 std::exception::what() 声明为 noexcept;重写函数的异常规范不得比基类更宽松,必须同样 noexcept,否则 C++17 编译报「looser exception specification」。原 wiki 写于旧标准,未带 noexcept。
|
||||
|
||||
## [58954476:0] missing-include
|
||||
|
||||
- **原文**:`使用 STL/IO 符号(如 vector/for_each/ifstream/setw 等)但未 #include <string>`
|
||||
- **修正**:`由生成模板统一补 #include <string>`
|
||||
- **依据**:原 wiki 代码假定教学环境已传递包含相应标准库头;按「示例相对隔离」独立编译时须显式 include。检测依据为符号使用(见 gen_sources.infer_stl_includes)。
|
||||
|
||||
## [58954476:1] missing-include
|
||||
|
||||
- **原文**:`调用 strcpy/strlen/strcmp 等 C 字符串函数但未 #include <cstring>`
|
||||
- **修正**:`由生成模板统一补 #include <cstring>`
|
||||
- **依据**:C 字符串/内存函数声明在 <cstring>(C++)/ <string.h>(C);原 wiki 代码依赖教学环境传递包含,隔离编译时须显式 include。
|
||||
|
||||
## [58954476:2] missing-include
|
||||
|
||||
- **原文**:`使用 STL/IO 符号(如 vector/for_each/ifstream/setw 等)但未 #include <algorithm>, <iomanip>`
|
||||
- **修正**:`由生成模板统一补 #include <algorithm> <iomanip>`
|
||||
- **依据**:原 wiki 代码假定教学环境已传递包含相应标准库头;按「示例相对隔离」独立编译时须显式 include。检测依据为符号使用(见 gen_sources.infer_stl_includes)。
|
||||
|
||||
## [58954476:3] platform
|
||||
|
||||
- **原文**:`system("pause")`
|
||||
- **修正**:`pause()`
|
||||
- **依据**:system("pause") 仅 Windows 可用;改用仓库提供的便携 pause() 壳函数 (读一行 stdin 等待回车),行为一致,Linux 可编译运行。
|
||||
|
||||
## [58954476:3] missing-include
|
||||
|
||||
- **原文**:`使用 STL/IO 符号(如 vector/for_each/ifstream/setw 等)但未 #include <fstream>, <string>`
|
||||
- **修正**:`由生成模板统一补 #include <fstream> <string>`
|
||||
- **依据**:原 wiki 代码假定教学环境已传递包含相应标准库头;按「示例相对隔离」独立编译时须显式 include。检测依据为符号使用(见 gen_sources.infer_stl_includes)。
|
||||
|
||||
## [58954476:4] platform
|
||||
|
||||
- **原文**:`system("pause")`
|
||||
- **修正**:`pause()`
|
||||
- **依据**:system("pause") 仅 Windows 可用;改用仓库提供的便携 pause() 壳函数 (读一行 stdin 等待回车),行为一致,Linux 可编译运行。
|
||||
|
||||
## [58954476:4] missing-include
|
||||
|
||||
- **原文**:`调用 strcpy/strlen/strcmp 等 C 字符串函数但未 #include <cstring>`
|
||||
- **修正**:`由生成模板统一补 #include <cstring>`
|
||||
- **依据**:C 字符串/内存函数声明在 <cstring>(C++)/ <string.h>(C);原 wiki 代码依赖教学环境传递包含,隔离编译时须显式 include。
|
||||
|
||||
## [58954476:4] missing-include
|
||||
|
||||
- **原文**:`使用 STL/IO 符号(如 vector/for_each/ifstream/setw 等)但未 #include <fstream>`
|
||||
- **修正**:`由生成模板统一补 #include <fstream>`
|
||||
- **依据**:原 wiki 代码假定教学环境已传递包含相应标准库头;按「示例相对隔离」独立编译时须显式 include。检测依据为符号使用(见 gen_sources.infer_stl_includes)。
|
||||
|
||||
## [58954476:4] missing-default-ctor
|
||||
|
||||
- **原文**:`Person 只有 Person(char*,int) 构造,但二进制读取用 Person p3; 默认构造`
|
||||
- **修正**:`补一个空的默认构造 Person(){}`
|
||||
- **依据**:二进制文件读取需先默认构造一个占位对象再 read() 填充;原 Person 无默认构造,C++17 报「no matching function for call to Person::Person()」。
|
||||
|
||||
## [58954487:0] platform
|
||||
|
||||
- **原文**:`system("pause")`
|
||||
- **修正**:`pause()`
|
||||
- **依据**:system("pause") 仅 Windows 可用;改用仓库提供的便携 pause() 壳函数 (读一行 stdin 等待回车),行为一致,Linux 可编译运行。
|
||||
|
||||
## [58954487:0] missing-include
|
||||
|
||||
- **原文**:`使用 STL/IO 符号(如 vector/for_each/ifstream/setw 等)但未 #include <vector>`
|
||||
- **修正**:`由生成模板统一补 #include <vector>`
|
||||
- **依据**:原 wiki 代码假定教学环境已传递包含相应标准库头;按「示例相对隔离」独立编译时须显式 include。检测依据为符号使用(见 gen_sources.infer_stl_includes)。
|
||||
|
||||
## [58954488:1] platform
|
||||
|
||||
- **原文**:`system("pause")`
|
||||
- **修正**:`pause()`
|
||||
- **依据**:system("pause") 仅 Windows 可用;改用仓库提供的便携 pause() 壳函数 (读一行 stdin 等待回车),行为一致,Linux 可编译运行。
|
||||
|
||||
## [58954488:1] missing-include
|
||||
|
||||
- **原文**:`使用 STL/IO 符号(如 vector/for_each/ifstream/setw 等)但未 #include <vector>`
|
||||
- **修正**:`由生成模板统一补 #include <vector>`
|
||||
- **依据**:原 wiki 代码假定教学环境已传递包含相应标准库头;按「示例相对隔离」独立编译时须显式 include。检测依据为符号使用(见 gen_sources.infer_stl_includes)。
|
||||
|
||||
## [58954488:2] platform
|
||||
|
||||
- **原文**:`system("pause")`
|
||||
- **修正**:`pause()`
|
||||
- **依据**:system("pause") 仅 Windows 可用;改用仓库提供的便携 pause() 壳函数 (读一行 stdin 等待回车),行为一致,Linux 可编译运行。
|
||||
|
||||
## [58954488:2] missing-include
|
||||
|
||||
- **原文**:`使用 STL/IO 符号(如 vector/for_each/ifstream/setw 等)但未 #include <algorithm>, <vector>`
|
||||
- **修正**:`由生成模板统一补 #include <algorithm> <vector>`
|
||||
- **依据**:原 wiki 代码假定教学环境已传递包含相应标准库头;按「示例相对隔离」独立编译时须显式 include。检测依据为符号使用(见 gen_sources.infer_stl_includes)。
|
||||
|
||||
## [58954488:3] platform
|
||||
|
||||
- **原文**:`system("pause")`
|
||||
- **修正**:`pause()`
|
||||
- **依据**:system("pause") 仅 Windows 可用;改用仓库提供的便携 pause() 壳函数 (读一行 stdin 等待回车),行为一致,Linux 可编译运行。
|
||||
|
||||
## [58954488:3] missing-include
|
||||
|
||||
- **原文**:`使用 STL/IO 符号(如 vector/for_each/ifstream/setw 等)但未 #include <algorithm>, <vector>`
|
||||
- **修正**:`由生成模板统一补 #include <algorithm> <vector>`
|
||||
- **依据**:原 wiki 代码假定教学环境已传递包含相应标准库头;按「示例相对隔离」独立编译时须显式 include。检测依据为符号使用(见 gen_sources.infer_stl_includes)。
|
||||
|
||||
## [58954488:4] platform
|
||||
|
||||
- **原文**:`system("pause")`
|
||||
- **修正**:`pause()`
|
||||
- **依据**:system("pause") 仅 Windows 可用;改用仓库提供的便携 pause() 壳函数 (读一行 stdin 等待回车),行为一致,Linux 可编译运行。
|
||||
|
||||
## [58954488:4] missing-include
|
||||
|
||||
- **原文**:`使用 STL/IO 符号(如 vector/for_each/ifstream/setw 等)但未 #include <list>`
|
||||
- **修正**:`由生成模板统一补 #include <list>`
|
||||
- **依据**:原 wiki 代码假定教学环境已传递包含相应标准库头;按「示例相对隔离」独立编译时须显式 include。检测依据为符号使用(见 gen_sources.infer_stl_includes)。
|
||||
|
||||
## [58954488:4] implementation-specific
|
||||
|
||||
- **原文**:`直接访问 MSVC STL 私有成员 _Nodeptr/_Myhead/_Next/_Myval/_Mysize(演示 list 节点结构)`
|
||||
- **修正**:`改用标准迭代器遍历,以注释图示说明环形双向链表结构`
|
||||
- **依据**:MSVC STL 的下划线大写成员是实现细节,libstdc++ 无等价物,跨编译器不可移植。C++ 标准不暴露容器内部节点结构;原写法仅在 MSVC 下可编译。改用标准接口 + 图示注释保留教学意图。
|
||||
|
||||
## [58954488:5] missing-include
|
||||
|
||||
- **原文**:`使用 STL/IO 符号(如 vector/for_each/ifstream/setw 等)但未 #include <set>`
|
||||
- **修正**:`由生成模板统一补 #include <set>`
|
||||
- **依据**:原 wiki 代码假定教学环境已传递包含相应标准库头;按「示例相对隔离」独立编译时须显式 include。检测依据为符号使用(见 gen_sources.infer_stl_includes)。
|
||||
|
||||
## [58954488:5] const-comparator
|
||||
|
||||
- **原文**:`set 的排序仿函数 MyCompare02/MyCompare03 的 operator() 非 const`
|
||||
- **修正**:`给两个 operator() 加 const 修饰`
|
||||
- **依据**:C++14 起,关联容器(set/map)的比较对象必须可 const 调用(标准要求 Compare 对象满足 invocable as const)。原 wiki 的非 const operator() 在 C++17 libstdc++ 下触发 static_assert。
|
||||
|
||||
## [58954488:6] platform
|
||||
|
||||
- **原文**:`system("pause")`
|
||||
- **修正**:`pause()`
|
||||
- **依据**:system("pause") 仅 Windows 可用;改用仓库提供的便携 pause() 壳函数 (读一行 stdin 等待回车),行为一致,Linux 可编译运行。
|
||||
|
||||
## [58954488:6] missing-include
|
||||
|
||||
- **原文**:`使用 STL/IO 符号(如 vector/for_each/ifstream/setw 等)但未 #include <algorithm>, <map>, <vector>`
|
||||
- **修正**:`由生成模板统一补 #include <algorithm> <map> <vector>`
|
||||
- **依据**:原 wiki 代码假定教学环境已传递包含相应标准库头;按「示例相对隔离」独立编译时须显式 include。检测依据为符号使用(见 gen_sources.infer_stl_includes)。
|
||||
|
||||
## [58954498:1] missing-include
|
||||
|
||||
- **原文**:`使用 STL/IO 符号(如 vector/for_each/ifstream/setw 等)但未 #include <algorithm>, <vector>`
|
||||
- **修正**:`由生成模板统一补 #include <algorithm> <vector>`
|
||||
- **依据**:原 wiki 代码假定教学环境已传递包含相应标准库头;按「示例相对隔离」独立编译时须显式 include。检测依据为符号使用(见 gen_sources.infer_stl_includes)。
|
||||
|
||||
## [58954498:2] missing-include
|
||||
|
||||
- **原文**:`使用 STL/IO 符号(如 vector/for_each/ifstream/setw 等)但未 #include <algorithm>, <functional>, <vector>`
|
||||
- **修正**:`由生成模板统一补 #include <algorithm> <functional> <vector>`
|
||||
- **依据**:原 wiki 代码假定教学环境已传递包含相应标准库头;按「示例相对隔离」独立编译时须显式 include。检测依据为符号使用(见 gen_sources.infer_stl_includes)。
|
||||
|
||||
## [58954498:3] missing-include
|
||||
|
||||
- **原文**:`使用 STL/IO 符号(如 vector/for_each/ifstream/setw 等)但未 #include <algorithm>, <functional>, <vector>`
|
||||
- **修正**:`由生成模板统一补 #include <algorithm> <functional> <vector>`
|
||||
- **依据**:原 wiki 代码假定教学环境已传递包含相应标准库头;按「示例相对隔离」独立编译时须显式 include。检测依据为符号使用(见 gen_sources.infer_stl_includes)。
|
||||
|
||||
## [58954498:4] missing-include
|
||||
|
||||
- **原文**:`使用 STL/IO 符号(如 vector/for_each/ifstream/setw 等)但未 #include <algorithm>, <vector>`
|
||||
- **修正**:`由生成模板统一补 #include <algorithm> <vector>`
|
||||
- **依据**:原 wiki 代码假定教学环境已传递包含相应标准库头;按「示例相对隔离」独立编译时须显式 include。检测依据为符号使用(见 gen_sources.infer_stl_includes)。
|
||||
|
||||
## [58954498:5] missing-include
|
||||
|
||||
- **原文**:`使用 STL/IO 符号(如 vector/for_each/ifstream/setw 等)但未 #include <algorithm>, <vector>`
|
||||
- **修正**:`由生成模板统一补 #include <algorithm> <vector>`
|
||||
- **依据**:原 wiki 代码假定教学环境已传递包含相应标准库头;按「示例相对隔离」独立编译时须显式 include。检测依据为符号使用(见 gen_sources.infer_stl_includes)。
|
||||
|
||||
@@ -0,0 +1,125 @@
|
||||
# ERRATA — 代码修正记录(Part3 Qt)
|
||||
|
||||
本文件由 `tools/gen_part3.py` 自动生成,记录对 wiki 原始 Qt 代码块的每一处修正。
|
||||
格式:`[pageId:blockIdx]` 类型 → 原内容 → 修正后 → 依据。
|
||||
|
||||
## [58954515:0] missing-symbol
|
||||
|
||||
- **原文**:`原文 #include "widget.h" 引用外部 Widget 类(widget.h/widget.cpp 不在块内)`
|
||||
- **修正**:`在文件内就地补一个最小 Widget : public QWidget(Q_OBJECT)+ main`
|
||||
- **依据**:原 wiki 的「最简单 Qt 程序」依赖外部的 widget.h;按「示例相对隔离」拆分为独立目标后本文件缺少 Widget 定义。补最小 Widget 使其自洽可编译运行。
|
||||
|
||||
## [58954525:0] prose-in-code
|
||||
|
||||
- **原文**:`按钮创建片段行内混入散文「头文件 #include <QPushButton>」,且含中文字符串`
|
||||
- **修正**:`重写为可编译 DemoWidget(剥离散文、保留中文文本)`
|
||||
- **依据**:原 wiki 把讲解散文粘在代码行内(如 #include 当成尾巴),破坏语法;通用 prose 剥离会误伤字符串内的中文,故整体重写保留教学意图。
|
||||
|
||||
## [58954527:0] harness-context
|
||||
|
||||
- **原文**:`片段 connect(quitBtn,&QPushButton::clicked,this,&MyWidget::close) 引用 MyWidget,但 MyWidget 定义不在块内`
|
||||
- **修正**:`补 DemoWidget 子类 + main 外壳,槽用 QWidget::close(系统自带)`
|
||||
- **依据**:原 wiki 片段假定存在 MyWidget 类与 close 槽;按「示例相对隔离」补齐类骨架与 main,演示「系统自带信号(clicked)→系统自带槽(close)」。
|
||||
|
||||
## [58954527:2] prose-in-code
|
||||
|
||||
- **原文**:`自定义信号槽:Teacher/Student/MyWidget 定义与中文散文混排,且信号名 hungury 笔误、槽名 treat/eat 不一致`
|
||||
- **修正**:`重写为可编译对照程序:信号 hungry()/hungry(QString)、槽 treat()/treat(QString),函数指针重载解析 connect`
|
||||
- **依据**:原 wiki 把类定义、emit、connect 与中文讲解散文混在一个代码块,无法编译;信号名 hungury 疑为 hungry 笔误。重写保留「自定义信号+槽+重载」教学意图。
|
||||
|
||||
## [58954529:4] prose-in-code
|
||||
|
||||
- **原文**:`QDockWidget 片段尾部混入散文「设置区域范围」,含中文标题字符串`
|
||||
- **修正**:`重写为可编译 DemoMainWindow(剥离散文、保留中文标题)`
|
||||
- **依据**:原 wiki 把讲解散文粘在代码行尾(setAllowedAreas 后接「设置区域范围」),破坏语法;整体重写保留「铆接部件」教学意图。
|
||||
|
||||
## [58954535:12] merge+rewrite
|
||||
|
||||
- **原文**:`文件对话框示例分散在 12/13/14 三块(含 :/images/file-open 资源、connect、openFile/saveFile 实现)`
|
||||
- **修正**:`合并重写为单一可运行 MainWindow 程序,菜单/工具栏触发文件对话框读写`
|
||||
- **依据**:原文三块是同一 MainWindow 的不同部分(构造、连接、槽实现),独立成文件无法编译;合并为完整目标。原文引用资源图标,本目标用纯文字 Action 避免资源依赖。
|
||||
|
||||
## [58954540:1] typo
|
||||
|
||||
- **原文**:`QLable`
|
||||
- **修正**:`QLabel`
|
||||
- **依据**:笔误:QLabel 误写为 QLable。
|
||||
|
||||
## [58954540:img] merge+typo
|
||||
|
||||
- **原文**:`显示图片示例分散在 3 块(QPixmap pixmap; pixmap.load(:/Image/boat.jpg); label.setPixmap(pixmap) 用了 . 而非 ->)`
|
||||
- **修正**:`合并为一个目标,修正 .→->,资源 :/Image/boat.jpg 由生成占位 png + .qrc 提供`
|
||||
- **依据**:原文 label 是 QLabel* 却用 . 调用 setPixmap(C++ 指针须用 ->);三块拆开不可编译。
|
||||
|
||||
## [58954540:movie] merge+typo
|
||||
|
||||
- **原文**:`显示动画示例分散在 3 块(QMovie(:/Mario.gif)、movie->start()、QLabel 全角分号 ;)`
|
||||
- **修正**:`合并为一个目标,全角分号→半角,资源 :/Mario.gif 由生成占位 gif + .qrc 提供`
|
||||
- **依据**:原文 QLabel 定义末尾用了全角分号 ;(C++ 非法);三块拆开不可编译。
|
||||
|
||||
## [58954540:15] h+cpp-merge
|
||||
|
||||
- **原文**:`自定义控件 SmallWidget 在 wiki 中以 smallwidget.h 内联展示(Q_OBJECT + spin/slider/layout/connect)`
|
||||
- **修正**:`输出为单 .cpp(含类定义+main 实例化),保留 Qt5 static_cast 重载解析写法`
|
||||
- **依据**:原 wiki 把类定义放 .h 注释块;按「每目标单文件」输出,AUTOMOC 处理 Q_OBJECT。
|
||||
|
||||
## [58954546:0] syntax+merge
|
||||
|
||||
- **原文**:`EventLabel 事件重写程序:QString("...(%1, %2)\n...") 内误入字面换行(断行)导致字符串未终结;类声明与实现分散`
|
||||
- **修正**:`合并为单 .cpp,字符串内换行移除(\n 移出字符串或删除),补 setMouseTracking`
|
||||
- **依据**:原 wiki 的 QString 字面量在源码中跨行书写(实际是 \n 后跟换行),C++ 字符串字面量不能直接跨行,导致 missing terminating "。修正为单行字符串。同时补 mouseTracking。
|
||||
|
||||
## [58954546:2] member-def-harness
|
||||
|
||||
- **原文**:`CustomWidget::event(QEvent*) override 片段(处理 KeyPress/Tab)缺少所属类骨架与 main`
|
||||
- **修正**:`补 CustomWidget : public QWidget 骨架(含 event override)+ main 外壳,行为对照原文`
|
||||
- **依据**:原 wiki 只给成员函数定义,缺少类声明与 main;按「示例相对隔离」补齐使其可编译运行。
|
||||
|
||||
## [58954546:6] class+main-harness
|
||||
|
||||
- **原文**:`事件过滤器 MainWindow(eventFilter override + installEventFilter)片段缺 main 与完整结构`
|
||||
- **修正**:`补完整 MainWindow(含 QLabel、eventFilter、installEventFilter)+ main 外壳`
|
||||
- **依据**:原 wiki 给出 MainWindow 类骨架但缺 main;补齐使其可编译运行,演示事件过滤机制。
|
||||
|
||||
## [58954548:0] h+cpp-merge
|
||||
|
||||
- **原文**:`PaintedWidget 类声明(10.1 block0)与其构造+paintEvent 实现(block1)分两块`
|
||||
- **修正**:`合并为单 .cpp(Q_OBJECT 类 + paintEvent),补 main 外壳演示 drawLine/Rect/Ellipse`
|
||||
- **依据**:原文类声明与成员实现分属两块;按「每目标单文件」合并,AUTOMOC 处理 Q_OBJECT。
|
||||
|
||||
## [58954548:2] member-def-harness
|
||||
|
||||
- **原文**:`PaintWidget::paintEvent 绘 pixmap/bitmap(引用 :/Image/butterfly.png、butterfly1.png)`
|
||||
- **修正**:`补 PaintWidget 类骨架 + main,资源由生成占位 png + .qrc 提供`
|
||||
- **依据**:原 wiki 仅给成员函数定义,缺类骨架与 main;资源图片用占位 png 提供以可编译运行。
|
||||
|
||||
## [58954548:3] member-def-harness
|
||||
|
||||
- **原文**:`PaintWidget::paintEvent 绘 QImage(setPixel 循环逐像素设色)片段`
|
||||
- **修正**:`补 PaintWidget 类骨架 + main 外壳`
|
||||
- **依据**:原 wiki 仅给成员函数定义,缺类骨架与 main;补齐使其可编译运行。
|
||||
|
||||
## [58954548:4] platform-path
|
||||
|
||||
- **原文**:`QPicture 保存路径为 "D:\ndrawing.pic"(Windows 路径,且 \n 被解析为换行符)`
|
||||
- **修正**:`改为相对路径 "drawing.pic"(跨平台可移植)`
|
||||
- **依据**:原路径是 Windows 绝对路径,\n 在字符串中被当作换行符导致路径错误;改为相对路径使示例在 Linux 下可编译运行。
|
||||
|
||||
## [58954552:0] blocking-event-loop
|
||||
|
||||
- **原文**:`原文用 QApplication + app.exec()(阻塞 GUI 事件循环),但示例实为控制台文件操作`
|
||||
- **修正**:`改用 QCoreApplication,文件 IO 完成后直接 return 0(不进事件循环)`
|
||||
- **依据**:QApplication::exec() 进入 GUI 事件循环会一直阻塞;该示例不创建窗口,仅做文件读写,用 QCoreApplication 并直接返回即可正确退出,便于自动化运行验证。原行为不变。
|
||||
|
||||
## [58954552:data] merge
|
||||
|
||||
- **原文**:`二进制读写示例分散在 3 块(写/读/读写),各自引用 file.dat 且未检查 open() 返回值`
|
||||
- **修正**:`合并为一个程序:先写 file.dat 再读回,补 open() 检查,用 QCoreApplication(无需 GUI)`
|
||||
- **依据**:原文三块是读写示例的不同片段,独立不可编译;合并为完整程序。补 open() 检查避免未定义行为;数据文件 file.dat 程序自建。
|
||||
|
||||
## [58954552:text] merge
|
||||
|
||||
- **原文**:`文本读写示例分散在 2 块(写/读),各自引用 file.txt`
|
||||
- **修正**:`合并为一个程序:先写 file.txt 再逐行读回,用 QCoreApplication(无需 GUI)`
|
||||
- **依据**:原文两块是读写示例的不同片段,独立不可编译;合并为完整程序。
|
||||
|
||||
@@ -0,0 +1,57 @@
|
||||
# SOURCE_PAGES — wiki 页面与本仓库目录的映射
|
||||
|
||||
本文件记录川大 wiki「02. Qt 方向」每个页面(pageId)与本仓库源码目录的对应关系。
|
||||
所有源码由 `tools/gen_part1.py` / `tools/gen_part3.py` 从抓取的 wiki 代码块生成
|
||||
(原始数据见 `tools/wiki_data/`,生成器只读不改原始数据)。
|
||||
|
||||
目录采用「深缩写」:part 缩写 `pNN`(顶层不编号)/ 章缩写 `chNN` / 节缩写 `sNN`。
|
||||
|
||||
## Part 1 — C/C++ 强化(`p01/`,host gcc/g++ 构建,144 个目标)
|
||||
|
||||
| pageId | 目录 | wiki 标题 | 代码块数 |
|
||||
|---|---|---|---|
|
||||
| 58954438 | `p01/ch02` | 02.C++初识 | 1 |
|
||||
| 58954439 | `p01/ch03` | 03.C++对C的扩展 | 47 |
|
||||
| 58954448 | `p01/ch04/s01` | 01.类和对象的基本概念 | 4 |
|
||||
| 58954449 | `p01/ch04/s02` | 02.面向对象程序设计案例 | 2 |
|
||||
| 58954451 | `p01/ch04/s03` | 03.对象的构造和析构 | 17 |
|
||||
| 58954456 | `p01/ch04/s04` | 04.C++面向对象模型初探 | 4 |
|
||||
| 58954457 | `p01/ch04/s05` | 05.友元 | 1 |
|
||||
| 58954458 | `p01/ch04/s06` | 06.运算符重载 | 6 |
|
||||
| 58954461 | `p01/ch04/s07` | 07.继承和派生 | 13 |
|
||||
| 58954469 | `p01/ch04/s08` | 08.多态 | 7 |
|
||||
| 58954472 | `p01/ch05` | 05.C++模板 | 12 |
|
||||
| 58954473 | `p01/ch06` | 06.C++类型转换 | 3 |
|
||||
| 58954474 | `p01/ch07` | 07.C++异常 | 9 |
|
||||
| 58954476 | `p01/ch08` | 08.C++输入输出流 | 5 |
|
||||
| 58954487 | `p01/ch09/s02` | 02.STL三大组件 | 1 |
|
||||
| 58954488 | `p01/ch09/s03` | 03.常用容器 | 7 |
|
||||
| 58954498 | `p01/ch09/s04` | 04.常用算法 | 6 |
|
||||
|
||||
> 第 4 章「类和对象」分 8 节(s01–s08);第 9 章「STL」分 3 节(s02–s04)。
|
||||
|
||||
## Part 3 — Qt 桌面应用开发(`p03/`,需隔离 Qt 5.14.2,29 个目标)
|
||||
|
||||
| pageId | 目录 | wiki 标题 | 代码块数 |
|
||||
|---|---|---|---|
|
||||
| 58954515 | `p03/ch02` | 2 创建Qt项目 | 1 |
|
||||
| 58954525 | `p03/ch03` | 3 第一个Qt小程序 | 3 |
|
||||
| 58954527 | `p03/ch04` | 4 信号和槽机制 | 7 |
|
||||
| 58954529 | `p03/ch05` | 5 QMainWindow | 7 |
|
||||
| 58954535 | `p03/ch06` | 6 对话框QDialog | 16 |
|
||||
| 58954540 | `p03/ch08` | 8 常用控件 | 16 |
|
||||
| 58954546 | `p03/ch09` | 9 Qt消息机制和事件 | 11 |
|
||||
| 58954548 | `p03/ch10` | 10 绘图和绘图设备 | 5 |
|
||||
| 58954552 | `p03/ch11` | 11 文件系统 | 7 |
|
||||
|
||||
> Part3 中纯签名/伪代码/参考片段(约 40 块)未单独建目标,折进各章 `README.md`
|
||||
> 作文档(见 `gen_part3.py` 的 `BLOCK_TREATMENT` 分类的 `snippet`)。
|
||||
|
||||
## 抓取数据说明
|
||||
|
||||
- `tools/wiki_data/extracted_code.json`:所有页面的代码块(按 pageId → [blocks])。
|
||||
- `tools/wiki_data/bodies/<pageId>.json`:每页正文 HTML(用于标题层级解析)。
|
||||
- `tools/wiki_data/all_page_ids.json`:页面元信息(id、标题)。
|
||||
- `tools/wiki_data/qt_full_tree.json`:wiki 目录树结构。
|
||||
|
||||
> 原始抓取数据保持原貌,**不被生成器修改**(红线,见 `HANDOFF.md` §9)。
|
||||
@@ -0,0 +1,115 @@
|
||||
# VERSION_NOTES — 概念/版本验证记录(任务 1)
|
||||
|
||||
本文件记录 wiki 课程代码中「与语言版本相关」的论断:原文说法 → 当前 C17/C++17
|
||||
是否仍成立 → 不成立则在何版本成立 → 已编译验证的结果。
|
||||
|
||||
验证工具:`tools/std_probe.py`(逐 `-std=` 编译,报告 pass/fail/warning)。
|
||||
对照演示:`tools/demo_versions/`(每个论断一个最小可编译片段)。
|
||||
|
||||
> 基线:本仓库按 **C17 / C++17** 构建所有示例(见顶层 `CMakeLists.txt`)。
|
||||
> 验证编译器:宿主机 `gcc/g++ 13.3.0`(原生支持 C89…C23、C++98…C++23)。
|
||||
|
||||
## 验证方法
|
||||
|
||||
```bash
|
||||
# 单片段跨版本探测(pedantic-errors 让已废除特性硬失败,便于对比)
|
||||
tools/std_probe.py --lang c --file tools/demo_versions/kr_implicit_int.c \
|
||||
--standards c89,c99,c11,c17 --pedantic-errors
|
||||
tools/std_probe.py --lang c++ --file tools/demo_versions/dynamic_exception_spec.cpp \
|
||||
--standards c++11,c++14,c++17,c++20
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 1. K&R 隐式 int(函数/参数省略类型)
|
||||
|
||||
| | C89 | C99 | C11 | C17 |
|
||||
|---|---|---|---|---|
|
||||
| 结果 | ✅ PASS(仅警告) | ❌ FAIL | ❌ FAIL | ❌ FAIL |
|
||||
|
||||
- **原文论断**(块 `58954439:14`「3.4 C++中所有的变量和函数都必须有类型」):
|
||||
C89 允许 `fun1(i){...}`(隐式 int 返回 + 隐式 int 参数)。
|
||||
- **C17 是否成立**:否。C99 起废除隐式 int;C17 下非法(错误)。
|
||||
- **在何版本成立**:C89(及更早)。
|
||||
- **本仓库处理**:Part1 该块用 `exact_fix` 给出 C17 等价的显式类型版本
|
||||
(`int fun1(int i)`);原始 C89 形式保留在 `tools/demo_versions/kr_implicit_int.c`,
|
||||
供跨版本对比。
|
||||
- **已编译验证**:`std_probe` 显示 c89 PASS、c99/c11/c17 FAIL(`--pedantic-errors`)。
|
||||
|
||||
## 2. 三目运算符作为左值
|
||||
|
||||
| | C89 | C99 | C17 | C++11 | C++17 |
|
||||
|---|---|---|---|---|---|
|
||||
| 结果 | ❌ FAIL | ❌ FAIL | ❌ FAIL | ✅ PASS | ✅ PASS |
|
||||
|
||||
- **原文论断**(块 `58954439:18`「3.8 三目运算符功能增强」):
|
||||
C 中三目返回右值;C++ 中三目返回两操作数公共类型的引用(可作左值)。
|
||||
- **C17/C++17 是否成立**:C++ 独有特性,C++17 成立;C(含 C17)不允许。
|
||||
- **本仓库处理**:该特性为 C/C++ 差异演示,保留在
|
||||
`tools/demo_versions/ternary_lvalue.cpp`。
|
||||
- **已编译验证**:C++ 全版本 PASS;C 全版本 FAIL(`lvalue required as left operand`)。
|
||||
|
||||
## 3. `char* p = malloc(n)` 不显式转换
|
||||
|
||||
| | C89 | C17 | C++17 |
|
||||
|---|---|---|---|
|
||||
| 结果 | ✅ PASS | ✅ PASS | ❌ FAIL |
|
||||
|
||||
- **原文论断**(块 `58954439:15`):C 中 `void*` 隐式转任意指针合法;C++ 必须显式转换。
|
||||
- **C17/C++17 是否成立**:C 合法,C++ 非法(`invalid conversion from void* to char*`)。
|
||||
- **本仓库处理**:保留在 `tools/demo_versions/malloc_no_cast.c`。
|
||||
- **已编译验证**:C PASS;C++ FAIL。
|
||||
|
||||
## 4. 枚举变量直接赋整型值
|
||||
|
||||
| | C17 | C++17 |
|
||||
|---|---|---|
|
||||
| 结果 | ✅ PASS | ❌ FAIL |
|
||||
|
||||
- **原文论断**(块 `58954439:15` 类型严格性对照):
|
||||
C 中 `enum Color c = 1;` 合法(int 隐式转 enum);C++ 需显式转换。
|
||||
- **C17/C++17 是否成立**:C 合法,C++ 非法(`invalid conversion from int to Color`)。
|
||||
- **本仓库处理**:保留在 `tools/demo_versions/enum_assign_int.c`。
|
||||
- **已编译验证**:C PASS;C++ FAIL。
|
||||
|
||||
## 5. 经指针改写 const 变量
|
||||
|
||||
| | C89 | C17 | C++17 |
|
||||
|---|---|---|---|
|
||||
| 编译 | ✅ PASS | ✅ PASS | ✅ PASS |
|
||||
|
||||
- **原文论断**(块 `58954439:21`「3.8/C/C++ const 异同」):
|
||||
通过 `(int*)&const_var` 强转改写 const 变量,C 多见改写生效,C++ 常因
|
||||
常量折叠仍读出原值。
|
||||
- **C17/C++17 是否成立**:两者都能编译,但均属**未定义行为(UB)**;
|
||||
「观察到的值」随编译器优化级别而变,不保证。教学价值在于说明 UB 不可依赖。
|
||||
- **本仓库处理**:保留在 `tools/demo_versions/const_via_pointer.c`,注释强调 UB。
|
||||
- **已编译验证**:C/C++ 均编译通过(行为属 UB,不作为「支持/不支持」结论)。
|
||||
|
||||
## 6. 动态异常规范 `throw(类型...)` / `throw()`
|
||||
|
||||
| | C++11 | C++14 | C++17 | C++20 |
|
||||
|---|---|---|---|---|
|
||||
| 结果 | ⚠️ PASS(弃用警告) | ⚠️ PASS(弃用警告) | ❌ FAIL | ❌ FAIL |
|
||||
|
||||
- **原文论断**(块 `58954474:4`「7.2.4 异常接口声明」):
|
||||
演示 `throw(int,char,char*)` 与 `throw()` 异常规范。
|
||||
- **C++17 是否成立**:否。动态异常规范在 C++11 弃用、**C++17 移除**,C++17 下是语法错误。
|
||||
`throw()` 的等价物是 `noexcept`;带类型列表的动态规范在现代 C++ 中无法表达。
|
||||
- **本仓库处理**:Part1 该块用 `exact_fix` 改写为 `noexcept` / `noexcept(false)`
|
||||
并注释说明;原始动态规范形式保留在
|
||||
`tools/demo_versions/dynamic_exception_spec.cpp`(在 `-std=c++14` 下可编译)。
|
||||
- **已编译验证**:C++11/14 PASS(弃用警告),C++17/C++20 FAIL。
|
||||
|
||||
---
|
||||
|
||||
## 附:其它「平台相关」修正(非版本概念,记录于此)
|
||||
|
||||
- **`system("pause")`**(多块):仅 Windows 可用。`common_fix` 统一改为便携
|
||||
`pause()` 壳函数(读一行 stdin 等回车),Linux 可编译运行,行为一致。
|
||||
- **Qt 过时 API**(Part3,Qt5.14 仍可用,保留并标注):
|
||||
- `QMouseEvent::x()/y()`(Qt6 建议用 `position()`);
|
||||
- `QString::sprintf`(Qt6 弃用);
|
||||
- Qt4 `SIGNAL/SLOT` 字符串写法(vs Qt5 函数指针);
|
||||
- `static_cast` 重载解析(`QOverload<>::of` 是 Qt5.7+ 的现代等价)。
|
||||
这些保留原写法以匹配 Qt 5.14 课程环境,相关说明见 `docs/ERRATA_part3.md`。
|
||||
Reference in New Issue
Block a user