ListPersistentDataIDs

Devuelve una lista de ID de instancia para las entradas con el nombre especificado en el almacén de datos persistentes.

Formato 

ListPersistentDataIDs ( name )

Parámetros 

name: una expresión de texto que especifica el nombre de una entrada a buscar.

Tipo de datos devuelto 

texto

Se origina en 

26.0

Descripción 

La lista de ID de instancias delimitada por retornos de carro que devuelve esta función es útil para descubrir qué instancias existen para un nombre determinado. Consulte Acerca del almacén de datos persistentes para obtener más información.

Si no existen entradas con el nombre especificado, esta función devuelve un valor vacío.

Notas 

  • Los ID de instancia se devuelven en el orden en que se crearon las entradas.

  • Si se almacenó una entrada coincidente con un ID de instancia vacío, se incluye un valor vacío en la lista.

  • Úselo con la función GetPersistentData para recuperar valores para cada instancia.

Ejemplo 1 

ListPersistentDataIDs ( "com.example.addon.script" ) enumera todos los ID de instancia para las entradas que tienen este nombre. Por ejemplo:

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

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

Se devuelven cuatro ID de instancia, pero la tercera línea está en blanco porque esa entrada tiene un ID de instancia vacío.

Ejemplo 2 

Para un nombre de entrada dado, devuelve una matriz JSON que contiene un objeto para cada ID de instancia. Cada objeto incluye el nombre, el ID de la instancia y el valor de las entradas coincidentes.

Copiar 
Establecer variable [ $entryName ; Valor: "com.claris.myaddon.theme" ]
Establecer variable [ $entryArray ; Valor: "[]" ]
Establecer variable [ $i ; Valor: 1 ]

Establecer variable [ $instanceIDList ; Valor: ListPersistentDataIDs ( $entryName ) ]

Establecer variable [ $totalInstances ; Valor: ValueCount ( $instanceIDList ) ]

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

Mostrar cuadro de diálogo predeterminado [ JSONFormatElements ( $entryArray ) ]

Ejemplo de la matriz resultante:

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

Temas relacionados