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.