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.

[dependencies]
stdlib = "*"

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/<module> → src/<module>.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

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/<name>")
    ├── stdlib.cplus      ← cpc test umbrella
    └── lib/<triple>/     ← 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/<triple>/. Import paths stay stdlib/<module> either way.