Map

지도를 managed Realm이거나 지도가 관리되지 않는 경우 nil 입니다.

지도에 더 이상 액세스할 수 없는지 여부를 나타냅니다.

이 맵의 모든 키를 반환합니다.

이 맵의 모든 값을 반환합니다.

Value 유형의 Realm 모델 객체를 보유하는 Map 을 만듭니다.

이 맵에 있는 키-값 쌍의 수를 반환합니다.

지정된 키에 대해 맵에 저장된 값을 업데이트하거나 키가 존재하지 않는 경우 새 키-값 쌍을 추가합니다.

결합 클로저를 사용하여 중복 키의 값을 결정하고, 지정된 사전을 이 맵에 병합합니다.

dictionary 에 이 지도에 이미 있는 키가 포함되어 있으면 현재 지도에 있는 값과 사전에 있는 값을 사용하여 combine 가 호출됩니다. 클로저가 반환한 값은 해당 키의 맵에 저장됩니다.

결합 클로저를 사용하여 중복 키의 값을 결정하고, 지정된 맵을 이 맵에 병합합니다.

other 에 이 지도에 이미 있는 키가 포함되어 있으면 현재 지도에 있는 값과 다른 지도에 있는 값을 사용하여 combine 가 호출됩니다. 클로저가 반환한 값은 해당 키의 맵에 저장됩니다.

키가 지도에 존재하는 경우에만 지정된 키와 관련 객체를 제거합니다. 키가 존재하지 않으면 맵이 수정되지 않습니다.

지도에서 모든 객체를 제거합니다. 객체는 해당 객체를 managed Realm에서 제거되지 않습니다.

주어진 키에 대한 값을 반환하거나, 할당에 아래 첨자를 사용하는 경우 키의 값을 설정합니다.

지정된 키가 지도에 있는 경우 해당 키에 대한 AnyObject 유형을 반환합니다.

지정된 키가 지도에 있는 경우 해당 키에 대한 Value 유형을 반환합니다.

키-값 코딩을 사용할 때 키는 문자열이어야 합니다.

지정된 키가 지도에 있는 경우 해당 키에 대한 Value 유형을 반환합니다.

지정된 키-값 쌍을 맵에 추가하거나 지정된 키가 이미 존재하는 경우 업데이트합니다.

맵에서 지정된 술어와 일치하는 모든 값을 포함하는 Results 을 반환합니다.

지정된 쿼리와 지도에서 일치하는 모든 값을 포함하는 Results 를 반환합니다.

• 사용법:

  myMap.where {
  ($0.fooCol > 5) && ($0.barCol == "foobar")
  }
  

맵에 포함된 키-값 쌍이 지정된 조건자를 충족하는지 여부를 나타내는 부울 값을 반환합니다.

지도에 있지만 정렬된 객체를 포함하는 Results 를 반환합니다.

객체는 해당 값을 기준으로 정렬됩니다. 예를 들어, Date의 지도를 최신 항목부터 가장 오래된 것까지 정렬하려면 dates.sorted(ascending: true) 호출할 수 있습니다.

지도에 있지만 정렬된 객체를 포함하는 Results 를 반환합니다.

객체는 지정된 키 경로의 값을 기준으로 정렬됩니다. 예를 들어, Student의 age 속성을 기준으로 가장 어린 것부터 가장 오래된 것까지 지도를 정렬하려면 students.sorted(byKeyPath: "age", ascending: true) 를 호출할 수 있습니다.

지도에 있지만 정렬된 객체를 포함하는 Results 를 반환합니다.

collection의 모든 객체 중 지정된 속성의 최소값(최저)을 반환하거나 지도가 비어 있는 경우 nil 를 반환합니다.

collection의 모든 객체 중 지정된 속성의 최대값(가장 높은 값)을 반환하거나, 지도가 비어 있는 경우 nil 를 반환합니다.

collection에 있는 객체에 지정된 속성의 합계를 반환하거나 지도가 비어 있는 경우 nil 를 반환합니다.

collection의 모든 객체에 대한 지정된 속성의 평균값을 반환하거나 map이 비어 있는 경우 nil 를 반환합니다.

지도가 변경될 때마다 호출될 블록을 등록합니다.

블록은 초기 맵과 비동기적으로 호출된 다음, 맵의 키나 값을 변경하는 각 쓰기 트랜잭션(write transaction) 후에 다시 호출됩니다.

블록에 전달되는 change 매개변수는 각 쓰기 트랜잭션(write transaction) 중에 추가, 제거 또는 수정된 키-값 쌍을 맵 내의 키 형식으로 보고합니다.

대기열이 제공되지 않으면 표준 이벤트 루프를 통해 알림이 전달되므로 이벤트 루프가 다른 활동에 의해 차단되는 동안에는 알림을 전달할 수 없습니다. 대기열이 제공되면 대신 해당 대기열로 알림이 전달됩니다. 알림을 즉시 전달할 수 없는 경우 여러 알림이 단일 알림으로 병합될 수 있습니다. 여기에는 초기 collection에 대한 알림이 포함될 수 있습니다.

예를 들어 다음 코드는 알림 차단을 추가한 직후 쓰기 트랜잭션(write transaction)을 수행하므로 초기 알림이 먼저 전달될 기회가 없습니다. 결과적으로 초기 알림에는 쓰기 트랜잭션(write transaction) 후 Realm의 상태가 반영됩니다.

let myStringMap = myObject.stringMap
print("myStringMap.count: \(myStringMap?.count)") // => 0
let token = myStringMap.observe { changes in
    switch changes {
    case .initial(let myStringMap):
        // Will print "myStringMap.count: 1"
        print("myStringMap.count: \(myStringMap.count)")
       print("Dog Name: \(myStringMap["nameOfDog"])") // => "Rex"
        break
    case .update:
        // Will not be hit in this example
        break
    case .error:
        break
    }
}
try! realm.write {
    myStringMap["nameOfDog"] = "Rex"
}

키 경로를 지정하지 않으면 모든 객체 속성과 중첩되고 연결된 객체의 속성에 대해 삽입, 수정 또는 삭제할 때 차단이 실행됩니다. 하나 이상의 키 경로가 제공되면 제공된 키 경로에서만 발생하는 변경에 대해 차단이 호출됩니다. 예를 들어 다음과 같은 경우입니다.

class Dog: Object {
    @Persisted var name: String
    @Persisted var age: Int
    @Persisted var toys: List<Toy>
}
// ...
let dogs = myObject.mapOfDogs
let token = dogs.observe(keyPaths: ["name"]) { changes in
    switch changes {
    case .initial(let dogs):
       // ...
    case .update:
       // This case is hit:
       // - after the token is initialized
       // - when the name property of an object in the
       // collection is modified
       // - when an element is inserted or removed
       //   from the collection.
       // This block is not triggered:
       // - when a value other than name is modified on
       //   one of the elements.
    case .error:
        // ...
    }
}

• 관찰된 키 경로가 ["toys.brand"] 인 경우 collection 요소의 toys 목록을 삽입하거나 삭제하면 trigger 됩니다. 이 collection의 Dog 에 연결된 Toy 의 brand 값을 변경하면 차단이 trigger됩니다. 이 collection의 Dog 에 연결된 Toy 에서 brand 이외의 값을 변경해도 차단이 trigger되지 않습니다. 관찰 중인 Dog 유형 collection을 삽입하거나 제거하면 trigger 알림이 됩니다.

• 위의 예에서 ["toys"] 키 경로를 관찰한 경우 collection의 모든 요소에 대한 toys 목록을 삽입, 삭제 또는 수정하면 trigger가 됩니다. 이 컬렉션의 Dog 에 연결된 Toy 의 값을 변경해도 차단이 트리거 되지 않습니다 . 관찰 중인 Dog 유형 collection을 삽입하거나 제거해도 알림이 trigger됩니다.

블록에 업데이트를 전송하려는 한 반환된 토큰을 보관해야 합니다. 업데이트 수신을 중지하려면 토큰에서 invalidate() 을 호출합니다.

지도가 변경될 때마다 호출될 블록을 등록합니다.

블록은 초기 맵이 있는 행위자에 대해 비동기적으로 호출된 다음, 맵에 있는 키나 객체의 값을 변경하는 각 쓰기 트랜잭션(write transaction) 후에 다시 호출됩니다.

블록에 전달되는 change 매개변수는 각 쓰기 트랜잭션(write transaction) 중에 추가, 제거 또는 수정된 키-값 쌍을 맵 내의 키 형식으로 보고합니다.

알림은 해당 행위자 실행기의 지정된 행위자와 격리된 함수에 전달됩니다. 행위자가 차단 작업을 수행하는 경우 여러 알림이 단일 알림으로 병합될 수 있습니다. 여기에는 초기 collection에 대한 알림이 포함될 수 있으며, 초기 알림이 전달된 후에 발생하는 쓰기에 대해서만 변경 사항이 보고됩니다.

키 경로를 지정하지 않으면 모든 객체 속성과 중첩되고 연결된 객체의 속성에 대해 삽입, 수정 또는 삭제할 때 차단이 실행됩니다. 하나 이상의 키 경로가 제공되면 제공된 키 경로에서만 발생하는 변경에 대해 차단이 호출됩니다. 예를 들어 다음과 같은 경우입니다.

class Dog: Object {
    @Persisted var name: String
    @Persisted var age: Int
    @Persisted var toys: List<Toy>
}
// ...
let dogs = myObject.mapOfDogs
let token = dogs.observe(keyPaths: ["name"], on: actor) { actor, changes in
    switch changes {
    case .initial(let dogs):
        // ...
    case .update:
        // This case is hit:
        // - after the token is initialized
        // - when the name property of an object in the collection is modified
        // - when an element is inserted or removed from the collection.
        // This block is not triggered:
        // - when a value other than name is modified on one of the elements.
    case .error:
        // No longer possible and left for backwards compatibility
    }
}

• 관찰된 키 경로가 ["toys.brand"] 인 경우 collection 요소의 toys 목록을 삽입하거나 삭제하면 trigger 됩니다. 이 collection의 Dog 에 연결된 Toy 의 brand 값을 변경하면 차단이 trigger됩니다. 이 collection의 Dog 에 연결된 Toy 에서 brand 이외의 값을 변경해도 차단이 trigger되지 않습니다. 관찰 중인 Dog 유형 collection을 삽입하거나 제거하면 trigger 알림이 됩니다.
• 위의 예에서 ["toys"] 키 경로를 관찰한 경우 collection의 모든 요소에 대한 toys 목록을 삽입, 삭제 또는 수정하면 trigger가 됩니다. 이 컬렉션의 Dog 에 연결된 Toy 의 값을 변경해도 차단이 트리거 되지 않습니다 . 관찰 중인 Dog 유형 collection을 삽입하거나 제거해도 알림이 trigger됩니다.

블록에 업데이트를 전송하려는 한 반환된 토큰을 보관해야 합니다. 업데이트 수신을 중지하려면 토큰에서 invalidate() 을 호출합니다.

지도가 변경될 때마다 호출될 블록을 등록합니다.

블록은 초기 맵이 있는 행위자에 대해 비동기적으로 호출된 다음, 맵에 있는 키나 객체의 값을 변경하는 각 쓰기 트랜잭션(write transaction) 후에 다시 호출됩니다.

블록에 전달되는 change 매개변수는 각 쓰기 트랜잭션(write transaction) 중에 추가, 제거 또는 수정된 키-값 쌍을 맵 내의 키 형식으로 보고합니다.

알림은 해당 행위자 실행기의 지정된 행위자와 격리된 함수에 전달됩니다. 행위자가 차단 작업을 수행하는 경우 여러 알림이 단일 알림으로 병합될 수 있습니다. 여기에는 초기 collection에 대한 알림이 포함될 수 있으며, 초기 알림이 전달된 후에 발생하는 쓰기에 대해서만 변경 사항이 보고됩니다.

제공된 키 경로에서만 발생하는 변경에 대해 차단이 호출됩니다. 예를 들어 다음과 같은 경우입니다.

class Dog: Object {
    @Persisted var name: String
    @Persisted var age: Int
    @Persisted var toys: List<Toy>
}
// ...
let dogs = myObject.mapOfDogs
let token = dogs.observe(keyPaths: [\.name], on: actor) { actor, changes in
    switch changes {
    case .initial(let dogs):
        // ...
    case .update:
        // This case is hit:
        // - after the token is initialized
        // - when the name property of an object in the collection is modified
        // - when an element is inserted or removed from the collection.
        // This block is not triggered:
        // - when a value other than name is modified on one of the elements.
    case .error:
        // No longer possible and left for backwards compatibility
    }
}

• 관찰된 키 경로가 [\.toys.brand] 인 경우 collection 요소의 toys 목록을 삽입하거나 삭제하면 trigger 됩니다. 이 collection의 Dog 에 연결된 Toy 의 brand 값을 변경하면 차단이 trigger됩니다. 이 collection의 Dog 에 연결된 Toy 에서 brand 이외의 값을 변경해도 차단이 trigger되지 않습니다. 관찰 중인 Dog 유형 collection을 삽입하거나 제거하면 trigger 알림이 됩니다.
• 위의 예에서 [\.toys] 키 경로를 관찰한 경우 collection의 모든 요소에 대한 toys 목록을 삽입, 삭제 또는 수정하면 trigger가 됩니다. 이 컬렉션의 Dog 에 연결된 Toy 의 값을 변경해도 차단이 트리거 되지 않습니다 . 관찰 중인 Dog 유형 collection을 삽입하거나 제거해도 알림이 trigger됩니다.

블록에 업데이트를 전송하려는 한 반환된 토큰을 보관해야 합니다. 업데이트 수신을 중지하려면 토큰에서 invalidate() 을 호출합니다.

Map 이(가) 동결되었는지 여부를 나타냅니다.

동결된 Map은 변경할 수 없으며 모든 스레드에서 액세스할 수 있습니다. 동결된 Map은 관리되는 라이브 Map 에서 -freeze 를 호출하여 생성됩니다. 관리되지 않는 Map는 동결되지 않습니다.

Map 의 동결(불변) 스냅샷을 반환합니다.

동결된 사본은 변경할 수 없는 Map 이며 이 Map 에는 현재 포함되어 있는 것과 동일한 데이터를 포함하지만 포함하는 Realm에 쓰기가 수행될 때 업데이트되지 않습니다. 라이브 Map와 달리 동결된 Map은 모든 스레드에서 액세스할 수 있습니다.

이 동결된 Map 의 라이브 버전을 반환합니다.

이 메서드는 동일한 동결된 Map 의 라이브 사본에 대한 참고를 확인합니다. 라이브 Map 에서 호출되면 자체를 반환합니다.

지도에 포함된 객체에 대한 사람이 읽을 수 있는 설명을 반환합니다.

collection이 변경될 때마다 Void를 방출하는 출판사입니다.

이름과 달리 실제로 collection 변경된 후에 방출합니다.

Map 의 연속 요소를 생성하는 RLMMapIterator 을 반환합니다.

맵을 SingleMapEntry 시퀀스 대신 (key: Key, value: Value) 시퀀스로 만드는 맵용 어댑터입니다.

이 맵을 다음 시퀀스로 반환합니다. (key: Key, value: Value)