Build Text Express VI

Owning Palette: Output Express VIs

Requires: Base Development System

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.

Dialog Box Options
Block Diagram Inputs
Block Diagram Outputs
 Add to the block diagram  Find on the palette

Dialog Box Options

ParameterDescription
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 ParametersContains 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 PropertiesContains 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.
JustificationContains the following options:
  • Left—Justifies the parameter to the left.
  • Right—Justifies the parameter to the right.
PaddingContains the following options:
  • Using spaces—Pads numbers using spaces.
  • Using zeros—Pads numbers using zeros.

Block Diagram Inputs

ParameterDescription
Beginning TextPrepends the text you wire to this input to the text the Express VI generates.
error inDescribes error conditions that occur before this node runs.

Block Diagram Outputs

ParameterDescription
ResultReturns the resulting data based on the configuration of the Express VI.
error outContains error information. This output provides standard error out functionality.

This Express VI operates similarly to the following VIs and functions:

Concatenate Strings
Format Into String