manuallyInitVariable (object --)

Inputs

• object: Object or Ref object whose designated object is initialized.

Outputs

• None.

manuallyInitVariable is a designated-storage initialization builtin. It initializes an object in existing storage. Allocation and storage selection are separate operations. For a non-static, non-callable In-place local or field (see selection), NAME or .NAME and @NAME or .@NAME all designate the same storage for manual initialization.

Behavior

• If object is a mutable or immutable Ref, the builtin initializes the object in the referenced storage.
• Otherwise, it initializes the designated local, field, or temporary object itself.
• The builtin does not allocate the underlying storage address.

Example

"String"           use
"memory.mplFree"   use
"memory.mplMalloc" use

Tracer: {
  value: 0;
  INIT: [
    ("init\n") printList
    42 !value
  ];
  DIE: [
    ("die\n") printList
  ];
};

{} 0 {} [
  slot: Tracer storageSize mplMalloc @Tracer addressToReference;
  @slot manuallyInitVariable
  ("-- first -- " slot.value "\n") printList
  slot manuallyDestroyVariable
  @slot manuallyInitVariable
  ("-- second -- " slot.value "\n") printList
  slot manuallyDestroyVariable
  Tracer storageSize slot storageAddress mplFree
  0
] "main" exportFunction

mplFree releases the allocated storage after manuallyDestroyVariable destroys the object; destruction and storage release are separate.

Expected Output

init
-- first -- 42
die
init
-- second -- 42
die

See also

• addressToReference builtin (address modelValue -- reconstructedValue) Typed reconstruction from a numeric storage address. Ref-like model objects keep their schema, and direct non-Ref-like model objects produce Ref results.
• alignment builtin (schema -- alignment) Known Natx alignment requirement of the dereferenced schema.
• manuallyDestroyVariable builtin (object --) Manually destroys the designated object in place without freeing the storage.
• storageAddress builtin (object -- address) Current stack-object storage query; known NIL Ref, Text, and Code objects produce 0nx.
• storageSize builtin (schema -- size) Known Natx storage size of the dereferenced schema.