14.1.1 Вывод в терминал

Поскольку Octave обычно выводит значение выражения сразу после его вычисления, простейшей из всех функций ввода-вывода является обычное выражение. Например, следующее выражение отобразит значение «pi»

pi
     -| ans =  3.1416

Это хорошо работает, если допустимо выводить вместе со значением имя переменной (или «ans»). Чтобы вывести значение переменной без её имени, используйте функцию disp.

Команда format позволяет управлять тем, как Octave выводит значения с помощью disp и стандартного механизма эхо-вывода.

: disp (x)

: str = disp (x)

Отобразить значение x.

Например:

disp ("The value of pi is:"), disp (pi)

     -| the value of pi is:
     -| 3.1416

Обратите внимание, что вывод disp всегда заканчивается символом новой строки.

Если запрошено выходное значение, disp ничего не выводит, а возвращает отформатированный вывод в виде строки.

См. также: fdisp.

: str = list_in_columns (arg, width, prefix)

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

Аргумент arg должен быть массивом ячеек, содержащим символьные строки, или символьным массивом.

Если width не задан, является пустой матрицей или меньше либо равен нулю, используется ширина окна терминала. Для разбиения строк в выходной строке используются символы новой строки. Например:

list_in_columns ({"abc", "def", "ghijkl", "mnop", "qrs", "tuv"}, 20)
     ⇒ abc     mnop
        def     qrs
        ghijkl  tuv

whos ans
     ⇒
     Variables in the current scope:

       Attr Name        Size                     Bytes  Class
       ==== ====        ====                     =====  =====
            ans         1x37                        37  char

     Total is 37 elements using 37 bytes

См. также: terminal_size.

: [rows, cols] = terminal_size ()

: terminal_size ([rows, cols])

Запросить или задать размер окна терминала. При вызове без аргументов возвращает вектор-строку из двух элементов, содержащий текущий размер окна терминала в символах (строки и столбцы). При вызове с вектором из двух целочисленных значений задаёт размер терминала и возвращает предыдущее значение. При использовании readline для редактирования командной строки задавать размер вручную не требуется.

См. также: list_in_columns.

: format

: format options

: format (options)

: [format, formatspacing, uppercase] = format

Сбросить или задать формат вывода, создаваемого командой disp и стандартным механизмом эхо-вывода Octave.

Эта команда влияет только на отображение чисел, но не на способ их хранения или вычисления. Чтобы изменить внутреннее представление по умолчанию double, используйте одну из функций преобразования, например single, uint8, int64 и т. д. Любые параметры format, изменяющие количество отображаемых значащих цифр, также будут учитываться функцией output_precision.

По умолчанию Octave отображает 5 значащих цифр в удобном для чтения виде (формат «short», параметр «lowercase» и параметр «loose» для матриц). Если format вызвана без параметров или указан параметр «default», восстанавливается этот формат по умолчанию.

Допустимые параметры формата чисел с плавающей точкой перечислены в следующей таблице.

default

Восстановить описанный выше формат по умолчанию.

short

Формат с фиксированной точкой и 5 значащими цифрами (по умолчанию).

long

Формат с фиксированной точкой и 16 значащими цифрами.

Как и в формате «short», если Octave не может корректно отформатировать матрицу с использованием текущего формата, он переключается на экспоненциальный формат «e».

shorte

longe

Экспоненциальный формат. Представляемое число разделяется на мантиссу и показатель степени (степень 10). В коротком формате мантисса содержит 5 значащих цифр. В длинном формате значения типа double отображаются с 16 значащими цифрами, а значения типа single — с 8. Например, в формате «shorte» pi отображается как 3.1416e+00. При желании конечный символ «e» можно вынести в отдельный второй аргумент.

shortg

longg

Оптимально выбирать между форматом с фиксированной точкой и экспоненциальным форматом в зависимости от величины числа. Например, в формате «shortg» pi .^ [2; 4; 8; 16; 32] отображается следующим образом:

ans =

      9.8696
      97.409
      9488.5
  9.0032e+07
  8.1058e+15

При желании конечный символ «g» можно вынести в отдельный второй аргумент.

shorteng

longeng

Аналогичен форматам «shorte» или «longe», но значения отображаются в инженерном формате, в котором показатель степени кратен 3. Например, в формате «shorteng» 10 * pi отображается как 31.416e+00. При желании конечный фрагмент «eng» можно вынести в отдельный второй аргумент.

free

none

Выводить данные в свободном формате, не пытаясь выравнивать столбцы матриц по десятичной точке. Это необработанный формат, эквивалентный коду C++ std::cout << variable. Как правило, результат отображается с 6 значащими цифрами, при этом ненужная точность (например, завершающие нули у целых чисел) опускается. Комплексные числа форматируются как пары чисел, например «(0.60419, 0.60709)», а не в виде «0.60419 + 0.60709i».

Следующие форматы влияют на весь числовой вывод (типы с плавающей точкой и целочисленные типы).

"+"

"+" "chars"

plus

plus chars

Выводить символ «+» для элементов матрицы больше нуля, символ «-» для элементов меньше нуля и пробел для нулевых элементов. Этот формат может быть полезен для изучения структуры разреженности большой матрицы. Для очень больших матриц функция spy, отображающая структуру разреженности графически, будет нагляднее.

Необязательный аргумент chars задаёт список из 3 символов для вывода значений больше нуля, меньше нуля и равных нулю. Например, при использовании формата "+" "+-." матрица [1, 0, -1; -1, 0, 1] отображается следующим образом:

ans =

+.-
-.+

bank

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

bit

Выводить битовое представление чисел в памяти, всегда начиная со старшего бита. Например, pi выводится следующим образом:

0 10000000000 1001001000011111101101010100010001000010110100011000

Здесь для наглядности добавлены пробелы, обозначающие знаковый бит, 11-битный показатель степени и 52-битную мантиссу именно в таком порядке. Вместе они представляют pi в нормализованной форме числа с плавающей точкой двойной точности IEEE 754. Для чисел с плавающей точкой одинарной точности используется аналогичное представление.

native-bit

Выводить битовое представление чисел в том виде, в котором они хранятся в памяти. Для машин с порядком байтов от старшего к младшему оно совпадает с расположением format bit, показанным выше. Для машин с порядком байтов от младшего к старшему байты выводятся в обратном порядке, однако биты внутри байта по-прежнему отображаются старшим битом слева.

Например, значение pi в этом формате на x86-64 имеет вид:

00011000 00101101 01000100 01010100 11111011 00100001 00001001 01000000

Здесь для наглядности добавлены пробелы. Сравните с предыдущей битовой строкой из format bit, чтобы увидеть группировку по байтам и их порядок.

hex

То же, что и format bit выше, за исключением того, что для краткости биты группируются по четыре в шестнадцатеричные цифры. Таким образом, pi представляется следующим образом:

400921fb54442d18

native-hex

То же, что и format native-bit выше, за исключением того, что для краткости биты группируются по четыре в шестнадцатеричные цифры. Таким образом, на x86-64 pi представляется следующим образом:

182d4454fb210940

rat

Выводить рациональное приближение, то есть аппроксимировать значения отношением небольших целых чисел. Например, в формате «rat» pi отображается как 355/113.

Следующие два параметра влияют на отображение научной и шестнадцатеричной нотаций.

lowercase (default)

Использовать строчную букву «e» в качестве символа показателя степени в научной нотации и строчные буквы «a-f» для шестнадцатеричных цифр, обозначающих значения от 10 до 15.

uppercase

Использовать прописную букву «E» в качестве символа показателя степени в научной нотации и прописные буквы «A-F» для шестнадцатеричных цифр, обозначающих значения от 10 до 15.

Следующие два параметра влияют на отображение всех матриц.

compact

Убирать пустые строки вокруг меток номеров столбцов и между матрицами, чтобы сделать вывод компактнее и разместить больше данных на странице.

loose (default)

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

Если format вызвана с несколькими противоречащими друг другу параметрами, используется самый правый из них, кроме «default», который переопределяет все остальные параметры. В случае ошибки формат не меняется.

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

См. также: fixed_point_format, output_precision, split_long_rows, print_empty_dimensions, rats.

• Постраничный вывод на экран