ListPersistentDataIDs

Retorna uma lista de IDs de instância para as entradas com o nome especificado no armazenamento de dados persistente.

Formato 

ListPersistentDataIDs ( nome )

Parâmetros

nome - uma expressão de texto que especifica o nome de uma entrada a ser pesquisada.

Tipo de dados retornado 

texto

Originada na versão 

26.0

Descrição

A lista de IDs de instância separados por quebras de linha retornados por esta função é útil para descobrir quais instâncias existem para um determinado nome. Consulte Sobre o armazenamento de dados persistente para obter mais informações.

Se não existirem entradas com o nome especificado, esta função retornará um valor vazio.

Notas

  • Os IDs de instância são retornados na ordem em que as entradas foram criadas.

  • Se uma entrada correspondente foi armazenada com um ID de instância vazio, um valor vazio será incluído na lista.

  • Use com a função Função GetPersistentData para recuperar valores para cada instância.

Exemplo 1

ListPersistentDataIDs ( "com.example.addon.script" ) lista todos os IDs de instância para entradas que têm esse nome. Por exemplo:

Copiar 
38EA3124-9CFD-4490-A634-A0A72A613145
E53DE16C-282E-44B0-BDB8-D59B15419D1B

B2F4C8D1-5A3E-4F9B-8C7D-1E6A9B4D2F5C

Quatro IDs de instância são retornados, mas a terceira linha está em branco porque essa entrada tem um ID de instância vazio.

Exemplo 2

Para um determinado nome de entrada, retorna uma matriz JSON contendo um objeto para cada ID de instância. Cada objeto inclui o nome, o ID de instância e o valor das entradas correspondentes.

Copiar 
Definir variável [ $entryName ; Valor: "com.claris.myaddon.theme" ]
Definir variável [ $entryArray ; Valor: "[]" ]
Definir variável [ $i ; Valor: 1 ]

Definir variável [ $instanceIDList ; Valor: ListPersistentDataIDs ( $entryName ) ]

Definir variável [ $totalInstances ; Valor: ValueCount ( $instanceIDList ) ]

Loop [Flush: Sempre ]
  Exit Loop If [ $i > $totalInstances ]
  
  Definir variável [ $currentInstanceID ; Valor: GetValue ( $instanceIDList ; $i ) ]
  Definir variável [ $entryValue ; Valor: GetPersistentData ( $entryName ; $currentInstanceID ) ]
  
  Definir variável [ $entryObject ; Valor: "{}" ]
  Definir variável [ $entryObject ; Valor: JSONSetElement ( $entryObject ; "name" ; $entryName ; JSONString ) ]
  Definir variável [ $entryObject ; Valor: JSONSetElement ( $entryObject ; "instanceID" ; $currentInstanceID ; JSONString ) ]
  Definir variável [ $entryObject ; Valor: JSONSetElement ( $entryObject ; "value" ; $entryValue ; JSONString ) ]
  
  Definir variável [ $entryArray ; Valor: JSONSetElement ( $entryArray ; "[+]" ; $entryObject ; JSONObject ) ]
  
  Definir variável [ $i ; Valor: $i + 1 ]
End Loop

Mostrar caixa de diálogo personalizada [ JSONFormatElements ( $entryArray ) ]

Exemplo da matriz resultante:

Copiar 
[
  {
    "instanceID" : "38EA3124-9CFD-4490-A634-A0A72A613145",
    vnome" : "com.claris.myaddon.theme",
    "valor" : "Escuro"
  },
  {
    "instanceID" : "E53DE16C-282E-44B0-BDB8-D59B15419D1B",
    "nome" : "com.claris.myaddon.theme",
    "valor" : "Escuro"
  },
  {
    "instanceID" : "",
    "nome" : "com.claris.myaddon.theme",
    "valor" : "Claro"
  },
  {
    "instanceID" : "B2F4C8D1-5A3E-4F9B-8C7D-1E6A9B4D2F5C",
    "nome" : "com.claris.myaddon.theme",
    "valor" : "Escuro"
  }
]

Tópicos relacionados