Programming Language

Nocter

A self-contained systems language built around simplicity, encapsulation, and foolproof design.

/std/README.md

Standard Library

This directory is the sole authority for the portable public modules distributed with Nocter. Every module index.nct owns its compiler-checked public declarations and declaration doc comments. The catalog below assigns each longer observable subject to one behavior guide. A guide may span tightly coupled modules when separating their cross-operation invariants would create duplicate authorities. Declarations answer what can be called; guides explain observable behavior, failure, complexity, and invariants without repeating signatures. The package identity itself is defined by the checked root declaration.

Language constructs and target primitives are referenced from their owning specification chapters rather than redefined here. Generated contract pages show the exact checked index.nct source: only declarations with public language visibility are public API, while visible see edges and restricted declarations remain source-level module assembly and package contracts. Independent package-only modules live under std/internal and are excluded from generated navigation. The guides below cover modules whose observable behavior needs more explanation than declaration comments.

Behavior Guide Authority

Observable subjectSole guideChecked contracts
borrowed UTF-8 textBorrowed Textstd/str
owned UTF-8 textOwned Stringsstd/string
growable sequencesVectorsstd/vec
borrowed sequencesSlicesstd/slice
iteration and collectionIterationstd/iter, std/iter/collect
value formattingFormattingstd/fmt
byte streams and bufferingI/Ostd/io, std/io/buffer
paths and filesystem operationsFilesystemstd/path, std/fs
integer text conversionInteger Textstd/num
allocation and storage failureAllocation and Failurestd/mem
recoverable failure payloadsRecoverable Errorsstd/error
pointers and addressesPointer and Address Conversionstd/ptr
hashing and unordered collectionsAssociative Collectionsstd/hash, std/map, std/set
JSON values, parsing, and generationJSON Values and Textstd/json
durations, monotonic time, wall-clock time, and UTC calendar valuesTimestd/time
synchronous processes and process contextSynchronous Processesstd/process
Unicode scalars and text transformsUnicode Text and Scalarsstd/char, Unicode operations on std/str and std/string
native assertionsNative Assertionsstd/testing