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.

-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 позволяет это).

Значение по умолчанию — ~/.octave_hist, но может быть переопределено переменной среды 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.