35.5 Пользовательские настройки

: val = getpref ("group", "pref") ¶

: val = getpref ("group", "pref", default) ¶

: {val1, val2, …} = getpref ("group", {"pref1", "pref2", …}) ¶

: prefstruct = getpref ("group") ¶

: prefstruct = getpref () ¶

Возвращает значение настройки, соответствующее имени настройки pref в группе настроек group.

Имя группы настроек должно быть строкой.

Если pref не существует в group, а default указано, создаёт настройку со значением default и возвращает default.

Настройка pref может быть строкой или ячейковым массивом строк. Если это ячейковый массив строк, возвращается ячейковый массив настроек.

Соответствующее значение по умолчанию default может быть любым значением Octave, например, double, struct, ячейковый массив, объект и т. д. Или, если pref является ячейковым массивом строк, default должен быть ячейковым массивом значений с таким же размером, как и pref.

Если ни pref, ни default не указаны, возвращается структура настроек для группы настроек group.

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

См. также: addpref, setpref, ispref, rmpref.

: setpref ("group", "pref", val) ¶

: setpref ("group", {"pref1", "pref2", …}, {val1, val2, …}) ¶

Устанавливает настройку pref на заданное значение val в указанной группе настроек group.

Имя группы настроек должно быть строкой.

Настройка pref может быть строкой или ячейковым массивом строк.

Соответствующее значение val может быть любым значением Octave, например, double, struct, ячейковый массив, объект и т. д. Или, если pref является ячейковым массивом строк, val должен быть ячейковым массивом значений с таким же размером, как и pref.

Если указанная настройка или группа не существует, она добавляется.

См. также: addpref, getpref, ispref, rmpref.

: addpref ("group", "pref", val) ¶

: addpref ("group", {"pref1", "pref2", …}, {val1, val2, …}) ¶

Добавляет настройку pref и связанное значение val в указанную группу настроек group.

Имя группы настроек должно быть строкой.

Настройка pref может быть строкой или ячейковым массивом строк. Если настройка уже существует, будет выдано сообщение об ошибке.

Соответствующее значение val может быть любым значением Octave, например, double, struct, ячейковый массив, объект и т. д. Или, если pref является ячейковым массивом строк, val должен быть ячейковым массивом значений с таким же размером, как и pref.

См. также: setpref, getpref, ispref, rmpref.

: rmpref ("group", "pref") ¶

: rmpref ("group", {"pref1", "pref2", …}) ¶

: rmpref ("group") ¶

Удаляет указанную настройку pref из группы настроек group.

Имя группы настроек должно быть строкой.

Настройка pref может быть строкой или ячейковым массивом строк.

Если pref не указан, удаляется группа настроек group.

Ошибка возникает при попытке удалить несуществующую настройку или группу.

См. также: addpref, ispref, setpref, getpref.

: ispref ("group", "pref") ¶

: ispref ("group", {"pref1", "pref2", …}) ¶

: ispref ("group") ¶

Возвращает true, если указанная настройка pref существует в группе настроек group.

Имя группы настроек должно быть строкой.

Настройка pref может быть строкой или ячейковым массивом строк.

Если pref не указан, возвращает true, если группа настроек group существует.

См. также: getpref, addpref, setpref, rmpref.

: prefdir ¶

: prefdir (1) ¶

: dir = prefdir ¶

Возвращает каталог, содержащий настройки Octave.

Примеры:

Отображение каталога настроек

prefdir

Переход в папку настроек

cd (prefdir)

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

См. также: getpref, setpref, addpref, rmpref, ispref.

: preferences ¶

Отображает окно диалога настроек Octave в графическом интерфейсе пользователя.