Build Text

Creates an output string from a combination of text and parameterized inputs. If the input is not a string, this Express VI converts the input into a string based on the configuration of the Express VI.


icon

Dialog Box Options

Option Description
Text with Parameters in Percents (%parameter name%)

Specifies the text you want to build. Define parameters by placing text between a pair of percent signs. You can use each parameter only once in the text that you build.

To include a percent sign in the output string, you must type the percent sign twice.

Configure Parameters Contains the following options:
  • Parameter

    Lists all parameters defined in the Text with Parameters in Percents (%parameter name%) section.

  • Sample text

    Displays text configured according to the options set in Parameter Properties.

  • Sample boolean

    Displays a button configured according to the options set in Parameter Properties.

  • Sample number

    Displays a number configured according to the options set in Parameter Properties.

  • Sample result

    Displays the value you enter in Sample text, Sample number, or Sample boolean based on the options you select in the Parameter Properties section.

Parameter Properties Contains the following options:
  • Text

    Formats the parameter as a text string.

  • Number

    Formats the parameter as a numeric value.

  • Boolean

    Formats the parameter as a Boolean value.

  • Format

    Provides formatting options for the parameter depending on the data type. Examples of each format appear in parentheses after the name of the format.

  • Use minimum field width

    Pads any excess space to the left or right of the text, number, or Boolean with zeros or spaces to reach the minimum width you enter in Minimum field width.

  • Minimum field width

    Specifies the width to which you want to pad the text, number, or Boolean. The default is 0.

  • Use specified precision

    Formats the numbers with the precision you specify in Precision. This option is available only when you select Fractional/Scientific (12.345), Fractional (12.345), or Scientific (1.234E1) from the Format the numbers pull-down menu.

  • Precision

    Changes the digits of precision of the numbers in the table. The default is 0.

Justification Contains the following options:
  • Left

    Justifies the parameter to the left.

  • Right

    Justifies the parameter to the right.

Padding Contains the following options:
  • Using spaces

    Pads numbers using spaces.

  • Using zeros

    Pads numbers using zeros.

Inputs/Outputs

  • cstr.png Beginning Text

    Prepends the text you wire to this input to the text the Express VI generates.

  • cerrcodeclst.png error in (no error)

    Describes error conditions that occur before this node runs.

  • ierrcodeclst.png error out

    Contains error information. This output provides standard error out functionality.

  • istr.png Result

    Returns the resulting data based on the configuration of the Express VI.