Ownership and lifetime

• The returned command items are non-owning StringView values.
• CommandLine borrows the current process command-line storage.
• toCommandLine2 borrows the zero-terminated strings whose addresses are stored in the supplied contiguous Natx sequence.
• Each stored address is the address of the zero-terminated text itself, not the address of one wrapper object that contains text.
• The addressed strings must therefore remain valid while the returned view is used.

Command view shape

• CommandLine and toCommandLine2 return the same ordered command view shape.
• Each item is a StringView.
• The view supports size queries and iteration in argument order.
• The page does not define one helper that materializes the whole view as owning String values.

toCommandLine2 input model

• argumentAddress is the address of the first stored argument address.
• The stored addresses are read as one contiguous sequence of Natx values.
• Each stored address is interpreted as the first UTF-8 code unit of one zero-terminated string.
• argumentCount is the number of stored argument addresses in that sequence.

Printing layout

• printCommandLine prints one summary line that starts with Commands provided: and ends with the command count.
• Each following line prints one command enclosed in guillemets.
• The input is any command view that provides size and iteration over printable command items.

Functions

• CommandLine (-- commands): returns the current command-line arguments as one ordered command view.
• toCommandLine2 (argumentAddress argumentCount -- commands): builds the same view shape from one contiguous sequence of argument addresses.
• printCommandLine (commands --): prints the command count and then prints each command on a separate line enclosed in guillemets.

Examples

Runtime example: constructed view size

"CommandLine" use
"Array" use
"String" use
"control" use

{} Int32 {} [
  addresses: Natx Array;
  "alpha" storageAddress @addresses.append
  "beta" storageAddress @addresses.append
  commands: @addresses.data 2 toCommandLine2;
  commands.size toString print
  LF print
  0
] "main" exportFunction

Expected Output

2

See also

• String: UTF-8 string views, owned strings, formatting helpers, and text conversion utilities.
• linux/Process · windows/Process: Cross-platform process wrapper with explicit creation, waiting, and termination helpers.