# C++ identifier with special meaning: module (since C++20)

> C++ Atlas: `cppatlas.com/w/cpp/identifier_with_special_meaning/module` | Source: https://en.cppreference.com/w/cpp/identifier_with_special_meaning/module | Domain: Language

## Official Specification Summary (cppreference)

### Usage

- `module` declaration: declares that the current translation unit is a *module unit*
- Starts a *global module fragment* of a module unit
- Starts a *private module fragment* of a module unit

### Example

```cpp
module;            // starts a global module fragment

#include <string>

export module foo; // ends a global module fragment
                   // declares the primary module interface unit for named module 'foo'
                   // starts a module unit purview

export std::string f();

module : private;  // ends the portion of the module interface unit that
                   // can affect the behavior of other translation units
                   // starts a private module fragment

std::string f()
{
    return "foo";
}
```

### See also

- [`import`](https://en.cppreference.com/w/cpp/identifier_with_special_meaning/import), [`export`](https://en.cppreference.com/w/cpp/keyword/export)
- [`private`](https://en.cppreference.com/w/cpp/keyword/private)

---
Attribution: content from https://en.cppreference.com/w/cpp/identifier_with_special_meaning/module (cppreference.com), licensed under CC-BY-SA 3.0 and GFDL. Modified: converted to markdown, study notes added. Offline snapshot of 9 February 2025.