ObjectChangesetWithToken

public class ObjectChangesetWithToken<O, T> : Publisher where O : RealmSwiftObject

A publisher which emits ObjectChange each time the observed object is modified

receive(on:) and subscribe(on:) can be called directly on this publisher, and calling .threadSafeReference() is only required if there is an intermediate transform. If subscribe(on:) is used, it should always be the first operation in the pipeline.

Create this publisher using the objectChangeset() function.

  • This publisher emits a ObjectChange indicating which object and which properties of that object have changed each time a Realm is refreshed after a write transaction which modifies the observed object.

    Declaration

    Swift

    public typealias Output = ObjectChange<O>
  • This publisher reports error via the .error case of ObjectChange.

    Declaration

    Swift

    public typealias Failure = Never
  • Specifies the scheduler on which to perform subscribe, cancel, and request operations.

    For Realm Publishers, this determines which queue the underlying change notifications are sent to. If receive(on:) is not used subsequently, it also will determine which queue elements received from the publisher are evaluated on. Currently only serial dispatch queues are supported, and the options: parameter is not supported.

    Declaration

    Swift

    public func subscribe<S>(on scheduler: S) -> ObjectChangesetWithToken<O, T> where S : Scheduler

    Parameters

    scheduler

    The serial dispatch queue to perform the subscription on.

    Return Value

    A publisher which subscribes on the given scheduler.

  • Specifies the scheduler on which to perform downstream operations.

    This differs from subscribe(on:) in how it is integrated with the autorefresh cycle. When using subscribe(on:), the subscription is performed on the target scheduler and the publisher will emit the collection during the refresh. When using receive(on:), the collection is then converted to a ThreadSafeReference and delivered to the target scheduler with no integration into the autorefresh cycle, meaning it may arrive some time after the refresh occurs.

    When in doubt, you probably want subscribe(on:)

    Declaration

    Swift

    public func receive<S>(on scheduler: S) -> DeferredHandoverObjectChangeset<ObjectChangesetWithToken, T, S> where O == T, S : Scheduler

    Parameters

    scheduler

    The serial dispatch queue to receive values on.

    Return Value

    A publisher which delivers values to the given scheduler.