Reference

The Reference section is the canonical, stable specification of the Incan Programming Language. It provides precise definitions for grammar, types, semantics, standard library APIs, and runtime behavior.

Use this section when:

• You need exact syntax or signature details
• You want behavior clarified without examples
• You’re verifying compatibility across versions

For step-by-step learning and patterns, see Tutorials and the How-to guides. For practical examples, see the repo’s examples/ directory.

Table of contents

• Language reference (generated): compiler-generated tables (keywords, operators, builtins, etc.)
• Glossary: canonical terminology used across the docs
• Imports and modules: import syntax, module paths, and module resolution rules
• Testing: the testing stdlib module (assertions, markers, fixtures, parametrization)
• Numeric semantics: numeric operators, promotion rules, and edge cases
• Strings: string types, formatting, and string operations
• Derives & traits: how derives and traits fit together
• Derives:
  • String representation: Debug, Display
  • Comparison: Eq, Ord, Hash
  • Copying/default: Clone, Copy, Default
  • Serialization: Serialize, Deserialize
  • Custom behavior: overriding derived behavior