compose

Данные о формате в несколько строк

свернуть все на странице

Синтаксис

str = compose(formatSpec,A)
str = compose(formatSpec,A1,...,AN)
str = compose(txt)

Описание

пример

str = compose(formatSpec,A) значения данных форматов от входного массива, A, использование операторов форматирования задано formatSpec и возвращает получившийся текст в str. compose функциональные значения форматов от A в порядке следования столбцов. Если formatSpec массив строк, затем так выходной массив str. В противном случае, str массив ячеек из символьных векторов.

compose также переводит последовательности символа ESC в formatSpec. Последовательности символа ESC представляют непечатаемые символы или задают действия, такие как новые строки или вкладки.

compose функция может возвратить несколько частей форматированного текста как массив строк или массив ячеек из символьных векторов, в отличие от sprintf. sprintf функция возвращает только скаляр строки или вектор символов.

  • Если A имеет несколько строк, затем compose возвращает str как массив строк или массив ячеек с одинаковым числом строк. compose повторения formatSpec в каждой строке str, с отформатированными значениями из соответствующей строки A.

  • Если количество столбцов в A превышает количество операторов в formatSpec, затем compose повторения formatSpec как дополнительный столбец str. Дополнительные столбцы A внесите отформатированные значения в новый столбец в str.

  • Если количество столбцов в A меньше количества операторов в formatSpec, затем compose не форматирует значения с помощью тех операторов. Вместо этого compose помещает неизменные операторы форматирования в str. Однако compose переводит все последовательности символа ESC за исключением \\ и %%.

str = compose(formatSpec,A1,...,AN) значения данных форматов от нескольких входных массивов и конкатенируют все отформатированные значения. Когда compose использование, форматирующее операторы от formatSpec чтобы преобразовать данные из входного массива, затем те, которые форматируют операторы, становятся недоступными к следующим входным массивам.

Например, если formatSpec "%f %f %d %s" и A1 имеет два столбца, затем операторы "%f %f" применяются к значениям в A1 только. Они не могут быть применены к A2 или любой другой входной массив. compose применяет остающиеся операторы, "%d %s", к A2,...,AN.

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

пример

str = compose(txt) переводит последовательности символа ESC в txt.

  • Если txt не содержит операторы форматирования, затем compose переводит все последовательности символа ESC. Это оставляет все другие символы без изменений.

  • Если txt содержит операторы форматирования, затем compose переводит все последовательности символа ESC за исключением \\ и %%. Это оставляет все другие символы, включая операторы форматирования, неизменные.

Примеры

свернуть все

Скрипт Open Live Script

Формат pi к восьми десятичным разрядам и возвращают его как строку.

A = pi
A = 3.1416

Начиная в R2017a, можно создать строки с помощью двойных кавычек. Задайте formatSpec как строка.

formatSpec = "%.8f"
formatSpec = 
"%.8f"

str = compose(formatSpec,A)
str = 
"3.14159265"

Создайте числовой массив, который содержит значения pi и e. Используйте %e и %f операторы с различной точностью.

A = [pi exp(1)]
A = 1×2

    3.1416    2.7183


formatSpec = "The value of pi is %.2e; the value of e is %.5f.";
str = compose(formatSpec,A)
str = 
"The value of pi is 3.14e+00; the value of e is 2.71828."
Скрипт Open Live Script

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

X = [1 2 3 4 5]';
Y = X.^2;

Начиная в R2017a, можно создать строки с помощью двойных кавычек. Задайте formatSpec как строка и возвращают отформатированные значения как массив строк.

formatSpec = "%d.^2 = %d";
str = compose(formatSpec,X,Y)
str = 5x1 string array
    "1.^2 = 1"
    "2.^2 = 4"
    "3.^2 = 9"
    "4.^2 = 16"
    "5.^2 = 25"
Скрипт Open Live Script

Значения формата, когда количество столбцов в массиве данных не равно количеству операторов. Если A имеет больше столбцов, затем compose повторения formatSpec как дополнительный столбец массива выводимой строки.

Начиная в R2017a, можно создать строки с помощью двойных кавычек. Задайте formatSpec как строка.

formatSpec = "The time is %d:%d";
A = [8 15 9 30;
     10 20 11 50];
str = compose(formatSpec,A)
str = 2x2 string array
    "The time is 8:15"     "The time is 9:30" 
    "The time is 10:20"    "The time is 11:50"

Значения формата, когда A имеет меньше столбцов.

formatSpec = "Check-in time %d:%d; Check-out time %d:%d";
A = [12 27;
     11 16];
str = compose(formatSpec,A)
str = 2x1 string array
    "Check-in time 12:27; Check-out time %d:%d"
    "Check-in time 11:16; Check-out time %d:%d"

Начиная с A имеет только два столбца, compose использование только первые два оператора форматирования в formatSpec отформатировать значения. compose оставляет другие операторы форматирования без изменений.

Скрипт Open Live Script

Создайте массив строк, который включает последовательности символа ESC, чтобы задать горизонтальные вкладки. Используйте compose функция, чтобы перевести \t символы ESC. Начиная в R2017a, можно создать строки с помощью двойных кавычек.

str = ["Name\tDate of Birth\tLocation";...
       "Jones\t10/20/2015\tUK";...
       "Simpson\t09/12/2015\tUSA"];
newStr = compose(str)
newStr = 3x1 string array
    "Name->Date of Birth->Location"
    "Jones->10/20/2015->UK"
    "Simpson->09/12/2015->USA"

Предотвратите перевод \n использование другого \ символ.

str = "Don't escape the second\n\\n escaped-character sequence.";
newStr = compose(str)
newStr = 
    "Don't escape the second
     \n escaped-character sequence."

Входные параметры

свернуть все

Форматируя операторы, заданные как массив строк, вектор символов или массив ячеек из символьных векторов, содержащий форматирование операторов. Если formatSpec включает буквенный текст, представляющий символы ESC, такие как \n, затем compose переводит символы ESC.

Оператор форматирования

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

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

Эта таблица показывает символы преобразования, чтобы отформатировать числовые и символьные данные как текст.

Тип значенияПреобразованиеДетали

Целое число, подписанное

%d или %i

Основа 10

Целое число, без знака

%u

Основа 10

%o

Базируйтесь 8 (восьмеричный)

%x

Основывайте 16 (шестнадцатеричных), строчных букв aF

%X

То же самое как %x, прописные буквы AF

Число с плавающей запятой

%f

Представление с фиксированной точкой (Используют оператор точности, чтобы задать количество цифр после десятичной точки.)

%e

Экспоненциальное представление, такое как 3.141593e+00 (Используйте оператор точности, чтобы задать количество цифр после десятичной точки.)

%E

То же самое как %e, но верхний регистр, такой как 3.141593E+00 (Используйте оператор точности, чтобы задать количество цифр после десятичной точки.)

%g

Более компактный из %e или %f, без конечных нулей (Используют оператор точности, чтобы задать количество значительных цифр.)

%G

Более компактный из %E или %f, без конечных нулей (Используют оператор точности, чтобы задать количество значительных цифр.)

'characters'

%c

Отдельный символ

%s

Символьный вектор

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

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

  • Флаги

    '–'

    Лево-выровнять по ширине.
    Пример: %-5.2f

    '+'

    Всегда распечатывайте символ знака (+ или –) для любого значения.
    Пример: %+5.2f

    ' '

    Вставьте пробел перед значением.
    Пример: % 5.2f

    '0'

    Заполните к ширине поля нулями перед значением.
    Пример: %05.2f

    '#'

    Измените выбранные числовые преобразования:

    • Для %oX, или %X, распечатайте 0, 0x, или 0X префикс.

    • Для %fE, или %E, распечатайте десятичную точку, даже когда точность 0.

    • Для %g или %G, не удаляйте конечные нули или десятичную точку.

    Пример: %#5.0f

  • Ширина поля

    Минимальное количество символов, чтобы распечатать.

    Пример: compose('%12d',intmax) возвращает " 2147483647".

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

  • Точность

    Количество цифр, чтобы распечатать.

    Для %fE, или %E

    Количество цифр справа от десятичной точки
    Пример: '%.4f' печать pi как '3.1416'

    Для %g или %G

    Количество значительных цифр
    Пример: '%.4g' печать pi как '3.142'

    Пример: compose('%6.4f',pi) возвращает "3.1416".

    Примечание

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

  • Подтипы

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

    Тип входного значения

    Подтип и символ преобразования

    Тип выходного значения

    Число с плавающей запятой

    %bx или %bX
    %bo
    %bu

    С двойной точностью шестнадцатеричное, восьмеричное, или десятичное значение
    Пример: %bx печать pi как 400921fb54442d18

    %tx или %tX
    %to
    %tu

    Шестнадцатеричное, восьмеричное, или десятичное значение с одинарной точностью
    Пример: %tx печать pi как 40490fdb

Известное поведение преобразований с операторами форматирования

  • Числовые преобразования распечатывают только действительный компонент комплексных чисел.

  • Если вы задаете преобразование, которое не соответствует данным, таким как преобразование символов для числового значения, MATLAB® заменяет заданное преобразование и использует %e.

    Примеры преобразует pi к 3.141593e+00.

  • Если вы применяете преобразование строк (%s) к целочисленным значениям MATLAB преобразует значения, которые соответствуют кодам допустимого символа к символам.

    Примеры преобразует [65 66 67] к "ABC".

Типы данных: string | char | cell

Числовой, символ или массив строк, заданный как скаляр, вектор, матрица или многомерный массив.

Типы данных: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical | char | string

Введите текст, заданный как массив строк, вектор символов или массив ячеек из символьных векторов. compose переводит любые последовательности символа ESC в txt. Например, compose переводит \n в символ новой строки.

Типы данных: string | char | cell

Выходные аргументы

свернуть все

Форматированный текст, возвращенный как массив строк или массив ячеек из символьных векторов.

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

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

Смотрите также

| | | |

Темы

Введенный в R2017b

Документация MATLAB
Поддержка
Для просмотра документации необходимо авторизоваться на сайте