Compose String

Compose output string signal based on specified format and input signals

Library:
Simulink / String

Description

TheCompose Stringblock composes output string signal based on the format specifier listed in theFormatparameter. TheFormatparameter determines the number of input signals. If there are multiple inputs, the block constructs the string by combining these multiple inputs in order, and applying the associated format specifier, one format specifier for each input. Each format specifier starts with a percent sign,%, followed by the conversion character. For example,%fformats the input as a floating point output. To supplement the string output, you can also add a character to the format specification. Use this block to compose and format an output string signal from a multiple inputs.

For example, if theFormatparameter contains"%s is %f", the block expects two inputs, a string signal and a single or double signal. If the first input is the string"Pi"and the second input is a double value3.14, the output is"Pi is 3.14".

When a MinGW^®compiler compiles code generated from the block, running the compiled code may produce nonstandard results for floating-point inputs. For example, a numeric input of501.987returns the string"5.019870e+002"instead of the expected string"5.019870e+02".

Ports

Input

expand all

`d`— Data for first part of string
标量

Data for the first part of string, specified as a scalar. TheFormatparameter determines the port label and the format of the input data. For example, if the first item in theFormatparameter is%d, the port label is d.

The data type of the input signal must be compatible with the format specifier in theFormatparameter. For more information, see theFormatparameter.

`f`— Data for second part of string
标量

Data for the second part of string, specified as a scalar. TheFormatparameter determines the port label and the format of the input data. For example, if the first item in theFormatparameter is%f, the port label is f.

The data type of the input signal must be compatible with the format specifier specified in theFormatparameter. For more information, see theFormatparameter.

`Port_N`— Data for N parts of string
标量(default)

Data forNparts of string, specified as a scalar. TheFormatparameter determines the port label and the format of the input data. For example, if the corresponding item in theFormatparameter is%f, the port label is f.

The data type of the input signal must be compatible with the format specifier in theFormatparameter. For more information, see theFormatparameter.

Output

expand all

`str`— Output string
标量

Output string composed of inputs, specified as a scalar.

Data Types:string

Parameters

expand all

`Format`— Format input data
"%d %f" (default) | scalar

的格式输入数据,指定为一个标量。

For more information about acceptable format specifiers, see the Algorithms section.

`Output data type`— Output data type
`string`(default) || scalar

Output data type, specified using the string data type to specify a string with no maximum length.

To specify a string data type with a maximum length, specifystringtype(N). For example,stringtype (31)creates a string data type with a maximum length of 31 characters.

Click theShow data type assistantbuttonto display theData Type Assistant, which helps you set the data type attributes. SeeSpecify Data Types Using Data Type Assistantfor more information.

Block Characteristics

Data Types	`double`\|`integer`\|`single`\|`string`
Direct Feedthrough	`yes`
Multidimensional Signals	`no`
Variable-Size Signals	`no`
Zero-Crossing Detection	`no`

Algorithms

expand all

A formatting specifier starts with a percent sign,%, and ends with a conversion character. The conversion character is required. Optionally, you can specify identifier, flags, field width, precision, and subtype specifiers between%and the conversion character. (Spaces are invalid between specifiers and are shown here only for readability).

TheCompose Stringblock uses this format specifier prototype:

%[flags][width][.precision][length]specifier

Conversion Character

This table shows conversion characters to format numeric and character data as text.

Value Type	Conversion	Details
Integer, signed	`%d`or`%i`	Base 10
Integer, unsigned	`%u`	Base 10
	`%o`	Base 8 (octal)
	`%x`	Base 16 (hexadecimal), lowercase letters`a`–`f`
	`%X`	Same as`%x`, uppercase letters`A`–`F`
Floating-point number	`%f`	Floating-point notation (Use a precision operator to specify the number of digits after the decimal point.)
	`%e`	Exponential notation, such as`3.141593e+00`(Use a precision operator to specify the number of digits after the decimal point.)
	`%E`	Same as`%e`, but uppercase, such as`3.141593E+00`(Use a precision operator to specify the number of digits after the decimal point.)
	`%g`	The more compact of`%e`or`%f`, with no trailing zeros (Use a precision operator to specify the number of significant digits.)
	`%G`	The more compact of`%E`or`%f`, with no trailing zeros (Use a precision operator to specify the number of significant digits.)
String	`%s`	The type of the output text is the same as the type ofFormat.

Optional Operators

The optional identifier, flags, field width, precision, and operators further define the format of the output text.

Flags

`'–'`	Left-justify. Works with all specifiers. Example:`%-5.2f` Example:`%-10s`
`'+'`	Always print a sign character (+ or –) for any numeric value. Works with all specifiers except`u`,`o`,`x`,`X`, and`s`. Example:`%+5.2f` Right-justify text. Example:`%+10s`
`' '`	Insert a space before the value. Works with all specifiers except`u`,`o`,`x`,`X`, and`s`. Example:`% 5.2f`
`'0'`	Pad to field width with zeros before the value. Works with all specifiers except`s`. Example:`%05.2f`
`'#'`	Modify selected numeric conversions: For`%o`,`%x`, or`%X`, print`0`,`0x`, or`0X`prefix. For`%f`,`%e`, or`%E`, print decimal point even when precision is 0. For`%g`or`%G`,不要删除尾随zeros or decimal point. Works with all specifiers except`d`,`i`,`u`, and`s`. Example:`%#5.0f`

Field Width
Minimum number of characters to print.
The function pads to field width with spaces before the value unless otherwise specified by flags.

Precision

For`%f`,`%e`, or`%E`	Number of digits to the right of the decimal point Example:`'%.4f'`prints`pi`as`'3.1416'`
d, i, o, u, x, X	Minimum number of digits to be written. Outputs shorter than the specified precision are padded with leading zeros. Example:`"%.4d"`prints 5 as`'0005'`
For`%g`or`%G`	Number of significant digits Example:`'%.4g'`prints`pi`as`'3.142'`
s	Maximum number of characters to be written to the output. Example:`"%.2s"`prints`"Hello!"`as`"He"`

Note

If you specify a precision operator for floating-point values that exceeds the precision of the input numeric data type, the results might not match the input values to the precision you specified. The result depends on your computer hardware and operating system.

Text Before or After Formatting Operators

Special Character	Representation
Single quotation mark	`''`
Percent character	`%%`
Backslash	`\\`
Alarm	`\a`
Backspace	`\b`
Form feed	`\f`
New line	`\n`
Carriage return	`\r`
Horizontal tab	`\t`
Vertical tab	`\v`
Character whose Unicode^®numeric value can be represented by the hexadecimal number,`N`	`\xN` Example:`sprintf('\x5A')`returns`'Z'`
Character whose Unicode numeric value can be represented by the octal number,`N`	`\N` Example:`sprintf('\132')`returns`'Z'`

Formatcan also include additional text before a percent sign,%, or after a conversion character. The text can be:

Ordinary text to print.
Special characters that you cannot enter as ordinary text. This table shows how to represent special characters informatSpec.

Length Specifiers

TheFormat Stringblock supports thehandllength subspecifiers. These specifiers can change according to theConfiguration Parameters>Hardware Implementation>Number of bitssettings

Length	d i	u o x X	f e E g G	s
No length specifier	`int`	`无符号整型`	`double`(default),`single`	`string`
`h`	`short`	`unsigned short`	—	—
`l`	`long`	`unsigned long`	—	—

Note for Specifiers that Specify Integer Data Types (`d`,`i`,`u`,`o`,`x`,`X`)

Targetint,long, andshorttype sizes are controlled by settings in theConfiguration Parameters>Hardware Implementationpane. For example, if the targetintis 32 bits and the specifier is%u, then the expected input type will beuint32. However, the input port accepts any built-in integer type of that size or smaller with the%uspecifier

Notes for Specifiers that Specify Floating Point Data Types (`f`,`e`,`E`,`g`,`F`)

Do not uselandhwith these specifiers. Do not use the length subspecifier (for example,%fis allowed, but%hfand%lfare not allowed) .
Ports that correspond with these specifiers accept bothsingleanddoubledata types.

Note for Specifiers that Specify the String Data Type (s)

Thesspecifier does not work with thelorhsubspecifiers, and only accepts a string input data type.

Compose String

Description

Ports

Input

`d`— Data for first part of string
标量

`f`— Data for second part of string
标量

`Port_N`— Data for N parts of string
标量(default)

Output

`str`— Output string
标量

Parameters

`Format`— Format input data
"%d %f" (default) | scalar

`Output data type`— Output data type
`string`(default) || scalar

Block Characteristics

Algorithms

Conversion Character

Optional Operators

Text Before or After Formatting Operators

Length Specifiers

Note for Specifiers that Specify Integer Data Types (`d`,`i`,`u`,`o`,`x`,`X`)

Notes for Specifiers that Specify Floating Point Data Types (`f`,`e`,`E`,`g`,`F`)

Note for Specifiers that Specify the String Data Type (s)

Extended Capabilities

C/C++ Code Generation
Generate C and C++ code using Simulink® Coder™.

See Also

Topics

Simulink Documentation

金宝app

Try MATLAB, Simulink, and Other Products

Compose String

Description

Ports

Input

d— Data for first part of string标量

f— Data for second part of string标量

Port_N— Data for N parts of string标量(default)

Output

str— Output string标量

Parameters

Format— Format input data"%d %f" (default) | scalar

Output data type— Output data typestring(default) || scalar

Block Characteristics

Algorithms

Conversion Character

Optional Operators

Text Before or After Formatting Operators

Length Specifiers

Note for Specifiers that Specify Integer Data Types (d,i,u,o,x,X)

Notes for Specifiers that Specify Floating Point Data Types (f,e,E,g,F)

Note for Specifiers that Specify the String Data Type (s)

Extended Capabilities

C/C++ Code GenerationGenerate C and C++ code using Simulink® Coder™.

See Also

Topics

Simulink Documentation

金宝app

Try MATLAB, Simulink, and Other Products

`d`— Data for first part of string
标量

`f`— Data for second part of string
标量

`Port_N`— Data for N parts of string
标量(default)

`str`— Output string
标量

`Format`— Format input data
"%d %f" (default) | scalar

`Output data type`— Output data type
`string`(default) || scalar

Note for Specifiers that Specify Integer Data Types (`d`,`i`,`u`,`o`,`x`,`X`)

Notes for Specifiers that Specify Floating Point Data Types (`f`,`e`,`E`,`g`,`F`)

C/C++ Code Generation
Generate C and C++ code using Simulink® Coder™.