RRMArray
Objective-C
@interface RLMArray<RLMObjectType> : NSObject <RLMCollection>
Swift
@_nonSendable(_assumed) class RLMArray<RLMObjectType> : NSObject, RLMCollection where RLMObjectType : AnyObject
RLMArray
は、対多関係を定義するために使用される Realm のコンテナ タイプです。
NSArray
と違い、 RLMArray
はobjectClassName
プロパティによって指定される単一のタイプを保持します。 これらのDocsでは、これは配列の「型」として呼ばれます。
RLMArray
プロパティを宣言する場合、その型は含めるオブジェクトと同じ名前でプロトコルに準拠しているものとしてマークする必要があります( RLM_COLLECTION_TYPE
マイクロを参照)。 さらに、コンパイル時の型の安全性を向上させるために、Objective-C ジェネリックを使用してプロパティを宣言できます。
RLM_COLLECTION_TYPE(ObjectType)
...
@property RLMArray<ObjectType *><ObjectType> *arrayOfObjectTypes;
RLMArray
は、 RLMObject
およびRLMResult
と同じ述語でクエリできます。
RLMArray
を直接作成することはできません。 RLMArray
RLMObject
の プロパティはアクセス時に遅延して作成されるか、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 }
-
配列がアクセスできなくなっているかどうかを示します。
宣言
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
配列と同じクラスのオブジェクトを含む、
NSArray
やRLMResults
などの列挙可能なオブジェクト。 -
指定されたインデックスにオブジェクトを挿入します。
インデックスが配列の境界を超える場合は、例外がスローされます。
警告
このメソッドは、書込みトランザクション中にのみ呼び出されます。
宣言
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 のインスタンス。
-
配列が変更されるたびに呼び出されるブロックを登録します。
ブロックは最初の配列とは非同期に呼び出され、配列内のいずれかのオブジェクト(結果に含まれるオブジェクト)、または配列内のオブジェクトの順序を変更するたびに再度呼び出されます。
ブロックが初めて呼び出されるときに、
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"];
警告
このメソッドは、
RLMObject
、RLMArray
、およびNSData
プロパティでは使用できません。宣言
Objective-C
- (nullable id)minOfProperty:(nonnull NSString *)property;
Swift
func min(ofProperty property: String) -> Any?
パラメーター
property
最小値が必要なプロパティ。
int
、float
、double
、NSDate
タイプのプロパティのみがサポートされています。戻り値
プロパティの最小値、または配列が空の場合は
nil
。 -
配列内のすべてのオブジェクトの中で指定されたプロパティの最大(最高)値を返します。
NSNumber *max = [object.arrayProperty maxOfProperty:@"age"];
警告
このメソッドは、
RLMObject
、RLMArray
、およびNSData
プロパティでは使用できません。宣言
Objective-C
- (nullable id)maxOfProperty:(nonnull NSString *)property;
Swift
func max(ofProperty property: String) -> Any?
パラメーター
property
最大値が必要なプロパティ。
int
、float
、double
、NSDate
タイプのプロパティのみがサポートされています。戻り値
プロパティの最大値、または配列が空の場合は
nil
。 -
配列内のすべてのオブジェクトの指定されたプロパティの値の合計を返します。
NSNumber *sum = [object.arrayProperty sumOfProperty:@"age"];
警告
このメソッドは、
RLMObject
、RLMArray
、およびNSData
プロパティでは使用できません。宣言
Objective-C
- (nonnull NSNumber *)sumOfProperty:(nonnull NSString *)property;
Swift
func sum(ofProperty property: String) -> NSNumber
パラメーター
property
値を合計する必要があるプロパティ。 サポートされているのは、
int
、float
、double
タイプのプロパティのみです。戻り値
指定された プロパティの合計。
-
配列内のオブジェクトに対する指定されたプロパティの平均値を返します。
NSNumber *average = [object.arrayProperty averageOfProperty:@"age"];
警告
このメソッドは、
RLMObject
、RLMArray
、およびNSData
プロパティでは使用できません。宣言
Objective-C
- (nullable NSNumber *)averageOfProperty:(nonnull NSString *)property;
Swift
func average(ofProperty property: String) -> NSNumber?
パラメーター
property
平均値を計算するプロパティ。 サポートされているのは、
int
、float
、double
タイプのプロパティのみです。戻り値
指定されたプロパティの平均値、または配列が空の場合は
nil
。
-
この配列の固定(不変)スナップショットを返します。
固定コピーは、この配列に現在含まれているデータと同じデータを含む不変の配列ですが、含まれている 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
を直接作成できないため、利用できません。RLMArray
RLMObject
上の プロパティは、アクセス時に遅延作成されます。宣言
Objective-C
- (nonnull instancetype)init;
-
なし
RRMArray は直接作成できません
+[RLMArray new]
は、RLMArray
を直接作成できないため、利用できません。RLMArray
RLMObject
上の プロパティは、アクセス時に遅延作成されます。宣言
Objective-C
+ (nonnull instancetype)new;