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

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

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

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

A = 46*ones(1,4);
txt = sprintf('%d   %f   %e   %X', A)

txt = 
'46   46.000000   4.600000e+01   2E'

Подтип

Поле подтипа является отдельным буквенным символом, который сразу предшествует символу преобразования. Без поля подтипа, символы преобразования %oXX, и %u обработайте входные данные как целые числа. Чтобы обработать входные данные как значения с плавающей точкой вместо этого и преобразовать их в восьмеричные, десятичные, или шестнадцатеричные представления, используйте один из следующих спецификаторов подтипа.

Точность

Поле точности в операторе форматирования является неотрицательным целым числом, которое сразу следует за периодом. Например, в операторе %7.3f, точностью является 3. Для %g оператор, точность указывает на количество значительных цифр, чтобы отобразиться. Для %fE, и %E операторы, точность указывает сколько цифр, чтобы отобразиться справа от десятичной точки.

Отобразите числа к различной точности с помощью поля точности.

txt = sprintf('%g   %.2g   %f   %.2f', pi*50*ones(1,4))

txt = 
'157.08   1.6e+02   157.079633   157.08'

В то время как можно задать точность в операторе форматирования для входного текста (например, в %s оператор), обычно нет никакой причины сделать так. Если вы задаете точность как p, и p меньше количества символов во входном тексте, затем выход содержит только первый p 'characters'.

Ширина поля

Ширина поля в операторе форматирования является неотрицательным целым числом, которое задает количество цифр или символов в выходе при форматировании входных значений. Например, в операторе %7.3f, шириной поля является 7.

Задайте различную ширину поля. Чтобы показать ширину для каждого выхода, используйте | символ. По умолчанию синтезируемый текст дополнен пробелами, когда ширина поля больше количества символов.

txt = sprintf('|%e|%15e|%f|%15f|', pi*50*ones(1,4))

txt = 
'|1.570796e+02|   1.570796e+02|157.079633|     157.079633|'

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

txt = sprintf('%30s', 'Pad left with spaces')

txt = 
'          Pad left with spaces'

Флаги

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

Право - и лево-выравнивает по ширине выход. Поведение по умолчанию должно исправиться - выравнивают по ширине синтезируемый текст.

txt = sprintf('right-justify: %12.2f\nleft-justify: %-12.2f',...
              12.3, 12.3)

txt = 
    'right-justify:        12.30
     left-justify: 12.30       '

Отобразите + распишитесь за положительные числа. Поведение по умолчанию должно не использовать ведущий + распишитесь за положительные числа.

txt = sprintf('no sign: %12.2f\nsign: %+12.2f',...
              12.3, 12.3)

txt = 
    'no sign:        12.30
     sign:       +12.30'

Заполните налево пробелами, и обнуляет. Поведение по умолчанию должно заполнить пробелами.

txt = sprintf('Pad with spaces: %12.2f\nPad with zeroes: %012.2f',...
              5.2, 5.2)

txt = 
    'Pad with spaces:         5.20
     Pad with zeroes: 000000005.20'

Идентификаторы значения

По умолчанию, функции такой как sprintf вставьте значения от входных параметров в синтезируемый текст в последовательном порядке. Чтобы обработать входные параметры в непоследовательном порядке, задайте порядок с помощью числовых идентификаторов в спецификаторе формата. Задайте непоследовательные аргументы с целым числом сразу после % подпишитесь, сопровождаемый $ знак.

sprintf('%s %s %s',...
        '1st','2nd','3rd')

ans =

    '1st 2nd 3rd'

sprintf('%3$s %2$s %1$s',...
        '1st','2nd','3rd')

ans =

    '3rd 2nd 1st'

Специальные символы

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

Правила для форматирования точности и ширины поля

Фигура иллюстрирует, как ширина поля и настройки точности влияют на выход функций форматирования. В этом рисунке, нуле после % войдите в систему оператор форматирования означает добавлять, что продвижение обнуляет к синтезируемому тексту, а не пробелам.

Определение ширины поля и точности вне спецификатора формата

Можно задать ширину поля и точность с помощью значений из последовательного списка аргументов. Используйте звездочку (*) вместо полей ширины поля или точности оператора форматирования.

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

txt = sprintf('%*f   %.*f   %*.*f',...
              15,123.45678,...     
              3,16.42837,...       
              6,4,pi)

txt = 
'     123.456780   16.428   3.1416'

Таблица описывает эффекты каждого оператора форматирования в примере.

Можно смешать два стиля. Например, получите ширину поля от следующего входного параметра и точность от спецификатора формата.

txt = sprintf('%*.2f', 5, 123.45678)

txt = 
'123.46'

Определение пронумерованных идентификаторов по ширине и полей точности

Также можно задать ширину поля и точность как значения из непоследовательного списка аргументов, с помощью альтернативного показанного на рисунке синтаксиса. В операторе форматирования задайте ширину поля и точность со звездочками, которые следуют за пронумерованными идентификаторами и $ знаки. Задайте значения ширины поля и точности с входными параметрами, которые следуют за спецификатором формата.

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

txt = sprintf('%1$*4$f   %2$.*5$f   %3$*6$.*7$f',...
              123.45678, 16.42837, pi, 15, 3, 6, 4)

txt = 
'     123.456780   16.428   3.1416'

Таблица описывает эффект каждого оператора форматирования в примере.