RMSyncSubscriptionSet

Objective-C

@interface RLMSyncSubscriptionSet : NSObject <NSFastEnumeration>

Swift

@_nonSendable(_assumed) class RLMSyncSubscriptionSet : NSObject, NSFastEnumeration

RLMSyncSubscriptionSetRLMSyncSubscriptionのコレクションです。 これは、 RLMSyncSubscriptionを追加および削除するためのエントリ ポイントです。

  • サブスクライブセット内のサブスクライブの数。

    宣言

    Objective-C

    @property (readonly) NSUInteger count;

    Swift

    var count: UInt { get }
  • サブスクライブ セットに関連付けられているエラーを取得します。 サブスクリプション セットの現在の状態がRLMSyncSubscriptionStateErrorの場合、これは nil 以外になります。

    宣言

    Objective-C

    @property (nonatomic, readonly, nullable) NSError *error;

    Swift

    var error: (any Error)? { get }
  • サブスクライブ セットに関連付けられている状態を取得します。

    宣言

    Objective-C

    @property (nonatomic, readonly) RLMSyncSubscriptionState state;

    Swift

    var state: RLMSyncSubscriptionState { get }

バッチ更新サブスクライブ

  • ブロック内のサブスクリプションセットに対するすべてのトランザクション(追加/削除/アップデート)を同期的に実行します。これは、サーバーがこのサブスクリプションのコレクションに関連付けられているすべてのデータを確認して表示するのを待たずに、サブスクライブ トランザクションをコミットした後に返します。

    宣言

    Objective-C

    - (void)update:(nonnull void (^)(void))block;

    Swift

    func update(_ block: () -> Void)

    パラメーター

    block

    サブスクリプションセットに対して実行するアクションを含むブロック。

  • ブロック内のサブスクリプションセットへのトランザクション(追加/削除/アップデート)を同期的に実行します。 onCompleteブロックは、関連データがサーバーからダウンロードされるのを待った後に実行されます。

    宣言

    Objective-C

    - (void)update:(nonnull void (^)(void))block
        onComplete:(nullable void (^)(NSError *_Nullable))onComplete;

    Swift

    @_unsafeInheritExecutor func update(_ block: () -> Void) async throws

    パラメーター

    block

    サブスクリプションセットに対して実行するアクションを含むブロック。

    onComplete

    サーバーからのデータの同期時に呼び出されるブロック。 アップデートが成功した場合はブロックはnilと、それ以外の場合は問題を説明するエラーが渡されます。

  • ブロック内のサブスクリプションセットへのトランザクション(追加/削除/アップデート)を同期的に実行します。 onCompleteブロックは、関連データがサーバーからダウンロードされるのを待った後に実行されます。

    宣言

    Objective-C

    - (void)update:(nonnull void (^)(void))block
             queue:(nullable dispatch_queue_t)queue
        onComplete:(nonnull void (^)(NSError *_Nonnull))onComplete;

    Swift

    @_unsafeInheritExecutor func update(_ block: () -> Void, queue: dispatch_queue_t?, onComplete: @escaping (any Error) -> Void)

    パラメーター

    block

    サブスクリプションセットに対して実行するアクションを含むブロック。

    queue

    通知を送信するシリアル キュー。

    onComplete

    サーバーからのデータの同期時に呼び出されるブロック。 アップデートが成功した場合はブロックはnilと、それ以外の場合は問題を説明するエラーが渡されます。

検索サブスクライブ

  • 指定した名前でサブスクライブを検索します。

    宣言

    Objective-C

    - (nullable RLMSyncSubscription *)subscriptionWithName:(nonnull NSString *)name;

    Swift

    func subscription(withName name: String) -> RLMSyncSubscription?

    パラメーター

    name

    サブスクリプションを識別するために使用される名前。

    戻り値

    指定された名前のサブスクライブ。

  • 指定されたオブジェクト クラス名のクエリによってサブスクリプションを検索します。

    宣言

    Objective-C

    - (nullable RLMSyncSubscription *)
        subscriptionWithClassName:(nonnull NSString *)objectClassName
                            where:(nonnull NSString *)predicateFormat, ...;

    パラメーター

    objectClassName

    クエリされるモデル クラスのクラス名。

    predicateFormat

    述語形式の string 。オプションで、その後に変数の数の引数が続きます。

    戻り値

    指定されたクエリのサブスクライブ。

  • 指定されたオブジェクト クラス名のクエリによってサブスクリプションを検索します。

    宣言

    Objective-C

    - (nullable RLMSyncSubscription *)
        subscriptionWithClassName:(nonnull NSString *)objectClassName
                        predicate:(nonnull NSPredicate *)predicate;

    Swift

    func subscription(withClassName objectClassName: String, predicate: NSPredicate) -> RLMSyncSubscription?

    パラメーター

    objectClassName

    クエリされるモデル クラスのクラス名。

    predicate

    サーバー上のオブジェクトをフィルタリングするために使用される述語。

    戻り値

    指定されたクエリのサブスクライブ。

サブスクリプションを追加する

  • 書込み (write) サブスクライブ ブロックの最後にコミットされるとサーバーに送信されるサブスクリプションセットに新しいサブスクリプションを追加します。

    警告

    このメソッドは、書込み (write) サブスクライブ ブロック中にのみ呼び出されます。

    宣言

    Objective-C

    - (void)addSubscriptionWithClassName:(nonnull NSString *)objectClassName
                                   where:(nonnull NSString *)predicateFormat, ...;

    パラメーター

    objectClassName

    クエリされるモデル クラスのクラス名。

    predicateFormat

    述語形式の string 。オプションで、その後に変数の数の引数が続きます。

  • 書込み (write) サブスクライブ ブロックの最後にコミットされるとサーバーに送信されるサブスクリプションセットに新しいサブスクリプションを追加します。

    警告

    このメソッドは、書込み (write) サブスクライブ ブロック中にのみ呼び出されます。

    宣言

    Objective-C

    - (void)addSubscriptionWithClassName:(nonnull NSString *)objectClassName
                        subscriptionName:(nonnull NSString *)name
                                   where:(nonnull NSString *)predicateFormat, ...;

    パラメーター

    objectClassName

    クエリされるモデル クラスのクラス名。

    name

    サブスクリプションを識別するために使用される名前。

    predicateFormat

    述語形式の string 。オプションで、その後に変数の数の引数が続きます。

  • 書込み (write) サブスクライブ ブロックの最後にコミットされるとサーバーに送信されるサブスクリプションセットに新しいサブスクリプションを追加します。

    警告

    このメソッドは、書込み (write) サブスクライブ ブロック中にのみ呼び出されます。

    宣言

    Objective-C

    - (void)addSubscriptionWithClassName:(nonnull NSString *)objectClassName
                               predicate:(nonnull NSPredicate *)predicate;

    Swift

    func addSubscription(withClassName objectClassName: String, predicate: NSPredicate)

    パラメーター

    objectClassName

    クエリされるモデル クラスのクラス名。

    predicate

    サブスクライブのクエリを定義する述語。

  • 書込み (write) サブスクライブ ブロックの最後にコミットされるとサーバーに送信されるサブスクリプションセットに新しいサブスクリプションを追加します。

    警告

    このメソッドは、書込み (write) サブスクライブ ブロック中にのみ呼び出されます。

    宣言

    Objective-C

    - (void)addSubscriptionWithClassName:(nonnull NSString *)objectClassName
                        subscriptionName:(nullable NSString *)name
                               predicate:(nonnull NSPredicate *)predicate;

    Swift

    func addSubscription(withClassName objectClassName: String, subscriptionName name: String?, predicate: NSPredicate)

    パラメーター

    objectClassName

    クエリされるモデル クラスのクラス名。

    name

    サブスクリプションを識別するために使用される名前。

    predicate

    サブスクライブのクエリを定義する述語。

サブスクリプションの削除

  • 指定された名前のサブスクライブをサブスクライブセットから削除します。

    警告

    このメソッドは、書込み (write) サブスクライブ ブロック中にのみ呼び出されます。

    宣言

    Objective-C

    - (void)removeSubscriptionWithName:(nonnull NSString *)name;

    Swift

    func removeSubscription(withName name: String)

    パラメーター

    name

    サブスクリプションを識別するために使用される名前。

  • オブジェクト クラスの指定されたクエリを持つサブスクライブをサブスクライブ セットから削除します。

    警告

    このメソッドは、書込み (write) サブスクライブ ブロック中にのみ呼び出されます。

    宣言

    Objective-C

    - (void)removeSubscriptionWithClassName:(nonnull NSString *)objectClassName
                                      where:(nonnull NSString *)predicateFormat,
                                            ...;

    パラメーター

    objectClassName

    クエリされるモデル クラスのクラス名。

    predicateFormat

    述語形式の string 。オプションで、その後に変数の数の引数が続きます。

  • オブジェクト クラスの指定されたクエリを持つサブスクライブをサブスクライブ セットから削除します。

    警告

    このメソッドは、書込み (write) サブスクライブ ブロック中にのみ呼び出されます。

    宣言

    Objective-C

    - (void)removeSubscriptionWithClassName:(nonnull NSString *)objectClassName
                                  predicate:(nonnull NSPredicate *)predicate;

    Swift

    func removeSubscription(withClassName objectClassName: String, predicate: NSPredicate)

    パラメーター

    objectClassName

    クエリされるモデル クラスのクラス名。

    predicate

    削除するサブスクリプションを識別するために使用される述語。

  • サブスクライブをサブスクライブセットから削除します。

    警告

    このメソッドは、書込み (write) サブスクライブ ブロック中にのみ呼び出されます。

    宣言

    Objective-C

    - (void)removeSubscription:(nonnull RLMSyncSubscription *)subscription;

    Swift

    func remove(_ subscription: RLMSyncSubscription)

    パラメーター

    subscription

    削除するサブスクライブのインスタンス。

サブスクリプションの削除

  • サブスクリプションセットからすべてのサブスクライブを削除します。

    警告

    このメソッドは、書込み (write) サブスクライブ ブロック中にのみ呼び出されます。

    警告

    すべてのサブスクライブを削除すると、新しいサブスクリプションが追加されていない場合は、 エラーが発生します。 サーバーは少なくとも 1 つのサブスクライブを確認する必要があります。

    宣言

    Objective-C

    - (void)removeAllSubscriptions;

    Swift

    func removeAllSubscriptions()
  • サブスクリプションセットから名前のないすべてのサブスクライブを削除します。

    警告

    このメソッドは、書込み (write) サブスクライブ ブロック中にのみ呼び出されます。

    警告

    すべてのサブスクライブを削除すると、新しいサブスクリプションが追加されていない場合は、 エラーが発生します。 サーバーは少なくとも 1 つのサブスクライブを確認する必要があります。

    宣言

    Objective-C

    - (void)removeAllUnnamedSubscriptions;

    Swift

    func removeAllUnnamedSubscriptions()
  • 指定されたクラス名を持つすべてのサブスクライブを削除します。

    警告

    このメソッドは、書込み (write) サブスクライブ ブロック中にのみ呼び出されます。

    宣言

    Objective-C

    - (void)removeAllSubscriptionsWithClassName:(nonnull NSString *)className;

    Swift

    func removeAllSubscriptions(withClassName className: String)

    パラメーター

    className

    クエリされるモデル クラスのクラス名。

SubscriptionSet コレクション

  • 指定されたindexのサブスクライブを返します。

    宣言

    Objective-C

    - (nullable RLMSyncSubscription *)objectAtIndex:(NSUInteger)index;

    Swift

    func object(at index: UInt) -> RLMSyncSubscription?

    パラメーター

    index

    インデックス。

    戻り値

    サブスクリプション セット内の指定されたインデックスのサブスクライブ。

  • サブスクライブセット リスト内の最初のオブジェクトを返します。サブスクライブが空の場合はnilを返します。

    宣言

    Objective-C

    - (nullable RLMSyncSubscription *)firstObject;

    Swift

    func firstObject() -> RLMSyncSubscription?

    戻り値

    サブスクライブ。

  • サブスクライブ セット内の最後のオブジェクトを返します。サブスクライブが空の場合はnilを返します。

    宣言

    Objective-C

    - (nullable RLMSyncSubscription *)lastObject;

    Swift

    func lastObject() -> RLMSyncSubscription?

    戻り値

    サブスクライブ。

サブスクライブ

  • 指定されたindexのサブスクライブを返します。

    宣言

    Objective-C

    - (nonnull id)objectAtIndexedSubscript:(NSUInteger)index;

    Swift

    subscript(index: UInt) -> Any { get }

    パラメーター

    index

    インデックス。

    戻り値

    サブスクリプション セット内の指定されたインデックスのサブスクライブ。