2.4.5 Команды для работы с историей

Octave обычно отслеживает вводимые вами команды, чтобы вы могли восстановить предыдущие команды для редактирования или повторного выполнения. При выходе из Octave самые последние введённые вами команды, до числа, указанного переменной history_size, сохраняются в файле. При запуске Octave загружает начальный список команд из файла, имя которого указано в переменной history_file.

Ниже приведены команды для простого просмотра и поиска в списке истории.

LFD

RET

Принимает текущую строку независимо от позиции курсора. Если строка не пустая, добавляет её в список истории. Если строка была строкой истории, то восстанавливает строку истории в её исходное состояние.

C-p

Перемещает вверх по списку истории.

C-n

Перемещает вниз по списку истории.

M-<

Перемещает к первой строке в истории.

M->

Перемещает к концу истории ввода, т.е. к строке, которую вы вводите!

C-r

Ищет назад, начиная с текущей строки и перемещаясь вверх по истории по мере необходимости. Это инкрементный поиск.

C-s

Ищет вперёд, начиная с текущей строки и перемещаясь вниз по истории по мере необходимости.

На большинстве терминалов вы также можете использовать клавиши со стрелками вверх и вниз вместо C-p и C-n для перемещения по списку истории.

Помимо команд с клавиатуры для перемещения по списку истории, Octave предоставляет три функции для просмотра, редактирования и повторного выполнения фрагментов команд из списка истории.

: history ¶

: history opt1 … ¶

: h = history () ¶

: h = history (opt1, …) ¶

Если вызвана без аргументов, history отображает список команд, которые вы выполнили.

Допустимые параметры:

n

-n

Отобразить только последние n строк истории.

-c

Очистить список истории.

-q

Не нумеровать отображаемые строки истории. Это полезно для копирования и вставки команд с помощью X Window System.

-r file

Прочитать файл file, добавив его содержимое в текущий список истории. Если имя опущено, используется файл истории по умолчанию (обычно ~/.octave_hist).

-w file

Записать текущую историю в файл file. Если имя опущено, используется файл истории по умолчанию (обычно ~/.octave_hist).

Например, чтобы отобразить пять последних введённых команд без отображения номеров строк, используйте команду history -q 5.

Если вызвана с одним аргументом вывода, история сохранится в этом аргументе как массив строк и не будет выведена на экран.

См. также: edit_history, run_history.

: edit_history ¶

: edit_history cmd_number ¶

: edit_history first last ¶

Редактировать список истории с помощью редактора, имя которого задано переменной EDITOR.

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

При вызове без аргументов, редактируется предыдущая команда; с одним аргументом — редактируется указанная команда cmd_number; с двумя аргументами — редактируется список команд между first и last. Спецификаторы номера команды также могут быть отрицательными, где -1 относится к последней выполненной команде. Следующие эквивалентны и редактируют последнюю выполненную команду.

edit_history
edit_history -1

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

См. также: run_history, history.

: run_history ¶

: run_history cmd_number ¶

: run_history first last ¶

Выполнить команды из списка истории.

При вызове без аргументов выполняется предыдущая команда;

С одним аргументом выполняется указанная команда cmd_number;

С двумя аргументами выполняется список команд между first и last. Спецификаторы номера команды также могут быть отрицательными, где -1 относится к последней выполненной команде. Например, команда

run_history
     OR
run_history -1

выполняет последнюю команду ещё раз. Команда

run_history 13 169

выполняет команды с 13-й по 169-ю.

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

disp (1)
disp (2)
run_history -1 -2
⇒
 2
 1

См. также: edit_history, history.

Octave также позволяет настраивать детали того, когда, где и как сохраняется история.

: val = history_save () ¶

: old_val = history_save (new_val) ¶

: history_save (new_val, "local") ¶

Запрос или установка внутренней переменной, которая управляет сохранением вводимых в командной строке команд в файле истории.

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

См. также: history_control, history_file, history_size, history_timestamp_format_string.

: val = history_control () ¶

: old_val = history_control (new_val) ¶

Запрос или установка внутренней переменной, которая определяет, как команды сохраняются в списке истории.

Значение по умолчанию — пустая строка, но может быть переопределено переменной среды OCTAVE_HISTCONTROL.

Значение history_control — список значений, разделённых двоеточием, управляющих тем, как команды сохраняются в списке истории. Если список значений включает ignorespace, строки, начинающиеся с пробела, не сохраняются в списке истории. Значение ignoredups вызывает не сохранение строк, совпадающих с предыдущей записью истории. Значение ignoreboth — сокращение для ignorespace и ignoredups. Значение erasedups вызывает удаление всех предыдущих строк, совпадающих с текущей строкой, из списка истории перед сохранением этой строки. Любое значение, не включенное в вышеперечисленный список, игнорируется. Если history_control пустая строка, все команды сохраняются в списке истории, подчинённые значению history_save.

См. также: history_file, history_size, history_timestamp_format_string, history_save.

: val = history_file () ¶

: old_val = history_file (new_val) ¶

Запрос или установка внутренней переменной, которая определяет имя файла, используемого для хранения истории команд.

Все будущие команды, выданные во время текущей сессии Octave, будут записаны в этот новый файл (если текущее значение history_save позволяет это).

Значение по умолчанию — $DATA/octave/history, где $DATA — это платформа-специфическое расположение файлов данных пользователя (например, $XDG_DATA_HOME или, если это не задано, ~/.local/share в системах на основе Unix или %APPDATA% в Windows). Значение по умолчанию может быть переопределено переменной окружения OCTAVE_HISTFILE.

Примечания по программированию:

Если вы хотите постоянно изменить расположение файла истории Octave, вам необходимо выполнить команду history_file в каждой новой сессии Octave. Это можно сделать, используя файл запуска Octave .octaverc.

Если вы также хотите прочитать сохраненные команды истории из предыдущих сессий Octave из этого другого файла истории, вам нужно использовать дополнительную команду history -r после установки нового значения файла истории. Пример кода в файле запуска Octave для этого может выглядеть так:

history_file ("~/new/.octave_hist");
if (exist (history_file ()))
  history ("-r", history_file());
endif

См. также: history, history_control, history_save, history_size, history_timestamp_format_string.

: val = history_size () ¶

: old_val = history_size (new_val) ¶

Запрос или установка внутренней переменной, которая определяет количество записей для хранения в файле истории.

Значение по умолчанию — 1000, но может быть переопределено переменной окружения OCTAVE_HISTSIZE.

См. также: history_file, history_timestamp_format_string, history_save.

: val = history_timestamp_format_string () ¶

: old_val = history_timestamp_format_string (new_val) ¶

: history_timestamp_format_string (new_val, "local") ¶

Запрос или установка внутренней переменной, которая определяет строку формата для строки комментария, записываемой в файл истории при завершении Octave.

Строка формата передается в strftime. Значение по умолчанию —

"# Octave VERSION, %a %b %d %H:%M:%S %Y %Z <USER@HOST>"

При вызове изнутри функции с параметром "local", переменная изменяется локально для функции и всех вызываемых подпрограмм. Исходное значение переменной восстанавливается при выходе из функции.

См. также: strftime, history_file, history_size, history_save.

: val = EDITOR () ¶

: old_val = EDITOR (new_val) ¶

: EDITOR (new_val, "local") ¶

Запрос или установка внутренней переменной, которая определяет текстовый редактор по умолчанию.

Значение по умолчанию берется из переменной окружения EDITOR при запуске Octave. Если переменная окружения не инициализирована, EDITOR будет установлено в "emacs".

При вызове изнутри функции с параметром "local", переменная изменяется локально для функции и всех вызываемых подпрограмм. Исходное значение переменной восстанавливается при выходе из функции.

См. также: edit, edit_history.