Skip to main content

Language Guide

This section provides a comprehensive reference for the Zith programming language. It now includes a direct map of the prototype v2.0 language spec topics.

Core Concepts

Spec Core Topics

Review the v2.0 architectural-spec topic map: NRM, ownership keywords, contexts, packs, ECS/scenes, intrinsics, and concurrency.

Syntax Basics

Learn the fundamental syntax of Zith including variables, types, and expressions.

Variables & Ownership

Understand Zith's unique ownership model with unique, view, and mut modifiers.

Type System

Explore Zith's static type system, primitive types, and type inference.

Control Flow

Master conditionals, loops, and pattern matching in Zith.

Functions

Learn about function declaration, parameters, return types, and advanced features.

Memory Management

Deep dive into Zith's memory model, allocation, and safe memory handling.

Error Handling

Handle errors gracefully with Zith's error handling mechanisms.

Modules & Organization

Structure large projects with modules, imports, and visibility controls.

Generics

Write reusable code with Zith's powerful generics system.

Advanced Topics

For more advanced features, see the Raw & Unsafe section:

  • Traits and type classes
  • Spec-aligned ownership and NRM deep dives
  • Advanced generics
  • Metaprogramming
  • Macros
  • Unsafe operations
  • Raw pointers

Quick Reference

TopicDescription
Variableslet x: i32 = 5;
Functionsfn add(a: i32, b: i32): i32 { a + b }
Ownershipunique, view, mut modifiers
Control Flowif, for, while, match
MemoryManual with safety guarantees
ErrorsResult types and exceptions

Ready to learn? Start with Syntax Basics