Создать строку

Формирование выходного строкового сигнала на основе заданного формата и входных сигналов

Библиотека:
Симулинк/строка

Описание

Блок 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. Дополнительные сведения см. в разделе Параметр «Формат».

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

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

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

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

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

Продукция

развернуть все

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

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

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

Параметры

развернуть все

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

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

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

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

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

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

Нажмите кнопку Показать помощник по типам данных, чтобы отобразить помощник по типам данных, который помогает задать атрибуты типов данных. Дополнительные сведения см. в разделе Определение типов данных с помощью помощника по типам данных.

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

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

Алгоритмы

развернуть все

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

Блок «» Создать строку «» использует прототип спецификатора формата:

%[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`	Тип выходного текста совпадает с типом «Формат».

Дополнительные операторы

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

Флаги

`'–'`	Выравнивание слева. Работает со всеми спецификаторами. Пример: `%-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'`

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

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

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

Блок «Строка формата» поддерживает h и l подвиды длины. Эти спецификаторы могут изменяться в соответствии с параметрами конфигурации > Реализация аппаратных средств > Количество битов

Длина	d i	u o x X	f E 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 размеры типов определяются параметрами на панели «Параметры конфигурации» > «Реализация оборудования». Например, если цель int 32 бита и спецификатор %u, то ожидаемый тип ввода будет uint32. Однако входной порт принимает любой встроенный тип целого числа такого размера или меньшего размера с помощью %u спецификатор

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

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

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

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

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

Создание кода C/C + +
Создайте код C и C++ с помощью Simulink ® Coder™

См. также

Темы

Представлен в R2018a

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

Создать строку

Описание

Порты

Вход

`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++ с помощью Simulink ® Coder™

См. также

Темы

Документация 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++ с помощью Simulink ® Coder™

См. также

Темы

Документация 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++ с помощью Simulink ® Coder™