# stdlib The C+ standard library: collections, text, errors, I/O, concurrency, async runtime pieces, and platform shims — including `platform`, which names the OS, architecture and OS version the app is actually on. ```toml [dependencies] stdlib = "*" ``` ```cplus import "stdlib/vec" as vec; import "stdlib/text" as text; import "stdlib/option" as option; import "stdlib/result" as result; ``` Import one module at a time (`stdlib/` → `src/.cplus`). There is no single “import everything” umbrella for app code; `src/stdlib.cplus` is only the `cpc test` entry that pulls modules for unit discovery. ## Docs | File | Role | |---|---| | [docs/tutorial.md](https://github.com/netdur/cplus/blob/v0.0.28/vendor/stdlib/docs/tutorial.md) | Fast path — depend and use the common modules | | [docs/guide.md](https://github.com/netdur/cplus/blob/v0.0.28/vendor/stdlib/docs/guide.md) | Module map, errors, ownership, platforms, gotchas | | [docs/ref.md](https://github.com/netdur/cplus/blob/v0.0.28/vendor/stdlib/docs/ref.md) | Per-module API manual (catalog + signatures) | ## Layout ``` vendor/stdlib/ ├── Cplus.toml ├── README.md ├── docs/ ← package documentation (tutorial / guide / ref) ├── tests/ │ └── lang_e2e.rs ← archived Rust harness (not run by cpc test) └── src/ ├── *.cplus ← modules (import "stdlib/") ├── stdlib.cplus ← cpc test umbrella └── lib// ← optional future prebuilt .a slots ``` ## Tests Unit tests: `#[test]` in `src/*.cplus`, discovered via `src/stdlib.cplus`. ``` cd vendor/stdlib && cpc test ``` `tests/lang_e2e.rs` is an archived Rust integration harness (builds temp C+ packages with `cpc`). It is not run by `cpc test` until re-wired. ## Distribution modes Today the package is **source-only**. Future binary / mixed modes declare archive basenames with `[link].bundled`; the compiler derives the target triple and verifies the files under `lib//`. Import paths stay `stdlib/` either way.