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.

: 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.

: terminal_size ()

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

См. также: list_in_columns.

: format

: format options

: [format, formatspacing, uppercase] = format

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

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

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

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

short

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

long

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

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

short e

long e

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

short g

long g

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

ans =

      9.8696
      97.409
      9488.5
  9.0032e+07
  8.1058e+15

short eng

long eng

Идентично ‘short e’ или ‘long e’, но отображает значение в инженерном формате, где показатель степени делится на 3. Например, в формате ‘short eng’ значение 10 * pi отображается как 31.416e+00.

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

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

native-hex

Выводит шестнадцатеричное представление чисел так, как они хранятся в памяти. Например, на рабочем станция, которая хранит 8-байтовые вещественные значения в формате IEEE с наименее значимым байтом в начале, значение pi при выводе в формате native-hex равно 400921fb54442d18.

hex

То же, что и native-hex, но всегда выводит самый значимый байт вначале.

native-bit

Выводит битовое представление чисел, как они хранятся в памяти. Например, значение pi равно

01000000000010010010000111111011
01010100010001000010110100011000

(здесь показано в двух 32-битных секциях для целей верстки) при выводе в формате native-bit на рабочей станции, которая хранит 8-байтовые вещественные значения в формате IEEE с наименее значимым байтом в начале.

bit

То же, что и native-bit, но всегда выводит самые значимые биты вначале.

rat

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

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

lowercase (default)

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

uppercase

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

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

compact

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

loose (default)

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

Если format вызывается с несколькими конкурирующими опциями, используется правая. В случае ошибки формат остается неизменным.

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

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