RealmCollection

쿼리와 일치하는 첫 번째 객체의 인덱스를 반환하거나, 일치하는 객체가 없는 경우 nil 을 반환합니다.

이는 정렬된 collection에만 적용되며 collection이 정렬되지 않으면 중단됩니다.

• 사용법:

  obj.index(matching: { $0.fooCol < 456 })
  

지정된 조건자와 일치하는 첫 번째 객체의 인덱스를 반환하거나 일치하는 객체가 없는 경우 nil 를 반환합니다.

컬렉션에서 지정된 조건자와 일치하는 모든 객체를 포함하는 Results 를 반환합니다.

collection이 변경될 때마다 호출될 블록을 등록합니다.

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

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

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

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

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

let dogs = realm.objects(Dog.self)
print("dogs.count: \(dogs?.count)") // => 0
let token = dogs.observe { changes in
    switch changes {
    case .initial(let dogs):
        // Will print "dogs.count: 1"
        print("dogs.count: \(dogs.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 token = dogs.observe(keyPaths: [\Dog.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:
        // ...
    }
}
// end of run loop execution context

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

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

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

collection이 변경될 때마다 호출될 블록을 등록합니다.

블록은 collection의 초기 버전과 함께 비동기적으로 호출된 다음, collection의 객체 또는 collection에 있는 객체를 변경하는 각 쓰기 트랜잭션 (write transaction) 후에 다시 호출됩니다.

차단에 전달된 actor 매개변수는 이 함수에 전달되는 행위자입니다. 이 매개변수는 콜백을 행위자에 격리하는 데 필요합니다.

차단에 전달되는 change 매개변수는 collection 내에서 이전 알림 이후에 추가, 제거 또는 수정된 객체를 인덱스 형식으로 보고합니다. 변경 열거형의 collection 필드는 요청된 행위자로 격리되며 해당 행위자 내에서만 사용해도 안전합니다. 제공된 변경 정보에 대한 자세한 내용과 이를 사용하여 UITableView 을 업데이트하는 방법에 대한 예는 RealmCollectionChange 문서를 참조하세요.

초기 알림이 전달되면 collection이 완전히 평가되어 최신 상태로 유지되며 collection에 액세스할 때 차단 작업을 수행하지 않습니다. 이 보장은 알림이 전달되는 동일한 행위자에 대해 쓰기 트랜잭션(write transaction)을 수행하지 않는 경우에만 적용됩니다. 이 경우 다음 알림이 전달되기 전에 collection에 액세스하려면 쿼리를 다시 실행해야 할 수 있습니다.

알림은 지정된 행위자의 실행기로 전달됩니다. 알림을 즉시 전달할 수 없는 경우 여러 알림이 단일 알림으로 병합될 수 있습니다. 여기에는 초기 collection과의 알림이 포함될 수 있습니다. 초기 알림이 전달되기 전에 발생하는 쓰기는 변경 알림을 생성하지 않을 수 있습니다.

collection에서 객체를 추가, 제거 또는 할당하면 항상 알림이 생성됩니다. 기본적으로, collection이 연결되는 객체(및 해당하는 경우 해당 객체가 연결되는 객체)를 수정하면, collection의 해당 인덱스가 수정 중인 것으로 보고됩니다. 비어 있지 않은 키 경로 배열이 제공되는 경우 해당 키 경로를 수정해야만 객체가 수정된 것으로 표시됩니다. 예를 들면 다음과 같습니다.

class Dog: Object {
    @Persisted var name: String
    @Persisted var age: Int
    @Persisted var toys: List<Toy>
}

let dogs = realm.objects(Dog.self)
let token = await dogs.observe(keyPaths: ["name"], on: myActor) { actor, changes in
    switch changes {
    case .initial(let dogs):
        // Query has finished running and dogs can not be used without blocking
    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:
        // Can no longer happen but is left for backwards compatiblity
    }
}

• 관찰된 키 경로가 ["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() 을 호출합니다.

지정된 키 경로를 기반으로 고유 객체가 포함된 Results 을 반환합니다.

collection이 변경될 때마다 호출될 블록을 등록합니다.

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

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

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

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

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

let dogs = realm.objects(Dog.self)
print("dogs.count: \(dogs?.count)") // => 0
let token = dogs.observe { changes in
    switch changes {
    case .initial(let dogs):
        // Will print "dogs.count: 1"
        print("dogs.count: \(dogs.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 token = dogs.observe(keyPaths: [\Dog.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:
        // ...
    }
}
// end of run loop execution context

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

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

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

collection이 변경될 때마다 호출될 블록을 등록합니다.

블록은 collection의 초기 버전과 함께 비동기적으로 호출된 다음, collection의 객체 또는 collection에 있는 객체를 변경하는 각 쓰기 트랜잭션 (write transaction) 후에 다시 호출됩니다.

차단에 전달된 actor 매개변수는 이 함수에 전달되는 행위자입니다. 이 매개변수는 콜백을 행위자에 격리하는 데 필요합니다.

차단에 전달되는 change 매개변수는 collection 내에서 이전 알림 이후에 추가, 제거 또는 수정된 객체를 인덱스 형식으로 보고합니다. 변경 열거형의 collection 필드는 요청된 행위자로 격리되며 해당 행위자 내에서만 사용해도 안전합니다. 제공된 변경 정보에 대한 자세한 내용과 이를 사용하여 UITableView 을 업데이트하는 방법에 대한 예는 RealmCollectionChange 문서를 참조하세요.

초기 알림이 전달되면 collection이 완전히 평가되어 최신 상태로 유지되며 collection에 액세스할 때 차단 작업을 수행하지 않습니다. 이 보장은 알림이 전달되는 동일한 행위자에 대해 쓰기 트랜잭션(write transaction)을 수행하지 않는 경우에만 적용됩니다. 이 경우 다음 알림이 전달되기 전에 collection에 액세스하려면 쿼리를 다시 실행해야 할 수 있습니다.

알림은 지정된 행위자의 실행기로 전달됩니다. 알림을 즉시 전달할 수 없는 경우 여러 알림이 단일 알림으로 병합될 수 있습니다. 여기에는 초기 collection과의 알림이 포함될 수 있습니다. 초기 알림이 전달되기 전에 발생하는 쓰기는 변경 알림을 생성하지 않을 수 있습니다.

collection에서 객체를 추가, 제거 또는 할당하면 항상 알림이 생성됩니다. 기본적으로, collection이 연결되는 객체(및 해당하는 경우 해당 객체가 연결되는 객체)를 수정하면, collection의 해당 인덱스가 수정 중인 것으로 보고됩니다. 비어 있지 않은 키 경로 배열이 제공되는 경우 해당 키 경로를 수정해야만 객체가 수정된 것으로 표시됩니다. 예를 들면 다음과 같습니다.

class Dog: Object {
    @Persisted var name: String
    @Persisted var age: Int
    @Persisted var toys: List<Toy>
}

let dogs = realm.objects(Dog.self)
let token = await dogs.observe(keyPaths: [\.name], on: myActor) { actor, changes in
    switch changes {
    case .initial(let dogs):
        // Query has finished running and dogs can not be used without blocking
    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:
        // Can no longer happen but is left for backwards compatiblity
    }
}

• 관찰된 키 경로가 [\.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() 을 호출합니다.