Runtime v2.81 · Updated Sep 30, 2026

str

Convert value to string using DSL display format.

Syntax

str(value, /)

Parameters

NameDescription
valueAny
Value to convert
Required · Positional only
No default

Returns

String — Text form of the value.

Behavior / side effects

Convert value to string using DSL display format. Point/Region stay compact, two-dimensional lists render as one row list per line, and only rows that are too long or complex expand into vertical multi-line text. Large or deeply nested structured values use a bounded preview with explicit omitted/budget markers; a direct string value remains unchanged.

Execution

  • Blocking: No
  • Thread safety: Use separate objects per flow
  • Parallel execution: Yes

Value operations execute in the calling flow without an intentional wait for capture, gesture completion, or user input. Create mutable containers/builders separately in each flow; this is isolation, not a shared-object synchronization guarantee.

Example

total = 12
text("Total: " + str(total))

Errors / limitations

No additional limitations documented; follow the parameter and behavior contract above.

Related APIs

None