RRMArray

Objective-C

@interface RLMArray<RLMObjectType> : NSObject <RLMCollection>

Swift

@_nonSendable(_assumed) class RLMArray<RLMObjectType> : NSObject, RLMCollection where RLMObjectType : AnyObject

RLMArray は、対多関係を定義するために使用される Realm のコンテナ タイプです。

NSArrayと違い、 RLMArrayobjectClassNameプロパティによって指定される単一のタイプを保持します。 これらのDocsでは、これは配列の「型」として呼ばれます。

RLMArrayプロパティを宣言する場合、その型は含めるオブジェクトと同じ名前でプロトコルに準拠しているものとしてマークする必要があります( RLM_COLLECTION_TYPEマイクロを参照)。 さらに、コンパイル時の型の安全性を向上させるために、Objective-C ジェネリックを使用してプロパティを宣言できます。

RLM_COLLECTION_TYPE(ObjectType)
...
@property RLMArray<ObjectType *><ObjectType> *arrayOfObjectTypes;

RLMArrayは、 RLMObjectおよびRLMResultと同じ述語でクエリできます。

RLMArrayを直接作成することはできません。 RLMArrayRLMObjectの プロパティはアクセス時に遅延して作成されるか、Realm をクエリすることで取得できます。

キー値の観察

RLMArray は、 RLMObjectサブクラスのRLMArrayプロパティで配列キー値の監視をサポートしており、 RLMArrayインスタンスのinvalidatedプロパティ自体は、 RLMArrayが管理対象のRLMObjectにアタッチされている場合にキー値の監視に準拠しています( RLMArray管理されていないRLMObject上のは無効化されません)。

RLMArrayは、 のプロパティであるオブジェクトにアタッチされているため、含まれオブジェクトで-mutableArrayValueForKey:の可変コレクション プロキシ オブジェクトまたは KVM と互換性のあるミューテーション メソッドを使用する必要はありません。 代わりに、 RLMArray上のミューテーション メソッドを直接呼び出すことができます。

プロパティ

  • 配列内のオブジェクトの数。

    宣言

    Objective-C

    @property (nonatomic, readonly) NSUInteger count;

    Swift

    var count: UInt { get }
  • 配列内のオブジェクトの型。

    宣言

    Objective-C

    @property (nonatomic, readonly) RLMPropertyType type;

    Swift

    var type: RLMPropertyType { get }
  • コレクション内のオブジェクトがnilになるかどうかを示します。

    宣言

    Objective-C

    @property (nonatomic, readonly, getter=isOptional) BOOL optional;

    Swift

    var isOptional: Bool { get }
  • 配列に含まれるオブジェクトのクラス名。

    typeが RMPropertyTypeObject でない場合は、 nilになります。

    宣言

    Objective-C

    @property (nonatomic, copy, readonly, nullable) NSString *objectClassName;

    Swift

    var objectClassName: String? { get }
  • 配列を管理する Realm。 マネージドされていない配列の場合、 nilを返します。

    宣言

    Objective-C

    @property (nonatomic, readonly, nullable) RLMRealm *realm;

    Swift

    var realm: RLMRealm? { get }
  • 配列がアクセスできなくなっているかどうかを示します。

    宣言

    Objective-C

    @property (nonatomic, readonly, getter=isInvalidated) BOOL invalidated;

    Swift

    var isInvalidated: Bool { get }
  • 配列が固定されているかどうかを示します。

    凍結された配列は不変であり、どのスレッドからでもアクセスできます。 凍結された配列は、管理対象のライブ配列で-freezeを呼び出すことによって作成されます。 管理されていない配列は固定されません。

    宣言

    Objective-C

    @property (nonatomic, readonly, getter=isFrozen) BOOL frozen;

    Swift

    var isFrozen: Bool { get }

配列からオブジェクトへのアクセス

  • 指定されたインデックスにあるオブジェクトを返します。

    宣言

    Objective-C

    - (nonnull RLMObjectType)objectAtIndex:(NSUInteger)index;

    Swift

    func object(at index: UInt) -> RLMObjectType

    パラメーター

    index

    検索するインデックス。

    戻り値

    配列に含まれる 型のオブジェクト。

  • 指定されたインデックスセットによって指定されたインデックスにある 配列内のオブジェクトを含む配列を返します。 インデックスセットに配列の境界外のインデックスが含まれている場合は、 nilが返されます。

    宣言

    Objective-C

    - (nullable NSArray<RLMObjectType> *)objectsAtIndexes:
        (nonnull NSIndexSet *)indexes;

    Swift

    func objects(at indexes: IndexSet) -> [RLMObjectType]?

    パラメーター

    indexes

    オブジェクトを取得する配列内のインデックス。

    戻り値

    指定されたインデックスにあるオブジェクト。

  • 配列の最初のオブジェクトを返します。

    空の配列で呼び出されるとnilが返されます。

    宣言

    Objective-C

    - (nullable RLMObjectType)firstObject;

    Swift

    func firstObject() -> RLMObjectType?

    戻り値

    配列に含まれる 型のオブジェクト。

  • 配列内の最後のオブジェクトを返します。

    空の配列で呼び出されるとnilが返されます。

    宣言

    Objective-C

    - (nullable RLMObjectType)lastObject;

    Swift

    func lastObject() -> RLMObjectType?

    戻り値

    配列に含まれる 型のオブジェクト。

配列内のオブジェクトの追加、削除、置換

  • 配列の末尾にオブジェクトを追加します。

    警告

    このメソッドは、書込みトランザクション中にのみ呼び出されます。

    宣言

    Objective-C

    - (void)addObject:(nonnull RLMObjectType)object;

    Swift

    func add(_ object: RLMObjectType)

    パラメーター

    object

    配列に含まれる 型のオブジェクト。

  • オブジェクトの配列を配列の末尾に追加します。

    警告

    このメソッドは、書込みトランザクション中にのみ呼び出されます。

    宣言

    Objective-C

    - (void)addObjects:(nonnull id<NSFastEnumeration>)objects;

    Swift

    func addObjects(_ objects: any NSFastEnumeration)

    パラメーター

    objects

    配列と同じクラスのオブジェクトを含む、 NSArrayRLMResultsなどの列挙可能なオブジェクト。

  • 指定されたインデックスにオブジェクトを挿入します。

    インデックスが配列の境界を超える場合は、例外がスローされます。

    警告

    このメソッドは、書込みトランザクション中にのみ呼び出されます。

    宣言

    Objective-C

    - (void)insertObject:(nonnull RLMObjectType)anObject atIndex:(NSUInteger)index;

    Swift

    func insert(_ anObject: RLMObjectType, at index: UInt)

    パラメーター

    anObject

    配列に含まれる 型のオブジェクト。

    index

    オブジェクトを挿入するインデックス。

  • 指定されたインデックスにあるオブジェクトを削除します。

    インデックスが配列の境界を超える場合は、例外がスローされます。

    警告

    このメソッドは、書込みトランザクション中にのみ呼び出されます。

    宣言

    Objective-C

    - (void)removeObjectAtIndex:(NSUInteger)index;

    Swift

    func removeObject(at index: UInt)

    パラメーター

    index

    削除するオブジェクトを識別する配列インデックス。

  • 配列内の最後のオブジェクトを削除します。

    配列がすでに空になっている場合は、この処理は行われません。

    警告

    このメソッドは、書込みトランザクション中にのみ呼び出されます。

    宣言

    Objective-C

    - (void)removeLastObject;

    Swift

    func removeLastObject()
  • 配列からすべてのオブジェクトを削除します。

    警告

    このメソッドは、書込みトランザクション中にのみ呼び出されます。

    宣言

    Objective-C

    - (void)removeAllObjects;

    Swift

    func removeAllObjects()
  • 指定されたインデックス内のオブジェクトを新しいオブジェクトに置き換えます。

    インデックスが配列の境界を超える場合は、例外がスローされます。

    警告

    このメソッドは、書込みトランザクション中にのみ呼び出されます。

    宣言

    Objective-C

    - (void)replaceObjectAtIndex:(NSUInteger)index
                      withObject:(nonnull RLMObjectType)anObject;

    Swift

    func replaceObject(at index: UInt, with anObject: RLMObjectType)

    パラメーター

    index

    置き換えられるオブジェクトのインデックス。

    anObject

    オブジェクト( objectClassNameセレクターから返されるのと同じ型)。

  • 指定されたソース インデックスにあるオブジェクトを指定された宛先インデックスに移動します。

    インデックスが配列の境界を超える場合は、例外がスローされます。

    警告

    このメソッドは、書込みトランザクション中にのみ呼び出されます。

    宣言

    Objective-C

    - (void)moveObjectAtIndex:(NSUInteger)sourceIndex
                      toIndex:(NSUInteger)destinationIndex;

    Swift

    func moveObject(at sourceIndex: UInt, to destinationIndex: UInt)

    パラメーター

    sourceIndex

    移動するオブジェクトのインデックス。

    destinationIndex

    sourceIndexのオブジェクトを移動するインデックス。

  • 配列内の指定されたインデックスで配列内のオブジェクトを交換します。

    いずれかのインデックスが配列の境界を超える場合は、例外がスローされます。

    警告

    このメソッドは、書込みトランザクション中にのみ呼び出されます。

    宣言

    Objective-C

    - (void)exchangeObjectAtIndex:(NSUInteger)index1
                withObjectAtIndex:(NSUInteger)index2;

    Swift

    func exchangeObject(at index1: UInt, withObjectAt index2: UInt)

    パラメーター

    index1

    インデックスindex2のオブジェクトを置き換えるオブジェクトのインデックス。

    index2

    インデックスindex1のオブジェクトを置き換えるオブジェクトのインデックス。

配列のクエリ

  • 配列内のオブジェクトのインデックスを返します。

    オブジェクトが配列内に見つからない場合は、 NSNotFoundを返します。

    宣言

    Objective-C

    - (NSUInteger)indexOfObject:(nonnull RLMObjectType)object;

    Swift

    func index(of object: RLMObjectType) -> UInt

    パラメーター

    object

    オブジェクト( objectClassNameセレクターから返されるのと同じ型)。

  • 述語に一致する配列内の最初のオブジェクトのインデックスを返します。

    宣言

    Objective-C

    - (NSUInteger)indexOfObjectWhere:(nonnull NSString *)predicateFormat, ...;

    パラメーター

    predicateFormat

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

    戻り値

    オブジェクトのインデックス。配列内にオブジェクトが見つからない場合はNSNotFound

  • 述語に一致する配列内の最初のオブジェクトのインデックスを返します。

    宣言

    Objective-C

    - (NSUInteger)indexOfObjectWithPredicate:(nonnull NSPredicate *)predicate;

    Swift

    func indexOfObject(with predicate: NSPredicate) -> UInt

    パラメーター

    predicate

    オブジェクトをフィルタリングする述語。

    戻り値

    オブジェクトのインデックス。配列内にオブジェクトが見つからない場合はNSNotFound

  • 配列内の指定された述語に一致するすべてのオブジェクトを返します。

    宣言

    Objective-C

    - (nonnull RLMResults<RLMObjectType> *)objectsWhere:
        (nonnull NSString *)predicateFormat, ...;

    パラメーター

    predicateFormat

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

    戻り値

    指定された述語に一致するオブジェクトのRLMResults

  • 配列内の指定された述語に一致するすべてのオブジェクトを返します。

    宣言

    Objective-C

    - (nonnull RLMResults<RLMObjectType> *)objectsWithPredicate:
        (nonnull NSPredicate *)predicate;

    Swift

    func objects(with predicate: NSPredicate) -> RLMResults

    パラメーター

    predicate

    オブジェクトをフィルタリングする述語。

    戻り値

    指定された述語に一致するオブジェクトのRLMResults

  • 配列からソートされたRLMResultsを返します。

    宣言

    Objective-C

    - (nonnull RLMResults<RLMObjectType> *)
        sortedResultsUsingKeyPath:(nonnull NSString *)keyPath
                        ascending:(BOOL)ascending;

    Swift

    func sortedResults(usingKeyPath keyPath: String, ascending: Bool) -> RLMResults

    パラメーター

    keyPath

    ソートするキー パス。

    ascending

    並べ替える方向。

    戻り値

    指定されたキー パスでソートされたRLMResults

  • 配列からソートされたRLMResultsを返します。

    宣言

    Objective-C

    - (nonnull RLMResults<RLMObjectType> *)sortedResultsUsingDescriptors:
        (nonnull NSArray<RLMSortDescriptor *> *)properties;

    Swift

    func sortedResults(using properties: [RLMSortDescriptor]) -> RLMResults

    パラメーター

    properties

    並べ替え対象のRLMSortDescriptorの配列。

    戻り値

    指定されたプロパティでソートされたRLMResults

  • 配列から個別のRLMResultsを返します。

    宣言

    Objective-C

    - (nonnull RLMResults<RLMObjectType> *)distinctResultsUsingKeyPaths:
        (nonnull NSArray<NSString *> *)keyPaths;

    Swift

    func distinctResults(usingKeyPaths keyPaths: [String]) -> RLMResults

    パラメーター

    keyPaths

    で個別のキー パス。

    戻り値

    キーパスの個別の値を持つRLMResults

配列のセクション化

  • このコレクションを指定されたプロパティ キー パスからソートしてセクションを作成し、その結果をRLMSectionedResultsのインスタンスとして返します。

    宣言

    Objective-C

    - (nonnull RLMSectionedResults *)
        sectionedResultsSortedUsingKeyPath:(nonnull NSString *)keyPath
                                 ascending:(BOOL)ascending
                                  keyBlock:
                                      (nonnull RLMSectionedResultsKeyBlock)keyBlock;

    Swift

    func sectionedResultsSorted(usingKeyPath keyPath: String, ascending: Bool, keyBlock: @escaping RLMSectionedResultsKeyBlock) -> RLMSectionedResults

    パラメーター

    keyPath

    ソートするプロパティ キー パス。

    ascending

    並べ替える方向。

    keyBlock

    結果コレクション内の各要素に対して呼び出されるコールバック。 このコールバックは、 コレクション内の要素のセクション キーを返すものです。

    戻り値

    RLMSectionedResults のインスタンス。

  • このコレクションを指定されたソート記述子の配列からソートしてセクション化し、その結果をRLMSectionedResultsのインスタンスとして返します。

    注意

    プライマリソート記述子は、セクションキーの決定を担当する必要があります。

    宣言

    Objective-C

    - (nonnull RLMSectionedResults *)
        sectionedResultsUsingSortDescriptors:
            (nonnull NSArray<RLMSortDescriptor *> *)sortDescriptors
                                    keyBlock:(nonnull RLMSectionedResultsKeyBlock)
                                                 keyBlock;

    Swift

    func sectionedResults(using sortDescriptors: [RLMSortDescriptor], keyBlock: @escaping RLMSectionedResultsKeyBlock) -> RLMSectionedResults

    パラメーター

    sortDescriptors

    並べ替え対象のRLMSortDescriptorの配列。

    keyBlock

    結果コレクション内の各要素に対して呼び出されるコールバック。 このコールバックは、 コレクション内の要素のセクション キーを返すものです。

    戻り値

    RLMSectionedResults のインスタンス。

notifications

  • 配列が変更されるたびに呼び出されるブロックを登録します。

    ブロックは最初の配列とは非同期に呼び出され、配列内のいずれかのオブジェクト(結果に含まれるオブジェクト)、または配列内のオブジェクトの順序を変更するたびに再度呼び出されます。

    ブロックが初めて呼び出されるときに、 changesパラメータはnilになります。 その後の呼び出しごとに、 配列内のどの行が追加、削除、または変更されたかに関する情報が含まれます。 書込みトランザクションによって配列内のオブジェクトが変更されなかった場合、ブロックはまったく呼び出されません。 変更が報告される方法と、 UITableViewの更新例については、 RLMCollectionChangeのドキュメントを参照してください。

    エラー パラメータは下位互換性のためだけに存在し、常にnilになります。

    通知は標準の実行ループ経由で配信されるため、実行ループが他のアクティビティによってブロックされている間は配信されません。 通知をすぐに配信できない場合は、複数の通知が 1 つの通知に統合されることがあります。 これには初期結果を持つ通知を含めることができます。 たとえば、次のコードは通知ブロックを追加した後すぐに書込みトランザクションを実行するため、最初の通知が最初に配信される可能性はありません。 その結果、最初の通知には、書込みトランザクション後の Realm の状態が反映されます。

    Person *person = [[Person allObjectsInRealm:realm] firstObject];
    NSLog(@"person.dogs.count: %zu", person.dogs.count); // => 0
    self.token = [person.dogs addNotificationBlock(RLMArray<Dog *> *dogs,
                                                   RLMCollectionChange *changes,
                                                   NSError *error) {
        // Only fired once for the example
        NSLog(@"dogs.count: %zu", dogs.count) // => 1
    }];
    [realm transactionWithBlock:^{
        Dog *dog = [[Dog alloc] init];
        dog.name = @"Rex";
        [person.dogs addObject:dog];
    }];
    // end of run loop execution context
    

    アップデートを ブロックに引き続き送信する場合は、返されたトークンを保持する必要があります。 更新の受信を停止するには、トークンで-invalidateを呼び出します。

    警告

    このメソッドは、書込みトランザクション中、または Realm を含む が読み取り専用の場合に呼び出すことができません。

    警告

    このメソッドは、凍結されていない管理配列でのみ呼び出せます。

    宣言

    Objective-C

    - (nonnull RLMNotificationToken *)addNotificationBlock:
        (nonnull void (^)(RLMArray<RLMObjectType> *_Nullable,
                          RLMCollectionChange *_Nullable, NSError *_Nullable))block;

    Swift

    func addNotificationBlock(_ block: @escaping (RLMArray<RLMObjectType>?, RLMCollectionChange?, (any Error)?) -> Void) -> RLMNotificationToken

    パラメーター

    block

    配列が変更されるたびに呼び出されるブロック。

    戻り値

    更新を配信する限り保持する必要があるトークン。

  • 配列が変更されるたびに呼び出されるブロックを登録します。

    ブロックは最初の配列とは非同期に呼び出され、配列内のいずれかのオブジェクト(結果に含まれるオブジェクト)、または配列内のオブジェクトの順序を変更するたびに再度呼び出されます。

    ブロックが初めて呼び出されるときに、 changesパラメータはnilになります。 その後の呼び出しごとに、 配列内のどの行が追加、削除、または変更されたかに関する情報が含まれます。 書込みトランザクションによって配列内のオブジェクトが変更されなかった場合、ブロックはまったく呼び出されません。 変更が報告される方法と、 UITableViewの更新例については、 RLMCollectionChangeのドキュメントを参照してください。

    エラー パラメータは下位互換性のためだけに存在し、常にnilになります。

    通知は指定されたキューに配信されます。 キューがブロックされ、通知がすぐに配信されない場合は、複数の通知が 1 つの通知に統合されます。

    アップデートを ブロックに引き続き送信する場合は、返されたトークンを保持する必要があります。 更新の受信を停止するには、トークンで-invalidateを呼び出します。

    警告

    このメソッドは、Realm を含む が読み取り専用または固定されている場合、呼び出すことができません。

    警告

    キューはシリアル キューである必要があります。

    宣言

    Objective-C

    - (nonnull RLMNotificationToken *)
        addNotificationBlock:(nonnull void (^)(RLMArray<RLMObjectType> *_Nullable,
                                               RLMCollectionChange *_Nullable,
                                               NSError *_Nullable))block
                       queue:(nullable dispatch_queue_t)queue;

    Swift

    func addNotificationBlock(_ block: @escaping (RLMArray<RLMObjectType>?, RLMCollectionChange?, (any Error)?) -> Void, queue: dispatch_queue_t?) -> RLMNotificationToken

    パラメーター

    block

    変更が発生するたびに呼び出されるブロック。

    queue

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

    戻り値

    更新を配信する限り保持する必要があるトークン。

  • 配列が変更されるたびに呼び出されるブロックを登録します。

    ブロックは最初の配列とは非同期に呼び出され、配列内のいずれかのオブジェクト(結果に含まれるオブジェクト)、または配列内のオブジェクトの順序を変更するたびに再度呼び出されます。

    ブロックが初めて呼び出されるときに、 changesパラメータはnilになります。 その後の呼び出しごとに、 配列内のどの行が追加、削除、または変更されたかに関する情報が含まれます。 書込みトランザクションによって配列内のオブジェクトが変更されなかった場合、ブロックはまったく呼び出されません。 変更が報告される方法と、 UITableViewの更新例については、 RLMCollectionChangeのドキュメントを参照してください。

    エラー パラメータは下位互換性のためだけに存在し、常にnilになります。

    通知は指定されたキューに配信されます。 キューがブロックされ、通知がすぐに配信されない場合は、複数の通知が 1 つの通知に統合されます。

    アップデートを ブロックに引き続き送信する場合は、返されたトークンを保持する必要があります。 更新の受信を停止するには、トークンで-invalidateを呼び出します。

    警告

    このメソッドは、Realm を含む が読み取り専用または固定されている場合、呼び出すことができません。

    警告

    キューはシリアル キューである必要があります。

    宣言

    Objective-C

    - (nonnull RLMNotificationToken *)
        addNotificationBlock:(nonnull void (^)(RLMArray<RLMObjectType> *_Nullable,
                                               RLMCollectionChange *_Nullable,
                                               NSError *_Nullable))block
                    keyPaths:(nullable NSArray<NSString *> *)keyPaths
                       queue:(nullable dispatch_queue_t)queue;

    Swift

    func addNotificationBlock(_ block: @escaping (RLMArray<RLMObjectType>?, RLMCollectionChange?, (any Error)?) -> Void, keyPaths: [String]?, queue: dispatch_queue_t?) -> RLMNotificationToken

    パラメーター

    block

    変更が発生するたびに呼び出されるブロック。

    keyPaths

    これらのキーパスで発生した変更に対してブロックが呼び出されます。 キー パスが指定されていない場合、プロパティ キー パスごとに通知が配信されます。

    queue

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

    戻り値

    更新を配信する限り保持する必要があるトークン。

  • 配列が変更されるたびに呼び出されるブロックを登録します。

    ブロックは最初の配列とは非同期に呼び出され、配列内のいずれかのオブジェクト(結果に含まれるオブジェクト)、または配列内のオブジェクトの順序を変更するたびに再度呼び出されます。

    ブロックが初めて呼び出されるときに、 changesパラメータはnilになります。 その後の呼び出しごとに、 配列内のどの行が追加、削除、または変更されたかに関する情報が含まれます。 書込みトランザクションによって配列内のオブジェクトが変更されなかった場合、ブロックはまったく呼び出されません。 変更が報告される方法と、 UITableViewの更新例については、 RLMCollectionChangeのドキュメントを参照してください。

    エラー パラメータは下位互換性のためだけに存在し、常にnilになります。

    通知は標準の実行ループ経由で配信されるため、実行ループが他のアクティビティによってブロックされている間は配信されません。 通知をすぐに配信できない場合は、複数の通知が 1 つの通知に統合されることがあります。 これには初期結果を持つ通知を含めることができます。 たとえば、次のコードは通知ブロックを追加した後すぐに書込みトランザクションを実行するため、最初の通知が最初に配信される可能性はありません。 その結果、最初の通知には、書込みトランザクション後の Realm の状態が反映されます。

    アップデートを ブロックに引き続き送信する場合は、返されたトークンを保持する必要があります。 更新の受信を停止するには、トークンで-invalidateを呼び出します。

    警告

    このメソッドは、Realm を含む が読み取り専用または固定されている場合、呼び出すことができません。

    警告

    キューはシリアル キューである必要があります。

    宣言

    Objective-C

    - (nonnull RLMNotificationToken *)
        addNotificationBlock:(nonnull void (^)(RLMArray<RLMObjectType> *_Nullable,
                                               RLMCollectionChange *_Nullable,
                                               NSError *_Nullable))block
                    keyPaths:(nullable NSArray<NSString *> *)keyPaths;

    Swift

    func addNotificationBlock(_ block: @escaping (RLMArray<RLMObjectType>?, RLMCollectionChange?, (any Error)?) -> Void, keyPaths: [String]?) -> RLMNotificationToken

    パラメーター

    block

    変更が発生するたびに呼び出されるブロック。

    keyPaths

    これらのキーパスで発生した変更に対してブロックが呼び出されます。 キー パスが指定されていない場合、プロパティ キー パスごとに通知が配信されます。

    戻り値

    更新を配信する限り保持する必要があるトークン。

プロパティ値の集計

  • 配列内のすべてのオブジェクトの中で指定されたプロパティの最小(最小)値を返します。

    NSNumber *min = [object.arrayProperty minOfProperty:@"age"];
    

    警告

    このメソッドは、 RLMObjectRLMArray 、およびNSDataプロパティでは使用できません。

    宣言

    Objective-C

    - (nullable id)minOfProperty:(nonnull NSString *)property;

    Swift

    func min(ofProperty property: String) -> Any?

    パラメーター

    property

    最小値が必要なプロパティ。 intfloatdoubleNSDateタイプのプロパティのみがサポートされています。

    戻り値

    プロパティの最小値、または配列が空の場合はnil

  • 配列内のすべてのオブジェクトの中で指定されたプロパティの最大(最高)値を返します。

    NSNumber *max = [object.arrayProperty maxOfProperty:@"age"];
    

    警告

    このメソッドは、 RLMObjectRLMArray 、およびNSDataプロパティでは使用できません。

    宣言

    Objective-C

    - (nullable id)maxOfProperty:(nonnull NSString *)property;

    Swift

    func max(ofProperty property: String) -> Any?

    パラメーター

    property

    最大値が必要なプロパティ。 intfloatdoubleNSDateタイプのプロパティのみがサポートされています。

    戻り値

    プロパティの最大値、または配列が空の場合はnil

  • 配列内のすべてのオブジェクトの指定されたプロパティの値の合計を返します。

    NSNumber *sum = [object.arrayProperty sumOfProperty:@"age"];
    

    警告

    このメソッドは、 RLMObjectRLMArray 、およびNSDataプロパティでは使用できません。

    宣言

    Objective-C

    - (nonnull NSNumber *)sumOfProperty:(nonnull NSString *)property;

    Swift

    func sum(ofProperty property: String) -> NSNumber

    パラメーター

    property

    値を合計する必要があるプロパティ。 サポートされているのは、 intfloatdoubleタイプのプロパティのみです。

    戻り値

    指定された プロパティの合計。

  • 配列内のオブジェクトに対する指定されたプロパティの平均値を返します。

    NSNumber *average = [object.arrayProperty averageOfProperty:@"age"];
    

    警告

    このメソッドは、 RLMObjectRLMArray 、およびNSDataプロパティでは使用できません。

    宣言

    Objective-C

    - (nullable NSNumber *)averageOfProperty:(nonnull NSString *)property;

    Swift

    func average(ofProperty property: String) -> NSNumber?

    パラメーター

    property

    平均値を計算するプロパティ。 サポートされているのは、 intfloatdoubleタイプのプロパティのみです。

    戻り値

    指定されたプロパティの平均値、または配列が空の場合はnil

Freeze

  • この配列の固定(不変)スナップショットを返します。

    固定コピーは、この配列に現在含まれているデータと同じデータを含む不変の配列ですが、含まれている Realm に書込み (write) が行われた場合は更新されません。 ライブ配列と違い、固定配列には任意のスレッドからアクセスできます。

    警告

    このメソッドは、書込みトランザクション中、または Realm を含む が読み取り専用の場合に呼び出すことができません。

    警告

    このメソッドは、管理対象の配列でのみ呼び出すことができます。

    警告

    Realm で書込みトランザクションを実行中に固定された配列を長時間保持すると、Realm ファイルのサイズが大きくなる可能性があります。 詳しくは、 RLMRealmConfiguration.maximumNumberOfActiveVersionsを参照してください。

    宣言

    Objective-C

    - (nonnull instancetype)freeze;

    Swift

    func freeze() -> Self
  • この固定されたコレクションのライブ バージョンを返します。

    このメソッドは、同じ固定コレクションのライブ コピーへの参照を解決します。 ライブ コレクションで呼び出されると、 は自分自身を返します。

    宣言

    Objective-C

    - (nonnull instancetype)thaw;

    Swift

    func thaw() -> Self

利用できないメソッド

  • なし

    RRMArray は直接作成できません

    -[RLMArray init] は、 RLMArrayを直接作成できないため、利用できません。 RLMArrayRLMObject上の プロパティは、アクセス時に遅延作成されます。

    宣言

    Objective-C

    - (nonnull instancetype)init;
  • なし

    RRMArray は直接作成できません

    +[RLMArray new] は、 RLMArrayを直接作成できないため、利用できません。 RLMArrayRLMObject上の プロパティは、アクセス時に遅延作成されます。

    宣言

    Objective-C

    + (nonnull instancetype)new;