RealmSectionedResult

섹션화된 결과 컬렉션이 변경될 때마다 호출될 블록을 등록합니다.

차단은 초기 섹션화된 결과 컬렉션과 비동기적으로 호출된 다음 섹션화된 결과 컬렉션의 객체 또는 섹션화된 결과 컬렉션에 있는 객체를 변경하는 각 쓰기 트랜잭션(write transaction) 후에 다시 호출됩니다.

블록에 전달되는 change 매개변수는 각 쓰기 트랜잭션(write transaction) 중에 추가, 제거 또는 수정된 객체를 collection 내에서 인덱스 형식으로 보고합니다. 제공된 변경 정보에 대한 자세한 내용과 이를 사용하여 UITableView 을 업데이트하는 방법에 대한 예는 SectionedResultsChange 문서를 참조하세요.

차단이 호출되는 시점에 collection은 완전히 평가되고 최신 상태이므로 동일한 스레드에서 쓰기 트랜잭션 (write transaction)을 수행하지 않거나 명시적으로 realm.refresh() 호출하지 않는 한 해당 스레드에 액세스하면 차단이 수행되지 않습니다. 일.

대기열이 지정되지 않으면 표준 런 루프를 통해 알림이 전달되므로 다른 활동에 의해 런 루프가 차단된 동안에는 알림을 전달할 수 없습니다. 대기열이 지정되면 대신 해당 대기열로 알림이 전달됩니다. 알림을 즉시 전달할 수 없는 경우 여러 알림이 단일 알림으로 통합될 수 있습니다. 여기에는 초기 섹션 결과 컬렉션에 대한 알림이 포함될 수 있습니다.

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

let dogs = realm.objects(Dog.self)
let sectionedResults = dogs.sectioned(by: \.age, ascending: true)
print("sectionedResults.count: \(sectionedResults?.count)") // => 0
let token = sectionedResults.observe { changes in
    switch changes {
    case .initial(let sectionedResults):
        // Will print "sectionedResults.count: 1"
        print("sectionedResults.count: \(sectionedResults.count)")
        break
    case .update:
        // Will not be hit in this example
        break
    case .error:
        break
    }
}
try! realm.write {
    let dog = Dog()
    dog.name = "Rex"
    person.dogs.append(dog)
}
// end of run loop execution context

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

class Dog: Object {
    @Persisted var name: String
    @Persisted var age: Int
    @Persisted var toys: List<Toy>
}
// ...
let dogs = realm.objects(Dog.self)
let sectionedResults = dogs.sectioned(by: \.age, ascending: true)
let token = sectionedResults.observe(keyPaths: ["name"]) { changes in
    switch changes {
    case .initial(let sectionedResults):
       // ...
    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:
        // ...
    }
}
// end of run loop execution context

• 관찰된 키 경로가 ["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됩니다.

• 섹션 키 경로 속성 을 수정하여 객체 가 섹션에서 위치를 변경하거나 섹션이 완전히 변경되면 알림이 trigger 됩니다.

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

섹션화된 결과 컬렉션이 변경될 때마다 호출될 블록을 등록합니다.

차단은 초기 섹션화된 결과 컬렉션과 비동기적으로 호출된 다음 섹션화된 결과 컬렉션의 객체 또는 섹션화된 결과 컬렉션에 있는 객체를 변경하는 각 쓰기 트랜잭션(write transaction) 후에 다시 호출됩니다.

블록에 전달되는 change 매개변수는 각 쓰기 트랜잭션(write transaction) 중에 추가, 제거 또는 수정된 객체를 collection 내에서 인덱스 형식으로 보고합니다. 제공된 변경 정보에 대한 자세한 내용과 이를 사용하여 UITableView 을 업데이트하는 방법에 대한 예는 SectionedResultsChange 문서를 참조하세요.

차단이 호출되는 시점에 collection은 완전히 평가되고 최신 상태이므로 동일한 스레드에서 쓰기 트랜잭션 (write transaction)을 수행하지 않거나 명시적으로 realm.refresh() 호출하지 않는 한 해당 스레드에 액세스하면 차단이 수행되지 않습니다. 일.

대기열이 지정되지 않으면 표준 런 루프를 통해 알림이 전달되므로 다른 활동에 의해 런 루프가 차단된 동안에는 알림을 전달할 수 없습니다. 대기열이 지정되면 대신 해당 대기열로 알림이 전달됩니다. 알림을 즉시 전달할 수 없는 경우 여러 알림이 단일 알림으로 통합될 수 있습니다. 여기에는 초기 섹션 결과 컬렉션에 대한 알림이 포함될 수 있습니다.

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

let dogs = realm.objects(Dog.self)
let sectionedResults = dogs.sectioned(by: \.age, ascending: true)
print("sectionedResults.count: \(sectionedResults?.count)") // => 0
let token = sectionedResults.observe { changes in
    switch changes {
    case .initial(let sectionedResults):
        // Will print "sectionedResults.count: 1"
        print("sectionedResults.count: \(sectionedResults.count)")
        break
    case .update:
        // Will not be hit in this example
        break
    case .error:
        break
    }
}
try! realm.write {
    let dog = Dog()
    dog.name = "Rex"
    person.dogs.append(dog)
}
// end of run loop execution context

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

class Dog: Object {
    @Persisted var name: String
    @Persisted var age: Int
    @Persisted var toys: List<Toy>
}
// ...
let dogs = realm.objects(Dog.self)
let sectionedResults = dogs.sectioned(by: \.age, ascending: true)
let token = sectionedResults.observe(keyPaths: ["name"]) { changes in
    switch changes {
    case .initial(let sectionedResults):
       // ...
    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:
        // ...
    }
}
// end of run loop execution context

• 관찰된 키 경로가 ["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됩니다.

• 섹션 키 경로 속성 을 수정하여 객체 가 섹션에서 위치를 변경하거나 섹션이 완전히 변경되면 알림이 trigger 됩니다.

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