Create String
Description
Create String is a container functor that builds an output string from a format string and a set of connected values or strings, substituting each connected item into the format string at the position of its tag. It is part of the calculator family in the sense that it accepts hook functors (Number Value, Number String) placed inside it, but unlike Calculate Value and the other calculator functors, it does not take a bracketed algebraic expression — format is a plain string containing literal text plus numbered, type-prefixed tags.
Inputs
| Name | Type | Description |
|---|---|---|
| Format | String Type | The format string used to generate the output string, built from literal text plus tags that reference connected hook functors: <vN> for the Nth connected Number Value, <sN> for the Nth connected Number String. A numeric tag can add padding, or padding and precision together, as <vN,padding> or <vN,padding,precision>. See Notes for worked examples. |
Outputs
| Name | Type | Description |
|---|---|---|
| Result | String Type | The string generated by substituting the connected values/strings into the format string. |
Group
Notes
Hooks and tag syntax
Like the calculator functors, Create String takes its data through hook functors placed inside it — Number Value for numbers, Number String for strings — each assigned a number that the format string references by its tag (<v1>, <s1>, and so on). This is the same verbose-form hook mechanism used by expression-based calculators (see Verbose form), except the reference sits inside a literal format string rather than an algebraic expression, and there is no separate abbreviated-syntax form for Create String.
Format examples
cities_<v1>with a Number Value of87produces“cities_87”.capitals_<v1,0,3>with a value of1.2(padding0, precision3) produces“capitals_1.200”.cities_<v1,4>with a value of1(padding4, no precision) produces“cities_0001”.big_<s1>with a Number String of“city”produces“big_city”.cities_\«v1»with a value of87produces“cities_<87>”— prefixing<with a backslash turns it into a literal character instead of starting a tag.
Internal Name
CreateString
Usage examples
- Iterating over Lookup Table values — builds a per-row message from a table's key and value using
<v1>/<v2>tags. - Container functors in the EGO Script documentation — uses
Create StringwithNumber Valueto embed a computed result inside a message printed after a block completes.