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.