---

35.5 用户定义的首选项¶

 

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

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

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

prefstruct = getpref ("group") ¶

prefstruct = getpref () ¶

返回首选项组 group 中指定首选项 pref 对应的值。

命名的首选项组必须是字符串。

如果 group 中不存在 pref，且指定了 default，则创建该首选项并将值设为 default，然后返回 default。

首选项 pref 可以是字符串或字符串元胞数组。如果是一个字符串元胞数组，则返回一个首选项值的元胞数组。

对应的默认值 default 可以是任何 Octave 值，例如双精度浮点数、结构体、元胞数组、对象等。或者，如果 pref 是一个字符串元胞数组，则 default 必须是一个与 pref 大小相同的值元胞数组。

如果既未指定 pref 也未指定 default，则返回首选项组 group 的首选项结构体。

如果未指定任何参数，则返回一个包含所有首选项组及其值的结构体。

另请参阅： addpref，setpref，ispref，rmpref。

 

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

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

在命名的首选项组 group 中，将首选项 pref 设置为给定值 val。

命名的首选项组必须是字符串。

首选项 pref 可以是字符串或字符串元胞数组。

对应的值 val 可以是任何 Octave 值，例如双精度浮点数、结构体、元胞数组、对象等。或者，如果 pref 是一个字符串元胞数组，则 val 必须是一个与 pref 大小相同的值元胞数组。

如果指定的首选项或组不存在，则会自动添加。

另请参阅： addpref，getpref，ispref，rmpref。

 

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

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

向指定的首选项组 group 中添加首选项 pref 及其关联值 val。

命名的首选项组必须是字符串。

首选项 pref 可以是字符串或字符串元胞数组。如果该首选项已存在，则会报错。

对应的值 val 可以是任何 Octave 值，例如双精度浮点数、结构体、元胞数组、对象等。或者，如果 pref 是一个字符串元胞数组，则 val 必须是一个与 pref 大小相同的值元胞数组。

另请参阅： setpref，getpref，ispref，rmpref。

 

rmpref ("group", "pref") ¶

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

rmpref ("group") ¶

从首选项组 group 中删除首选项 pref。

命名的首选项组必须是字符串。

首选项 pref 可以是字符串或字符串元胞数组。

如果未指定 pref，则删除整个首选项组 group。

尝试删除不存在的首选项或组将会报错。

另请参阅： addpref，ispref，setpref，getpref。

 

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

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

tf = ispref ("group") ¶

如果首选项组 group 中存在指定的首选项 pref，则返回 true。

命名的首选项组必须是字符串。

首选项 pref 可以是字符串或字符串元胞数组。

如果未指定 pref，则在首选项组 group 存在时返回 true。

另请参阅： getpref，addpref，setpref，rmpref。

 

dir = prefdir ¶

dir = prefdir (1) ¶

返回保存 Octave 首选项的目录。

示例：

显示首选项目录

prefdir

切换到首选项文件夹

cd (prefdir)

如果使用参数调用，则在首选项目录不存在时创建该目录。

另请参阅： getpref，setpref，addpref，rmpref，ispref。

 

preferences ¶

显示 Octave 的 GUI 首选项对话框窗口。