C 20模块那些事
目录
- C 20模块那些事
- 1.模块单元
- 1.1 Global Module Fragment
- 1.2 purview
- 1.3 Private module fragment
- 2.模块使用
- 2.1 创建模块
- 2.2 导出
- 2.3 导入
- 2.4 模块中的include
- 2.4.2 Global Module Fragment区`#inlcude`
- 3.模块分解
- 3.1 模块分区
- 3.2 子模块
- 4.接口与实现
最近看到大佬们写的C 20库使用了module特性，特意来学习一下，于是有了这篇文章，本篇文章的所有代码都在我的星球里面，需要代码的可以扫文末的二维码。
下面我们来一起体验一下C 20的module!
当我们使用自己编写的头文件或者第三方库时，通常会用到#include 指令来引入库，这是大家经常使用的一种方式。这种方法，实际上是将一个源文件(头文件)的所有代码拷到另一个文件中。
那么，这会面临如下问题：
- 源文件可能在同一目标中被包含多次，因此我们通常会使用
#pragma once或者#ifndef，从而防止源文件在同一翻译单元中被包含多次。 - 代码的拷贝会导致编译时间更长，一旦修改一个头文件，便会导致间接包含这个头文件的一些文件被重新编译。
#include顺序问题，有时候会遇到莫名其妙的编译问题。
C 20引入了一种替代 #include 指令的新方式，称为模块。
下面来深入学习一下模块。
1.模块单元
C 模块由一个或多个翻译单元(tu)组成，其中包含用于模块声明的特定关键字。这样的翻译单元称为模块单元。
非模块单元的翻译单元被认为是全局模块的一部分，全局模块是匿名的，没有接口，并且包含常规的非模块代码。
1.1 Global Module Fragment
模块单元可以以全局模块片段作为前缀，当无法导入头文件时（特别是当头文件使用预处理宏作为配置时），该全局模块片段可以直接使用原来的代码。
例如：下面代码中module;到export module Foo;中间为global module fragment。
module;
#include <iostream>
#ifdef Say
void hello();
#endif
export module Foo;
// purivew
void world();
必须要注意的一点是：**如果该模块有全局模块片段，那么第一个声明必须是module;**，也就是说当把这个声明放在其他位置会出错。
1.2 purview
purview可以理解为模块的整个范围。从模块声明开始，一直延伸到翻译单元的末尾。
例如：hello不在，world、GetData都在purview。
代码语言：javascript复制module;
void hello();
// <- 这里不在Foo模块的purview内
export module Foo;
// <- 在Foo模块的purview内
void world();
export void GetData();
1.3 Private module fragment
主模块接口单元可以用私有模块片段作为后缀，该部分只能出现在主模块接口单元中，如果存在，则它出现的模块单元必须是该模块的唯一单元。其目的是将模块的接口和实现封装在单个翻译单元中，而不暴露实现细节。
例如：我想要创建一个Shape，计算其面积。
对外只需要暴露一个创建具体Shape的接口，调用共同的计算面积接口，于是我们可以写出如下模块。
代码语言：javascript复制export module Shape;
export class Shape {
public:
virtual double CalculateArea() = 0;
};
export { std::shared_ptr<Shape> CreateRectangle(double length, double width); }
module :private; // here
class Rectangle : public Shape {
private:
double length;
double width;
public:
Rectangle(double l, double w) : length(l), width(w) {}
double CalculateArea() override { return length * width; }
};
std::shared_ptr<Shape> CreateRectangle(double length, double width) {
return std::make_shared<Rectangle>(length, width);
}
将内部的细节全部放在private里面吗，我自己的g 版本是13，目前还不支持，会报如下错误：
gcc目前的支持情况，可以戳这里
代码语言：javascript复制https://gcc.gnu.org/projects/cxx-status.html
shape.cppm:14:1: sorry, unimplemented: private module fragment
14 | module :private;
本地的clang是16版本，测试了一下是可以正常运行！
代码语言：javascript复制➜ clang -std=c 20 shape.cppm --precompile -o shape.pcm
➜ clang -std=c 20 shape.cc -fprebuilt-module-path=. shape.pcm -o shape
➜ ./shape
area is 2
上面三个部分，全局和私有模块片段对于模块的存在来说不是必需的，purview是模块必需的部分。
2.模块使用
2.1 创建模块
创建模块类似于我们定义一个头文件，它也有一个文件，一般命名后缀是.cppm。我们只需要在这个文件中使用export与module关键字，后面跟上模块名，这样便创建一个可导出模块。例如：
// foo.cppm
export module foo;
// main.cc
import foo;
export关键字可以用在类、变量等地方，通常有下面两种写法：
export void func();
export {
void func();
constexpr double PI{3.14};
};
一种写法是export关键字放在常见声明前面，另外一种写法是导出块，类似于namespace写法，可以导出多个内容。
2.2 导出
这里就会涉及到一个重要问题，可以导出什么？
- variables, classes, structs, functions, namespaces, template functions/classes, concepts可以被导出
- 内部链接不可导出，如static变量与函数，匿名namespace。
export static constexpr double PI = 3.14; // 不可导出
- 导出声明必须发生在命名空间级别
namespace {
export void print_no_export() { // 匿名命名空间，不可导出
std::cout << "print no export" << std::endl;
}
};
namespace light {
export void print_export() { // ok
std::cout << "print export" << std::endl;
}
};
struct Foo {
export int a; // 不能导出成员变量
};
- 导出命名空间会隐式导出其中的所有内容
export class Rectangle {
private:
double length;
double width;
public:
Rectangle(double l, double w) : length(l), width(w) {}
double CalculateArea() { return length * width; } // 隐式导出
};
export namespace {
void print_export() { // 隐式导出
std::cout << "print export" << std::endl;
}
};
export {
void func(); // 隐式导出
constexpr double PI{3.14}; // 隐式导出
};
- 导出实体的第一个声明必须是导出声明。后续声明和定义不需要有 export 关键字。
export class Foo; // ok
export class Foo; // ok，只是会冗余
class Foo { // ok，隐式export
public:
void print() { std::cout << "this is foo" << std::endl; }
};
class Bar; // not export
export class Bar; // 无效，第一个声明已经是不可导出，后续的不可导出
Foo f; // ok
f.print(); // ok
Bar b; // not ok
- 非导出模块不可导出
module foo;
export void print { } // error: 'export' may only occur after a module interface declaration
2.3 导入
与之对应的便是导入，导入也有一些规则，例如：
- 不可导入自身
- 在模块单元中，所有导入必须出现在该模块单元中的任何声明之前。不能在模块单元中的任意点导入。
void func() {}
import shape; // error: post-module-declaration imports must be contiguous
---------------
import shape; // ok
void func() {}
- 仅允许全局范围导入
namespace light {
import shape; // not ok
};
- 不允许循环导入
// shape.cppm
export module shape;
import circle; // 循环导入
// circle.cppm
import shape;
2.4 模块中的include
#include <iostream>在模块中如何使用呢？
2.4.1 purview区#include
使用import替换#include
export module foo;
import <iostream>;
例如：
g -13编译如下，可以通过c -system-header后面跟iostream来编译出gcm。
g -13 -std=c 20 -fmodules-ts -x c -system-header iostream
g -13 -fmodules-ts -std=c 20 -x c shape.cppm circle.cppm shape.cc
如果是自己的头文件，例如：consts.h，发现可以直接放在模块里面去#include，例如：
export module foo;
#include "consts.h"
2.4.2 Global Module Fragment区#inlcude
对于#include以及宏都可以直接放在这个区使用，例如：
module;
#ifdef
#include <iostream>
#endif
export module foo;
3.模块分解
当我们想将一个大模块分解成更小的模块时，我们可以使用以下两种方法：
- 模块分区。
- 即允许我们将模块分解为多个文件。但是，这对使用者来说实际上是不可见的，使用时正常导入模块即可。
- 子模块。
- 即允许我们将较大的模块分解为任意数量的子模块的层次结构。使用者可以选择导入整个模块，或者只导入特定的子模块。
3.1 模块分区
语法：
代码语言：javascript复制export module <module-name>:<part-name>;
import :<part-name>; // 可以在import前面添加export导出该分区接口
例如：我有一个shape，对外使用的时候只需要import shape，然后调用对应的接口即可，这里分别使用了circle分区与rectangle分区的接口。
import shape;
int main() {
DrawCircle();
DrawRectangle();
return 0;
}
shape是有两个分区，一个是circle，一个是rectangle，于是模块shape.cppm内容为：
代码语言：javascript复制export module shape;
export import :circle;
export import :rectangle;
两个子分区内容为：
代码语言：javascript复制// circle.cppm
module;
#include <iostream>
export module shape:circle;
export void DrawCircle() { std::cout << "draw circle" << std::endl; }
--------------
// rectangle.cppm
module;
#include <iostream>
export module shape:rectangle;
export void DrawRectangle() { std::cout << "draw rectangle" << std::endl; }
当我使用clang与g 编译后发现，clang-16编译报错，不支持。
代码语言：javascript复制 error: sorry, module partitions are not yet supported
g -13支持，需要注意编译的时候按照子分区->主分区的顺序进行编译，不然就会出错。
代码语言：javascript复制➜ g -13 -fmodules-ts -std=c 20 -x c shape.cppm circle.cppm rectangle.cppm shape.cc
shape:circle: error: failed to read compiled module: No such file or directory
shape:circle: note: compiled module file is 'gcm.cache/shape-circle.gcm'
shape:circle: note: imports must be built before being imported
shape:circle: fatal error: returning to the gate for a mechanical issue
应该改为：
代码语言：javascript复制g -fmodules-ts -std=c 20 -x c circle.cppm rectangle.cppm shape.cppm shape.cc
3.2 子模块
语法：
代码语言：javascript复制export module <module-name>.<sub_module-name>;
import <module-name>.<sub_module-name>; // 可以在import前面添加export导出该分区接口
上面的例子也可以用子模块来实现，我们将shape依旧作为主模块，两个子模块分别是circle与rectangle。
代码语言：javascript复制// shape.cppm
export module shape;
export import shape.circle;
export import shape.rectangle;
---------------------
// rectangle.cppm
module;
#include <iostream>
export module shape.rectangle;
export void DrawRectangle() { std::cout << "draw rectangle" << std::endl; }
---------------------
// circle.cppm
module;
#include <iostream>
export module shape.circle;
export void DrawCircle() { std::cout << "draw circle" << std::endl; }
可以看到在使用上模块分区用的是:，而子模块用的是.。
调用侧代码同模块分区。
不过它们在使用的时候有一些区别，例如：当子分区被引入时，使用其接口引发错误：internal compiler error: Segmentation fault: 11，而子模块是可以正常被引入使用。
代码语言：javascript复制// 引入子分区
import shape:circle;
int main() {
DrawCircle(); // error
return 0;
}
// 引入子模块
import shape.circle;
int main() {
DrawCircle(); // ok
return 0;
}
对于子模块来说，在import时，不可以省略主模块名，上面在主分区中引入分区模块，我们可以使用:circle，这里不可以使用.circle。报错如下：
shape.cppm:3:8: error: 'import' does not name a type
3 | export import .circle;
4.接口与实现
通常在写代码时，我们会将代码拆分为"头文件"与"实现文件"，对于模块来说，这一操作不再需要。但是仍旧可以遵循以前的编写风格。
例如：绘制一个shape。
- 定义模块shape.cppm
export module shape;
export class Shape {
public:
Shape();
void Draw();
};
- 实现模块shape.cc
import shape;
import <iostream>;
Shape::Shape() {}
void Shape::Draw() { std::cout << "draw a shape" << std::endl; }
跟平时使用.h与.cpp的分离模式基本类似。
https://clang.llvm.org/docs/StandardCPlusPlusModules.html https://timsong-cpp.github.io/cppwp/n4861/module.import#7.sentence-2 https://gcc.gnu.org/projects/cxx-status.html
