array (item itemCount -- array)

Inputs

• item: Item value.
• itemCount: Known repeated-item count.

Outputs

• array: Repeated-item List result, or the empty Tuple when itemCount is zero.

array constructs a repeated-item List from one value and one known Int32 item count.

The builtin uses the dereferenced item, so a value and a Ref to that value produce the same repeated item value.

Behavior

• A negative item count is invalid.
• A zero item count produces the empty Tuple ().
• A positive item count produces a List with that many repeated items of the dereferenced item schema.
• An unknown item count is invalid.
• A known In-place item produces repeated known items.
• An unknown In-place item produces a List of the same schema with unknown repeated contents.
• A Meta item produces a List of the same schema.
• The builtin requires a non-NIL item value.

Example

{} () {} [
  value: 7;

  "-- dereferenced item --" printCompilerMessage
  value 2 array printStack _:;
  @value 2 array printStack _:;

  "-- unknown item --" printCompilerMessage
  0 dynamic 2 array printStack _:;

  "-- meta item --" printCompilerMessage
  () 3 array printStack _:;

  "-- zero count --" printCompilerMessage
  5 0 array printStack _:;
] "main" exportFunction

Expected Output During Compilation

-- dereferenced item --
(7 7)
(7 7)
-- unknown item --
Int32 2 array
-- meta item --
() 3 array
-- zero count --
()

See also

• (...) node — Ends the Tuple scope, constructs the resulting List or Tuple object, and pushes it onto the data stack.
• {...} node — Ends the Dict scope, constructs the resulting Dict, List, or Tuple object, and pushes it onto the data stack.