Build Text function

From LabVIEW Wiki
Jump to: navigation, search
Object information
Owning palette(s) String palette
Type Express VI
Requires Basic Development Environment
Icon String Palette - Ex Inst Build Text.png

The Build Text function 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.

Usage

Dialog Box Options
Parameter 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.

History

Version Change(s)
LabVIEW 2018 More info to come.

See Also

External Links