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

4개의 인스턴스 ID가 반환되지만 해당 항목에 빈 인스턴스 ID가 있으므로 세 번째 줄은 비어 있습니다.

예제 2

주어진 항목 이름에 대해 각 인스턴스 ID의 대상체를 포함하는 JSON 배열을 반환합니다. 각 대상체에는 일치하는 항목의 이름, 인스턴스 ID, 값이 포함됩니다.

복사

변수 설정 [ $entryName ; 값: "com.claris.myaddon.theme" ]
변수 설정 [ $entryArray ; 값: "[]" ]
변수 설정 [ $i ; 값: 1 ]

변수 설정 [ $instanceIDList ; 값: ListPersistentDataIDs ( $entryName ) ]

변수 설정 [ $totalInstances ; 값: ValueCount ( $instanceIDList ) ]

Loop [ Flush: Always ]
  Exit Loop If [ $i > $totalInstances ]
  
  변수 설정 [ $currentInstanceID ; 값: GetValue ( $instanceIDList ; $i ) ]
  변수 설정 [ $entryValue ; 값: GetPersistentData ( $entryName ; $currentInstanceID ) ]
  
  변수 설정 [ $entryObject ; 값: "{}" ]
  변수 설정 [ $entryObject ; 값: JSONSetElement ( $entryObject ; "name" ; $entryName ; JSONString ) ]
  변수 설정 [ $entryObject ; 값: JSONSetElement ( $entryObject ; "instanceID" ; $currentInstanceID ; JSONString ) ]
  변수 설정 [ $entryObject ; 값: JSONSetElement ( $entryObject ; "value" ; $entryValue ; JSONString ) ]
  
  변수 설정 [ $entryArray ; 값: JSONSetElement ( $entryArray ; "[+]" ; $entryObject ; JSONObject ) ]
  
  변수 설정 [ $i ; 값: $i + 1 ]
End Loop

사용자 설정 대화상자 보기 [ JSONFormatElements ( $entryArray ) ]

결과 배열 예제:

복사

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