Compose String

Составьте выходной строчный сигнал на основе заданного формата и входных сигналов

Библиотека:
Simulink/Строка

Описание

Блок Compose String составляет выходной строчный сигнал на основе спецификатора формата, указанного в параметре Format. Параметр Format определяет количество входных сигналов. Если существует несколько входов, блок создает строку путем объединения этих нескольких входов по порядку и применения связанного спецификатора формата, одного спецификатора формата для каждого входа. Каждый спецификатор формата начинается со знака процента, %, за которым следует символ преобразования. Для примера, %f форматирует вход как выход с плавающей точкой. Чтобы дополнить выход строки, можно также добавить символ к спецификации формата. Используйте этот блок для составления и форматирования выхода строчного сигнала из нескольких входных параметров.

Для примера, если параметр Format содержит "%s is %f"блок ожидает два входа, строчный сигнал и один или двойной сигнал. Если первый вход является строкой "Pi" и второй вход является двойным значением 3.14, выход следующий "Pi is 3.14".

Когда MinGW^® компилятор компилирует код, сгенерированный из блока, выполнение скомпилированного кода может привести к нестандартным результатам для входов с плавающей точкой. Для примера - числовой вход 501.987 возвращает строку "5.019870e+002" вместо ожидаемой строки "5.019870e+02".

Порты

Вход

расширить все

`d` - Данные для первой части строки
скаляр

Данные для первой части строки, заданные как скаляр. Параметр Format определяет метку порта и формат входных данных. Например, если первый элемент в параметре Format %d, метка порта d.

Тип данных входного сигнала должен быть совместим со спецификатором формата в параметре Format. Для получения дополнительной информации смотрите параметр Format.

`f` - Данные для второй части строки
скаляр

Данные для второй части строки, заданные как скаляр. Параметр Format определяет метку порта и формат входных данных. Например, если первый элемент в параметре Format %f, метка порта f.

Тип данных входного сигнала должен быть совместим со спецификатором формата, заданным в параметре Format. Для получения дополнительной информации смотрите параметр Format.

`Port_N` - Данные для N частей строки
скаляр (по умолчанию)

Данные для N части строки, заданные как скаляр. Параметр Format определяет метку порта и формат входных данных. Например, если соответствующий элемент в параметре Format %f, метка порта f.

Выход

расширить все

`str` - Выходная строка
скаляр

Выходная строка, составленная из входов, заданных как скаляр.

Типы данных: string

Параметры

расширить все

`Format` - Формат входных данных
«% d% f» (по умолчанию) | скаляром

Формат входных данных, заданный как скаляр.

Для получения дополнительной информации о приемлемых спецификаторах формата см. Раздел «Алгоритмы».

`Output data type` - Тип выходных данных
`string` (по умолчанию) | `<data type expression>` | скаляр

Выход данных, заданный с помощью типа строковых данных, чтобы задать строку без максимальной длины.

Чтобы задать тип строковых данных с максимальной длиной, задайте тип стрингтипа (N). Для примера, stringtype(31) создает строку тип данных с максимальной длиной 31 символ.

Нажмите кнопку Show data type assistant, чтобы отобразить Data Type Assistant, которая помогает вам задать атрибуты type данных. Дополнительные сведения см. в разделе «Установка типов данных с использованием Data Type Assistant».

Характеристики блоков

Типы данных	`double` \| `integer` \| `single` \| `string`
Прямое сквозное соединение	`yes`
Многомерные сигналы	`no`
Сигналы переменного размера	`no`
Обнаружение пересечения нулем	`no`

Алгоритмы

расширить все

Спецификатор форматирования начинается со знака процента %, и заканчивается символом преобразования. Требуется символ преобразования. Вы также можете задать идентификатор, флаги, ширину поля, точность и спецификаторы подтипа между % и символ преобразования. (Пространства недопустимы между спецификаторами и показаны здесь только для читаемости).

Блок Compose String использует этот прототип спецификатора формата:

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

Символ преобразования

В этой таблице показаны символы преобразования в форматирование числовых и символьных данных в виде текста.

Тип значения	Преобразование	Подробнее
Целое число, со знаком	`%d` или `%i`	Основа 10
Целое число, без знака	`%u`	Основа 10
	`%o`	База 8 (октальная)
	`%x`	База 16 (шестнадцатеричная), строчные буквы `a`– `f`
	`%X`	То же, что и `%x`, заглавные буквы `A`– `F`
Число с плавающей запятой	`%f`	Обозначение с плавающей точкой (Используйте оператор точности, чтобы задать количество цифр после десятичного знака.)
	`%e`	Экспоненциальное обозначение, такое как `3.141593e+00` (Используйте оператор точности, чтобы задать количество цифр после десятичной точки.)
	`%E`	То же, что и `%e`, но в верхнем регистре, например `3.141593E+00` (Используйте оператор точности, чтобы задать количество цифр после десятичной точки.)
	`%g`	Чем компактнее `%e` или `%f`, без конечных нулей (Используйте оператор точности, чтобы задать количество значащих цифр.)
	`%G`	Чем компактнее `%E` или `%f`, без конечных нулей (Используйте оператор точности, чтобы задать количество значащих цифр.)
Строка	`%s`	Тип выходного текста совпадает с типом Format.

Необязательные операторы

Необязательный идентификатор, флаги, ширина поля, точность и операторы дополнительно определяют формат выходного текста.

Флаги

`'–'`	Слева-оправдать. Работает со всеми спецификаторами. Пример: `%-5.2f` Пример: `%-10s`
`'+'`	Всегда печатайте символ (+ или -) для любого числового значения. Работает со всеми спецификаторами, кроме `u`, `o`, `x`, `X`, и `s`. Пример: `%+5.2f` Текст с выравниванием по правому краю. Пример: `%+10s`
`' '`	Вставьте пространство перед значением. Работает со всеми спецификаторами, кроме `u`, `o`, `x`, `X`, и `s`. Пример: `% 5.2f`
`'0'`	Заполните до ширины поля нулями перед значением. Работает со всеми спецификаторами, кроме `s`. Пример: `%05.2f`
`'#'`	Измените выбранные числовые преобразования: Для `%o`, `%x`, или `%X`, печать `0`, `0x`, или `0X` префикс. Для `%f`, `%e`, или `%E`, напечатайте десятичную точку, даже если точность равна 0. Для `%g` или `%G`, не удаляйте конечные нули или десятичную точку. Работает со всеми спецификаторами, кроме `d`, `i`, `u`, и `s`. Пример: `%#5.0f`

Ширина поля
Минимальное количество символов для печати.
Функция заполняет поле шириной пространств перед значением, если иное не задано флагами.

Точность

Для `%f`, `%e`, или `%E`	Количество цифр справа от десятичной точки Пример: '%.4f' печатает `pi` как `'3.1416'`
d, i, o, u, x, X	Минимальное количество цифр для записи. Выходы короче заданной точности заполняются начальными нулями. Пример: `"%.4d"` печатает 5 как `'0005'`
Для `%g` или `%G`	Количество значащих цифр Пример: '%.4g' печатает `pi` как `'3.142'`
s	Максимальное количество символов для записи в выход. Пример: "%.2s" печатает `"Hello!"` как `"He"`

Примечание

Если вы задаете оператор точности для значений с плавающей точкой, который превышает точность входного типа числовых данных, результаты могут не совпадать с заданной точностью. Результат зависит от оборудования компьютера и операционной системы.

Текст до или после операторов форматирования

Специальный символ	Представление
Одинарная кавычка	`''`
Процент символа	`%%`
Обратная косая черта	`\\`
Тревога	`\a`
Клавиша Backspace	`\b`
Подача формы	`\f`
Новая линия	`\n`
Возврат каретки	`\r`
Горизонтальная вкладка	`\t`
Вертикальная вкладка	`\v`
Символ, чей Юникод^® числовое значение может быть представлено шестнадцатеричным числом, `N`	`\xN` Пример: sprintf('\x5A') возвращает `'Z'`
Символ, числовое значение в Юникоде которого может быть представлено восьмеричным числом `N`	`\N` Пример: sprintf('\132') возвращает `'Z'`

Format также можете включать дополнительный текст перед процентным знаком %, или после символа преобразования. Текст может быть:

Обычный текст для печати.
Специальные символы, которые вы не можете ввести как обычный текст. В этой таблице показано, как представлять специальные символы в formatSpec.

Спецификаторы длины

Блок Format String поддерживает h и l подспецификаторы длины. Эти спецификаторы могут меняться в соответствии с настройками Configuration Parameters > Hardware Implementation > Number of bits

Длина	d i	u o x X	f e e G G	s
Длина отсутствует спецификатор	`int`	`unsigned int`	`double` (по умолчанию), `single`	`string`
`h`	`short`	`unsigned short`	—	—
`l`	`long`	`unsigned long`	—	—

Примечание для спецификаторов, которые задают целочисленные типы данных (`d`, `i`, `u`, `o`, `x`, `X`)

Целевое int, long, и short размеры типов определяются параметрами на панели Configuration Parameters > Hardware Implementation. Для примера, если целевой int 32 бита, и спецификатор %u, тогда ожидаемый тип входного сигнала будет uint32. Однако порт входа принимает любые встроенные целые типы такого размера или меньше с %u спецификатор

Примечания для спецификаторов, которые задают типы данных с плавающей точкой (f, `e`, `E`, `g`, `F`)

Не используйте l и h с этими спецификаторами. Не используйте подспецификатор длины (для примера, %f разрешено, но %hf и %lf не разрешены).
Порты, которые соответствуют этим спецификаторам, принимают оба single и double типы данных.

Примечание для спецификаторов, которые задают тип (ы) строковых данных

The s спецификатор не работает со l или h Подспецификаторы и принимают только строка тип входных данных.

Расширенные возможности

Генерация кода C/C + +
Сгенерируйте код C и C++ с помощью Coder™ Simulink ®

См. также

Темы

Введенный в R2018a

Документация

Compose String

Описание

Порты

Вход

`d` - Данные для первой части строки
скаляр

`f` - Данные для второй части строки
скаляр

`Port_N` - Данные для N частей строки
скаляр (по умолчанию)

Выход

`str` - Выходная строка
скаляр

Параметры

`Format` - Формат входных данных
«% d% f» (по умолчанию) | скаляром

`Output data type` - Тип выходных данных
`string` (по умолчанию) | `<data type expression>` | скаляр

Характеристики блоков

Алгоритмы

Символ преобразования

Необязательные операторы

Текст до или после операторов форматирования

Спецификаторы длины

Примечание для спецификаторов, которые задают целочисленные типы данных (`d`, `i`, `u`, `o`, `x`, `X`)

Примечания для спецификаторов, которые задают типы данных с плавающей точкой (f, `e`, `E`, `g`, `F`)

Примечание для спецификаторов, которые задают тип (ы) строковых данных

Расширенные возможности

Генерация кода C/C + +
Сгенерируйте код C и C++ с помощью Coder™ Simulink ®

См. также

Темы

Документация Simulink

Поддержка

Документация

Compose String

Описание

Порты

Вход

d - Данные для первой части строки скаляр

f - Данные для второй части строки скаляр

Port_N - Данные для N частей строки скаляр (по умолчанию)

Выход

str - Выходная строка скаляр

Параметры

Format - Формат входных данных «% d% f» (по умолчанию) | скаляром

Output data type - Тип выходных данных string (по умолчанию) | <data type expression> | скаляр

Характеристики блоков

Алгоритмы

Символ преобразования

Необязательные операторы

Текст до или после операторов форматирования

Спецификаторы длины

Примечание для спецификаторов, которые задают целочисленные типы данных (d, i, u, o, x, X)

Примечания для спецификаторов, которые задают типы данных с плавающей точкой (f, e, E, g, F)

Примечание для спецификаторов, которые задают тип (ы) строковых данных

Расширенные возможности

Генерация кода C/C + + Сгенерируйте код C и C++ с помощью Coder™ Simulink ®

См. также

Темы

Документация Simulink

Поддержка

`d` - Данные для первой части строки
скаляр

`f` - Данные для второй части строки
скаляр

`Port_N` - Данные для N частей строки
скаляр (по умолчанию)

`str` - Выходная строка
скаляр

`Format` - Формат входных данных
«% d% f» (по умолчанию) | скаляром

`Output data type` - Тип выходных данных
`string` (по умолчанию) | `<data type expression>` | скаляр

Примечание для спецификаторов, которые задают целочисленные типы данных (`d`, `i`, `u`, `o`, `x`, `X`)

Примечания для спецификаторов, которые задают типы данных с плавающей точкой (f, `e`, `E`, `g`, `F`)

Генерация кода C/C + +
Сгенерируйте код C и C++ с помощью Coder™ Simulink ®