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 of 87 produces “cities_87”.
  • capitals_<v1,0,3> with a value of 1.2 (padding 0, precision 3) produces “capitals_1.200”.
  • cities_<v1,4> with a value of 1 (padding 4, no precision) produces “cities_0001”.
  • big_<s1> with a Number String of “city” produces “big_city”.
  • cities_\«v1» with a value of 87 produces “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 String with Number Value to embed a computed result inside a message printed after a block completes.