Conversions¶
An explicit conversion uses AS, optionally followed by a conversion mode:
VAR wide I64 := 300;
VAR narrowed I8 := wide AS PARTIAL I8;
VAR checked I32 := wide AS CHECKED I32;
VAR assumed I32 := wide AS ASSUME I32;
VAR approximate F32 := 0.4 AS APPROXIMATE F32;
Modes¶
| Form | Contract |
|---|---|
expression AS Type |
Ordinary explicit conversion with no extra permission |
AS EXPLICIT Type |
Selects an explicit user conversion category |
AS PARTIAL Type |
Permits a partial representation result, such as discarded high bits |
AS CHECKED Type |
Requires validity to be checked and faults on failure |
AS ASSUME Type |
Makes validity a program precondition |
AS APPROXIMATE Type |
Permits an inexact numeric result |
AS REINTERPRET Type |
Selects a representation-level conversion explicitly allowed by the type system |
AS UNCHECKED_STATIC_DOWNCAST PointerOrReferenceType |
Recovers an exact complete struct type from an unambiguous base; no runtime check |
AS DYNAMIC PointerType |
Performs a checked polymorphic downcast or cross-cast |
Narrowing¶
Narrowing is not silently accepted. The programmer selects whether truncation, a dynamic check, an assumption, or approximation matches the intended semantics.
Pointer reinterpretation¶
Current pointer reinterpretation supports explicit paths such as conversion
through VOID while preserving pointer category and validity constraints:
VAR pointer CONST->I32 := value<-;
VAR erased CONST->VOID := pointer AS REINTERPRET CONST->VOID;
VAR restored CONST->I32 := erased AS REINTERPRET CONST->I32;
REINTERPRET does not establish an unrelated live type in storage.
Typed Storage and Explicit Lifetime specifies
lifetime transitions.
User-defined conversions¶
Constructor parameter names select the corresponding conversion categories,
including @OTHER, @EXPLICIT, @PARTIAL, @CHECKED, @ASSUME,
@APPROXIMATE, and @REINTERPRET. See
Constructors and destructors.
For user-defined conversions, bare AS tries @EXPLICIT, then @OTHER.
AS CHECKED tries @CHECKED, then @EXPLICIT, then @OTHER. Other named
conversion modes select their corresponding constructor category.
@ARG constructors are excluded from every AS conversion and from implicit
conversion. Direct single-argument construction uses the
ARG construction argument.
AS DYNAMIC is restricted to polymorphic instance pointers and returns null
when no unique target subobject exists. See Inheritance for
qualification, RTTI, and target-support rules.
AS UNCHECKED_STATIC_DOWNCAST is a built-in operation for instance pointers
and references, including nonpolymorphic structs. It cannot be overloaded.
The complete type must exactly match the destination, and repeated nonvirtual
source bases cause a compilation error. See
Unchecked static downcasts for
null handling, qualification, virtual bases, and undefined behavior.