book.md

The Azoth Programming Language Reference

Note: This is the new version of the reference. Sections are being moved from the old version to the new version. If something is missing, it may be documented in the old version.

1. Introduction
   • Simplifying Decisions
2. Lexical Structure
   • Packages
   • Grammars
   • Lexical Analysis
   • Newlines
   • Whitespace
   • Comments
   • Tokens
   • Identifiers
   • Keywords
   • Reserved Words
   • Literals
   • Operators and Punctuators
3. Basic Concepts
   • Syntactic Analysis
   • Reference Capabilities
   • Declarations
   • Member Access
   • Signatures and Overloading
   • Scopes
   • Execution Order
   • Compiler Diagnostics
4. Types
   • Extrema Types
   • Capability Types
   • Value Types
   • Simple Types
   • Struct Types
   • Tuple Types
   • Reference Types
   • Type Parameters
   • Optional Types
   • Function Types
   • Type Expressions
   • Pointer Types
   • Generic Types
   • Variable References
   • Internal References
5. Conversions
6. Expressions
   • Expression Blocks
   • Choice Expressions
   • Loop Expressions
   • With Expression
   • Capability Expressions
   • Operators
     • Logical Operators
   • Bitwise Operations
   • Boolean Expression
   • Interpolated Strings
   • Pattern Match Expressions
   • Initializer Expressions
   • Generators
   • Lambda Functions
   • Object Expressions
7. Statements
   • Variable Declarations
   • Local Constant Declarations
8. Namespaces and Import Directives
9. Functions
   • Optional Arguments
   • Nested Functions
10. Traits
11. Classes
    • Class Declarations
    • Members
    • Fields
    • Initializers TODO: change to initializers
    • Destructors
    • Methods
    • Associated Functions
    • Properties
    • Operator Overloading
    • Partial Classes
    • Object Declarations
12. Structs
    • Struct Declarations
    • Struct Initializers
    • Ref Structs
    • Value Declarations
13. Closed Types
    • Closed Traits and Classes
    • Closed Structs
    • Cases
    • Closed Type Idioms
14. Extensions
15. Other Declarations
    • Constant Declarations
    • Aliases
16. Type Variables
    • Generics
    • Self Type
    • Associated Types
17. Structured Concurrency
18. Design by Contract
19. Error Handling
    • Aborting
    • Structured Error Handling
    • Out of Memory and Stack Overflow
    • Assertions
20. Effects
21. Attributes
22. Patterns
23. Unit Testing
24. Unsafe Code
    • Pointers
25. External Declarations
26. Documentation Comments
27. Standard Library
    • Localization
    • Global Namespace
    • azoth Namespace
    • azoth.collections Namespace
    • azoth.collections.raw Namespace
    • azoth.io Namespace
    • azoth.math Namespace
    • azoth.memory Namespace
    • azoth.text Namespace
28. Reflection
29. Guaranteed Optimizations
30. Conventions
31. Version Number Scheme
32. Planned Features
    • Global and Package Qualifiers
    • Additional Types
    • Additional Expressions
    • Operator Features
    • Compile-time Function Execution
    • Language-Oriented Programming

Appendices:

• Ideas
• Glossary
• Implementer's Notes
• Influences
• Syntax Reference