Daslang Standard Library 0.6

Copyright (c) 2018-2026 Gaijin Entertainment Authors: Anton Yudintsev, Boris Batkin

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

• 1. Introduction
  • 1.1. Core runtime
  • 1.2. Strings
  • 1.3. Regular expressions
  • 1.4. Reflection and AST
  • 1.5. Functional and algorithms
  • 1.6. Data structures
  • 1.7. Serialization and data
  • 1.8. Jobs and concurrency
  • 1.9. Macros and metaprogramming
  • 1.10. Control flow macros
  • 1.11. Pattern matching
  • 1.12. Entity component system
  • 1.13. OOP and interfaces
  • 1.14. Testing and debugging
  • 1.15. Code quality and tooling
  • 1.16. Developer tools
• 2. Core
  • 2.1. Built-in runtime
    • 2.1.1. Type aliases
    • 2.1.2. Constants
    • 2.1.3. Handled structures
    • 2.1.4. Function annotations
    • 2.1.5. Call macros
    • 2.1.6. Reader macros
    • 2.1.7. Typeinfo macros
    • 2.1.8. Handled types
    • 2.1.9. Structure macros
    • 2.1.10. Containers
    • 2.1.11. das::string manipulation
    • 2.1.12. Heap reporting
    • 2.1.13. GC0 infrastructure
    • 2.1.14. Smart ptr infrastructure
    • 2.1.15. Macro infrastructure
    • 2.1.16. Profiler
    • 2.1.17. System infrastructure
    • 2.1.18. Memory manipulation
    • 2.1.19. Binary serializer
    • 2.1.20. Path and command line
    • 2.1.21. Time and date
    • 2.1.22. Platform queries
    • 2.1.23. String formatting
    • 2.1.24. Argument consumption
    • 2.1.25. Lock checking
    • 2.1.26. Lock checking internals
    • 2.1.27. Bit operations
    • 2.1.28. Intervals
    • 2.1.29. RTTI
    • 2.1.30. Lock verification
    • 2.1.31. Initialization and finalization
    • 2.1.32. Algorithms
    • 2.1.33. Memset
    • 2.1.34. Malloc
    • 2.1.35. Compilation and AOT
  • 2.2. Math library
    • 2.2.1. Constants
    • 2.2.2. Handled structures
    • 2.2.3. all numerics (uint*, int*, float*, double)
    • 2.2.4. float* and double
    • 2.2.5. float* only
    • 2.2.6. float3 only
    • 2.2.7. float2, float3, float4
    • 2.2.8. Noise functions
    • 2.2.9. lerp/mad/clamp
    • 2.2.10. Matrix element access
    • 2.2.11. Matrix operations
    • 2.2.12. Matrix initializers
    • 2.2.13. Matrix manipulation
    • 2.2.14. Quaternion operations
    • 2.2.15. Packing and unpacking
  • 2.3. Math bit helpers
    • 2.3.1. float in int,uint
    • 2.3.2. int,uint in float
    • 2.3.3. int64,uint64 in double
    • 2.3.4. bit-cast vec4f
  • 2.4. Boost package for math
    • 2.4.1. Structures
    • 2.4.2. Angle conversions
    • 2.4.3. Intersections
    • 2.4.4. Matrices
    • 2.4.5. Plane
    • 2.4.6. Color conversions
    • 2.4.7. Color packing and unpacking
  • 2.5. Random generator library
    • 2.5.1. Constants
    • 2.5.2. Seed and basic generators
    • 2.5.3. Random iterators
    • 2.5.4. Specific distributions
• 3. Strings
  • 3.1. String manipulation library
    • 3.1.1. Enumerations
    • 3.1.2. Handled structures
    • 3.1.3. Character set
    • 3.1.4. Character groups
    • 3.1.5. Character by index
    • 3.1.6. String properties
    • 3.1.7. String builder
    • 3.1.8. das::string manipulation
    • 3.1.9. String modifications
    • 3.1.10. Search substrings
    • 3.1.11. String comparison
    • 3.1.12. String conversion routines
    • 3.1.13. String as array
    • 3.1.14. Low level memory allocation
  • 3.2. Boost package for string manipulation library
    • 3.2.1. Split and join
    • 3.2.2. Formatting
    • 3.2.3. Queries and comparisons
    • 3.2.4. Search
    • 3.2.5. Replace
    • 3.2.6. Prefix and suffix
    • 3.2.7. Levenshtein distance
  • 3.3. Temporary string utilities
    • 3.3.1. Function annotations
    • 3.3.2. Temporary string builders
    • 3.3.3. Temporary string conversion
  • 3.4. UTF-8 utilities
    • 3.4.1. Constants
    • 3.4.2. Encoding and decoding
    • 3.4.3. Length and measurement
    • 3.4.4. Validation
  • 3.5. Base64 encoding and decoding
    • 3.5.1. Encoding
    • 3.5.2. Decoding
  • 3.6. Long string embedding macro
    • 3.6.1. Reader macros
• 4. I/O and Serialization
  • 4.1. File input output library
    • 4.1.1. Type aliases
    • 4.1.2. Constants
    • 4.1.3. Structures
    • 4.1.4. Handled structures
    • 4.1.5. Handled types
    • 4.1.6. File manipulation
    • 4.1.7. Path manipulation
    • 4.1.8. Directory manipulation
    • 4.1.9. OS specific routines
    • 4.1.10. Dynamic modules
  • 4.2. Network socket library
    • 4.2.1. Handled structures
    • 4.2.2. Classes
    • 4.2.3. Low level NetworkServer IO
  • 4.3. URI manipulation library based on UriParser
    • 4.3.1. Handled structures
    • 4.3.2. Initialization and finalization
    • 4.3.3. Escape and unescape
    • 4.3.4. Uri manipulations
    • 4.3.5. File name conversions
    • 4.3.6. GUID
  • 4.4. Boost package for the URI parser
    • 4.4.1. Split and compose
    • 4.4.2. Component accessors
  • 4.5. General purpose serialization
    • 4.5.1. Structures
    • 4.5.2. Classes
    • 4.5.3. Serialization
    • 4.5.4. Memory archive
• 5. Data Structures
  • 5.1. Boost package for array manipulation
    • 5.1.1. Temporary arrays
    • 5.1.2. Empty check
    • 5.1.3. Sub-array view
  • 5.2. Boost package for the builtin sort
    • 5.2.1. Call macros
  • 5.3. Flat hash table
    • 5.3.1. Type macros
  • 5.4. Cuckoo hash table
    • 5.4.1. Type macros
    • 5.4.2. Hash functions
  • 5.5. Intrusive linked list
    • 5.5.1. Constants
  • 5.6. SOA (Structure of Arrays) transformation
    • 5.6.1. Structures
    • 5.6.2. Function annotations
    • 5.6.3. Structure macros
    • 5.6.4. SOA field access
  • 5.7. Packed boolean array
    • 5.7.1. Structures
    • 5.7.2. Iteration
• 6. Algorithms and Functional
  • 6.1. Miscellaneous algorithms
    • 6.1.1. Search
    • 6.1.2. Array manipulation
    • 6.1.3. Table manipulation
  • 6.2. Functional programming library
    • 6.2.1. Transformations
    • 6.2.2. Aggregation
    • 6.2.3. Search and split
    • 6.2.4. Iteration
    • 6.2.5. Generators
    • 6.2.6. Predicates
  • 6.3. LINQ
    • 6.3.1. Sorting data
    • 6.3.2. Set operations
    • 6.3.3. Concatenation operations
    • 6.3.4. Generation operations
    • 6.3.5. Aggregation operations
    • 6.3.6. Filtering data
    • 6.3.7. Partitioning data
    • 6.3.8. Join and group operations
    • 6.3.9. Querying data
    • 6.3.10. Element operations
    • 6.3.11. Transform operations
    • 6.3.12. Conversion operations
    • 6.3.13. Comparators and keys
  • 6.4. Boost module for LINQ
    • 6.4.1. Call macros
  • 6.5. Pattern matching
    • 6.5.1. Call macros
    • 6.5.2. Structure macros
• 7. Data Formats
  • 7.1. JSON manipulation library
    • 7.1.1. Type aliases
    • 7.1.2. Structures
    • 7.1.3. Value conversion
    • 7.1.4. Read and write
    • 7.1.5. JSON properties
    • 7.1.6. Broken JSON
  • 7.2. Boost package for JSON
    • 7.2.1. Field annotations
  • 7.3. Regular expression library
    • 7.3.1. Type aliases
    • 7.3.2. Enumerations
    • 7.3.3. Structures
    • 7.3.4. Compilation and validation
    • 7.3.5. Access
    • 7.3.6. Match & replace
    • 7.3.7. Generation
  • 7.4. Boost package for REGEX
    • 7.4.1. Reader macros
  • 7.5. Documentation generator
    • 7.5.1. Structures
    • 7.5.2. Document writers
    • 7.5.3. Descriptions
    • 7.5.4. Label makers
    • 7.5.5. RST section makers
    • 7.5.6. Group operations
    • 7.5.7. Naming helpers
• 8. Entity Component System
  • 8.1. DECS, Daslang entity component system
    • 8.1.1. Type aliases
    • 8.1.2. Constants
    • 8.1.3. Structures
    • 8.1.4. Comparison and access
    • 8.1.5. Access (get/set/clone)
    • 8.1.6. Entity status
    • 8.1.7. Debug and serialization
    • 8.1.8. Stages
    • 8.1.9. Deferred actions
    • 8.1.10. GC and reset
    • 8.1.11. Iteration
    • 8.1.12. Request
  • 8.2. Boost package for DECS
    • 8.2.1. Function annotations
    • 8.2.2. Call macros
    • 8.2.3. Structure macros
  • 8.3. DECS debug state reporting
• 9. Concurrency
  • 9.1. Jobs and threads
    • 9.1.1. Handled structures
    • 9.1.2. Channel, JobStatus, Lockbox
    • 9.1.3. Queries
    • 9.1.4. Internal invocations
    • 9.1.5. Construction
    • 9.1.6. Atomic
  • 9.2. Boost package for jobs and threads
    • 9.2.1. Function annotations
    • 9.2.2. Invocations
    • 9.2.3. Iteration
    • 9.2.4. Passing data
    • 9.2.5. Receiving data
    • 9.2.6. Synchronization
    • 9.2.7. Parallel execution
    • 9.2.8. LockBox operations
    • 9.2.9. Internal capture details
  • 9.3. Cross-context evaluation helpers
    • 9.3.1. Function annotations
  • 9.4. Coroutines and additional generator support
    • 9.4.1. Type aliases
    • 9.4.2. Function annotations
    • 9.4.3. Call macros
    • 9.4.4. Top level coroutine evaluation
  • 9.5. Async/await coroutine macros
    • 9.5.1. Function annotations
    • 9.5.2. Awaiting
    • 9.5.3. Running async tasks
    • 9.5.4. Uncategorized
• 10. AST and Macros
  • 10.1. Runtime type information library
    • 10.1.1. Type aliases
    • 10.1.2. Constants
    • 10.1.3. Enumerations
    • 10.1.4. Handled structures
    • 10.1.5. Typeinfo macros
    • 10.1.6. Handled types
    • 10.1.7. Initialization and finalization
    • 10.1.8. Type access
    • 10.1.9. Rtti context access
    • 10.1.10. Program access
    • 10.1.11. Module access
    • 10.1.12. Annotation access
    • 10.1.13. Compilation and simulation
    • 10.1.14. File access
    • 10.1.15. Structure access
    • 10.1.16. Data walking and printing
    • 10.1.17. Function and mangled name hash
    • 10.1.18. Context and mutex locking
    • 10.1.19. Runtime data access
    • 10.1.20. Tuple and variant access
    • 10.1.21. Iteration
  • 10.2. AST manipulation library
    • 10.2.1. Type aliases
    • 10.2.2. Enumerations
    • 10.2.3. Handled structures
    • 10.2.4. Call macros
    • 10.2.5. Typeinfo macros
    • 10.2.6. Handled types
    • 10.2.7. Classes
    • 10.2.8. Call generation
    • 10.2.9. Visitor pattern
    • 10.2.10. Expression generation
    • 10.2.11. Adapter generation
    • 10.2.12. Adapter application
    • 10.2.13. Adding objects to objects
    • 10.2.14. Program and module access
    • 10.2.15. Textual descriptions of the objects
    • 10.2.16. Searching
    • 10.2.17. Iterating
    • 10.2.18. Cloning
    • 10.2.19. Mangled name
    • 10.2.20. Size and offset
    • 10.2.21. Evaluations
    • 10.2.22. Error reporting
    • 10.2.23. Location and context
    • 10.2.24. Use queries
    • 10.2.25. Log
    • 10.2.26. Removal
    • 10.2.27. Properties
    • 10.2.28. Infer
    • 10.2.29. Module queries
    • 10.2.30. Debug info helpers
    • 10.2.31. AOT support
    • 10.2.32. String builder writer
  • 10.3. Boost package for the AST
    • 10.3.1. Type aliases
    • 10.3.2. Function annotations
    • 10.3.3. Variant macros
    • 10.3.4. Structure macros
    • 10.3.5. Classes
    • 10.3.6. Containers
    • 10.3.7. Textual descriptions of the objects
    • 10.3.8. Queries
    • 10.3.9. Annotations
    • 10.3.10. Expression generation
    • 10.3.11. Visitors
    • 10.3.12. Type generation
    • 10.3.13. Type casts
    • 10.3.14. Setup
  • 10.4. decltype macro and template function annotation
    • 10.4.1. Function annotations
    • 10.4.2. Call macros
  • 10.5. Template application helpers
    • 10.5.1. Structures
    • 10.5.2. Call macros
    • 10.5.3. Template rules
    • 10.5.4. Template application
    • 10.5.5. Expression helpers
    • 10.5.6. Expression generation
    • 10.5.7. Block helpers
    • 10.5.8. Global variable helpers
    • 10.5.9. Hygienic names
    • 10.5.10. Quoting macros
    • 10.5.11. Type pointer helpers
    • 10.5.12. Structure helpers
    • 10.5.13. Class generation
  • 10.6. AST quasiquoting infrastructure
    • 10.6.1. Structures
    • 10.6.2. Clone operations
    • 10.6.3. Conversion
  • 10.7. Boost package for macro manipulations
    • 10.7.1. Structures
    • 10.7.2. Function annotations
    • 10.7.3. Call macros
    • 10.7.4. Implementation details
    • 10.7.5. Block analysis
  • 10.8. Type macro and template structure support
    • 10.8.1. Structures
    • 10.8.2. Function annotations
    • 10.8.3. Structure macros
    • 10.8.4. Enum helpers
    • 10.8.5. Template structure instantiation
    • 10.8.6. Type inference helpers
    • 10.8.7. String constant access
    • 10.8.8. Work tracking
    • 10.8.9. Type macro arguments
  • 10.9. DECS, AST block to loop
    • 10.9.1. Block to loop conversion
  • 10.10. AST type usage collection
    • 10.10.1. Structures
    • 10.10.2. Collecting type information
  • 10.11. Constant expression checker and substitution
    • 10.11.1. Function annotations
    • 10.11.2. Macro helpers
• 11. Annotations and Contracts
  • 11.1. Miscellaneous contract annotations
    • 11.1.1. Function annotations
    • 11.1.2. Type queries
  • 11.2. Apply reflection pattern
    • 11.2.1. Call macros
  • 11.3. defer and defer_delete macros
    • 11.3.1. Function annotations
    • 11.3.2. Call macros
    • 11.3.3. Defer
    • 11.3.4. Stub
  • 11.4. if_not_null macro
    • 11.4.1. Call macros
  • 11.5. is_local_xxx ast helpers
    • 11.5.1. Scope checks
  • 11.6. safe_addr macro
    • 11.6.1. Function annotations
    • 11.6.2. Safe temporary address
    • 11.6.3. Temporary pointers
    • 11.6.4. Temporary values
  • 11.7. static_let macro
    • 11.7.1. Function annotations
    • 11.7.2. Static variable declarations
  • 11.8. lpipe macro
    • 11.8.1. Call macros
  • 11.9. Assert once
    • 11.9.1. Function annotations
    • 11.9.2. Assertion
  • 11.10. Loop unrolling
    • 11.10.1. Function annotations
    • 11.10.2. Unrolling
  • 11.11. Bitfield operator overloads
    • 11.11.1. Bitfield element access
    • 11.11.2. Iteration
  • 11.12. Bitfield name traits
    • 11.12.1. Function annotations
    • 11.12.2. Iteration
  • 11.13. Enumeration traits
    • 11.13.1. Typeinfo macros
    • 11.13.2. Handled enumerations
    • 11.13.3. Enumeration iteration
    • 11.13.4. Enumeration conversion
  • 11.14. Type trait macros
    • 11.14.1. Call macros
    • 11.14.2. Typeinfo macros
  • 11.15. C++ bindings generator
    • 11.15.1. Generation of bindings
• 12. Classes and Interfaces
  • 12.1. Class method macros
    • 12.1.1. Function annotations
  • 12.2. instance_function function annotation
    • 12.2.1. Function annotations
  • 12.3. Interfaces
    • 12.3.1. Variant macros
    • 12.3.2. Structure macros
  • 12.4. Dynamic RTTI type casts
    • 12.4.1. Variant macros
    • 12.4.2. Dynamic casts
  • 12.5. Generic return type instantiation
    • 12.5.1. Call macros
• 13. Testing and Debugging
  • 13.1. Debug agent API
    • 13.1.1. Structures
    • 13.1.2. Handled structures
    • 13.1.3. Classes
    • 13.1.4. Agent lifecycle
    • 13.1.5. Cross-context invocation
    • 13.1.6. Agent construction
    • 13.1.7. Agent tick and state collection
    • 13.1.8. Instrumentation
    • 13.1.9. Data and stack walking
    • 13.1.10. Context inspection
    • 13.1.11. Breakpoints
    • 13.1.12. Memory
  • 13.2. Code coverage profiling
  • 13.3. Instrumenting profiler
    • 13.3.1. Profiler control
  • 13.4. Profiler cross-context helpers
    • 13.4.1. Context profiler control
  • 13.5. Debug expression evaluator
    • 13.5.1. Structures
    • 13.5.2. Evaluation
  • 13.6. Faker
    • 13.6.1. Structures
    • 13.6.2. Constructor
    • 13.6.3. Random values
    • 13.6.4. Random strings
    • 13.6.5. Date and time
  • 13.7. Fuzzer
    • 13.7.1. Fuzzer tests
  • 13.8. Debug Adapter Protocol data structures
    • 13.8.1. Structures
    • 13.8.2. JSON deserialization
    • 13.8.3. JSON serialization
    • 13.8.4. JSON field accessors
  • 13.9. Heartbeat callback injection
• 14. Code Quality and Refactoring
  • 14.1. Paranoid lint pass
    • 14.1.1. Lint operations
  • 14.2. Global lint pass (paranoid checks)
  • 14.3. Code validation annotations
    • 14.3.1. Function annotations
  • 14.4. Automated refactoring tools
    • 14.4.1. Function annotations
    • 14.4.2. Call macros
    • 14.4.3. Refactoring operations
  • 14.5. Consume argument optimization
    • 14.5.1. Function annotations
  • 14.6. Call argument removal annotation
    • 14.6.1. Function annotations
  • 14.7. Source code formatter
    • 14.7.1. Formatting
  • 14.8. File-based source code formatter
    • 14.8.1. File formatting