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.

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

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

: tf = ispref ("group") ¶

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

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

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

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

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

: dir = prefdir ¶

: dir = prefdir (1) ¶

Возвращает каталог, в котором хранятся настройки Octave.

Примеры:

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

prefdir

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

cd (prefdir)

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

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

: preferences ¶

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