ListPersistentDataIDs
返回持久化数据存储中具有指定名称的条目的实例 ID 列表。
格式
ListPersistentDataIDs ( 名称 )
参数
名称 - 指定要搜索的条目名称的文本表达式。
返回的数据类型
文本
原始版本
26.0
说明
该函数返回的实例 ID 的回车符分隔列表对于发现给定名称存在哪些实例很有用。有关更多信息，请参阅关于持久化数据存储。
如果没有指定名称的条目，则此函数将返回一个空值。
注释
-
实例 ID 按条目的创建顺序返回。
-
如果匹配的条目存储了空的实例 ID，则列表中包含一个空值。
-
与 GetPersistentData函数一起使用来检索每个实例的值。
示例 1
ListPersistentDataIDs ( "com.example.addon.script" ) 列出具有此名称的条目的所有实例 ID。例如：
复制
38EA3124-9CFD-4490-A634-A0A72A613145
E53DE16C-282E-44B0-BDB8-D59B15419D1B
B2F4C8D1-5A3E-4F9B-8C7D-1E6A9B4D2F5C返回四个实例 ID，但第三行是空白的，因为该条目有一个空的实例 ID。
示例 2
针对给定的条目名称，返回包含每个实例 ID 对应对象的 JSON 数组。每个对象都包含匹配条目的名称、实例 ID 和值。
复制
设置变量 [ $entryName ; 值: "com.claris.myaddon.theme" ]
设置变量 [ $entryArray ; 值: "[]" ]
设置变量 [ $i ; 值: 1 ]
设置变量 [ $instanceIDList ; 值: ListPersistentDataIDs ( $entryName ) ]
设置变量 [ $totalInstances ; 值: ValueCount ( $instanceIDList ) ]
Loop [ 刷新: 始终 ]
Exit Loop If [ $i > $totalInstances ]
设置变量 [ $currentInstanceID ; 值: GetValue ( $instanceIDList ; $i ) ]
设置变量 [ $entryValue ; 值: GetPersistentData ( $entryName ; $currentInstanceID ) ]
设置变量 [ $entryObject ; 值: "{}" ]
设置变量 [ $entryObject ; 值: JSONSetElement ( $entryObject ; "名称" ; $entryName ; JSONString ) ]
设置变量 [ $entryObject ; 值: JSONSetElement ( $entryObject ; "实例 ID" ; $currentInstanceID ; JSONString ) ]
设置变量 [ $entryObject ; 值: JSONSetElement ( $entryObject ; "值" ; $entryValue ; JSONString ) ]
设置变量 [ $entryArray ; 值: JSONSetElement ( $entryArray ; "[+]" ; $entryObject ; JSONObject ) ]
设置变量 [ $i ; 值: $i + 1 ]
End Loop
显示自定义对话框 [ JSONFormatElements ( $entryArray ) ]结果数组的示例：
复制
[
{
"实例 ID" : "38EA3124-9CFD-4490-A634-A0A72A613145",
"名称" : "com.claris.myaddon.theme",
"值" : "Dark"
},
{
"实例 ID" : "E53DE16C-282E-44B0-BDB8-D59B15419D1B",
"名称" : "com.claris.myaddon.theme",
"值" : "Dark"
},
{
"实例 ID" : "",
"名称" : "com.claris.myaddon.theme",
"值" : "Light"
},
{
"实例 ID" : "B2F4C8D1-5A3E-4F9B-8C7D-1E6A9B4D2F5C",
"名称" : "com.claris.myaddon.theme",
"值" : "Dark"
}
]