RealmKeyedCollection
public protocol RealmKeyedCollection : ThreadConfined, CustomStringConvertible, Sequence
検索、フィルタリング、並べ替え、操作可能なObject
の同種のキーと値のコレクション。
-
このコレクションに関連付けられているキーの型
宣言
Swift
associatedtype Key : _MapKey
-
このコレクションに関連付けられている値の型。
宣言
Swift
associatedtype Value : RealmCollectionValue
-
マップを管理する Realm、またはマップが管理されていない場合は
nil
。宣言
Swift
var realm: Realm? { get }
-
マップがアクセスできなくなっているかどうかを示します。
宣言
Swift
var isInvalidated: Bool { get }
-
このマップ内のキーと値のペアの数を返します。
宣言
Swift
var count: Int { get }
-
マップに含まれるオブジェクトの人間が判読可能な説明。
宣言
Swift
var description: String { get }
-
指定されたキーの辞書に保存されている値をアップデートし、キーが存在しない場合は新しいキーと値のペアを追加します。
注意
注: 辞書に追加される値が非管理オブジェクトで、かつ辞書が管理されている場合は、その非管理オブジェクトが Realm に追加されます。
警告
このメソッドは、書込みトランザクション中にのみ呼び出されます。
パラメーター
value
値のキーパス述語。
forKey
並べ替える方向。
-
指定されたキーとそれに関連付けられたオブジェクトを削除します(キーが辞書に存在する場合のみ)。 キーが存在しない場合、辞書は変更されません。
警告
このメソッドは、書込みトランザクション中にのみ呼び出されます。宣言
Swift
func removeObject(for key: Key)
-
辞書からすべてのオブジェクトを削除します。 オブジェクトは、それらを管理する Realm から削除されません。
警告
このメソッドは、書込みトランザクション中にのみ呼び出されます。宣言
Swift
func removeAll()
-
指定されたキーの値を返します。または、サブスクリプトを割り当てに使用する場合は、キーの値を設定します。
注意
注: 辞書に追加される値が非管理オブジェクトで、かつ辞書が管理されている場合は、その非管理オブジェクトが Realm に追加されます。
注意
注: キーに割り当てられている値が
nil
の場合、そのキーは辞書から削除されます。警告
このメソッドは、書込みトランザクション中にのみ呼び出されます。
パラメーター
key
キー。
-
マップ内に存在する場合は、指定されたキーの
Value
のタイプを返します。キー値のコーディングを使用する場合、キーは string である必要があることに注意してください。
宣言
Swift
func value(forKey key: String) -> AnyObject?
パラメーター
key
値が必要なプロパティへのキー。
-
マップ内に存在する場合は、指定されたキーの
Value
のタイプを返します。宣言
Swift
func value(forKeyPath keyPath: String) -> AnyObject?
パラメーター
keyPath
値が必要なプロパティへのキー。
-
指定されたキーと値のペアを辞書に追加するか、指定されたキーがすでに存在する場合は更新します。
警告
このメソッドは、書込みトランザクション中にのみ呼び出すことができます。
宣言
Swift
func setValue(_ value: Any?, forKey key: String)
パラメーター
value
オブジェクト値。
key
各オブジェクトに値を設定するプロパティの名前。
-
指定された述語と一致するすべての値を含む
Results
を返します。注意
これにより、キーと値のペアではなく、辞書内の値が返されます。
パラメーター
predicate
値をフィルタリングする述語。
-
マップにキーと値のペアが指定された述語を満たすかどうかを示すブール値を返します。
パラメーター
where
指定されたマップのいずれかのキーペアが一致を表すかどうかをテストする包含。
-
辞書内のオブジェクトをソートされた状態で含む
Results
を返します。オブジェクトは、 値に基づいてソートされます。 たとえば、
Date
の辞書を新しいセットから最も古い順に並べ替えるには、dates.sorted(ascending: true)
を呼び出します。パラメーター
ascending
並べ替える方向。
-
辞書内のオブジェクトをソートされた状態で含む
Results
を返します。オブジェクトは、指定されたキー パスの値に基づいてソートされます。 たとえば、
age
プロパティに基づいて、Student
の辞書を最も小さいものから最も古い順に並べ替えるには、students.sorted(byKeyPath: "age", ascending: true)
を呼び出します。警告
辞書は、ブール値、
Date
、NSDate
、単一および倍精度浮動小数点、整数、および string 型のプロパティでのみソートできます。パラメーター
keyPath
ソートするキー パス。
ascending
並べ替える方向。
-
辞書内のオブジェクトをソートされた状態で含む
Results
を返します。警告
辞書は、ブール値、
Date
、NSDate
、単一および倍精度浮動小数点、整数、および string 型のプロパティでのみソートできます。詳細は、次を参照してください:
宣言
Swift
func sorted<S: Sequence>(by sortDescriptors: S) -> Results<Value> where S.Iterator.Element == SortDescriptor
-
この辞書内のすべてのキーを返します。
宣言
Swift
var keys: [Key] { get }
-
辞書内のすべての値を返します。
宣言
Swift
var values: [Value] { get }
-
コレクション内のすべてのオブジェクト間で指定されたプロパティの最小(最小)値を返します。辞書が空の場合は
nil
を返します。警告
MinMaxType
プロトコルに準拠するタイプのプロパティのみを指定できます。宣言
Swift
func min<T>(ofProperty property: String) -> T? where T : MinMaxType
パラメーター
property
最小値が必要なプロパティの名前。
-
辞書内のすべてのオブジェクト間で指定されたプロパティの最大値(最高値)を返します。辞書が空の場合は
nil
を返します。警告
MinMaxType
プロトコルに準拠するタイプのプロパティのみを指定できます。宣言
Swift
func max<T>(ofProperty property: String) -> T? where T : MinMaxType
パラメーター
property
最小値が必要なプロパティの名前。
-
辞書内のオブジェクトの指定された プロパティの合計を返します。辞書が空の場合は
nil
です。警告
AddableType
プロトコルに準拠した型のプロパティ名のみを使用できます。宣言
Swift
func sum<T>(ofProperty property: String) -> T where T : AddableType
パラメーター
property
合計を計算するための
AddableType
に準拠したプロパティの名前。 -
辞書内のすべてのオブジェクトにわたる指定されたプロパティの平均値を返します。辞書が空の場合は
nil
です。警告
AddableType
プロトコルに準拠するタイプのプロパティのみを指定できます。宣言
Swift
func average<T>(ofProperty property: String) -> T? where T : AddableType
パラメーター
property
値を合計するプロパティの名前。
-
辞書が変更されるたびに呼び出されるブロックを登録します。
ブロックは最初の辞書とは非同期に呼び出され、辞書内のキーまたは値のいずれかを変更する書き込みトランザクションごとに再度呼び出されます。
ブロックに渡される
change
パラメータは、各書込みトランザクション中に追加、削除、または変更されたキーと値のペアを、辞書内のキーの形式で報告します。ブロックが呼び出される時点で、辞書は完全に評価され、最新の状態になります。同じスレッドで書込みトランザクションを実行したり、
realm.refresh()
を明示的に呼び出したりしない限り、アクセスはブロッキング実行されない限り、動作する。キューが指定されていない場合、通知は標準の実行ループを介して配信されるため、実行ループが他のアクティビティによってブロックされている間は通知を配信できません。 キューが指定されている場合、代わりにそのキューに通知が配信されます。 通知をすぐに配信できない場合は、複数の通知が 1 つの通知に統合されることがあります。 これには、初期コレクションの通知を含めることができます。
たとえば、次のコードは通知ブロックを追加した後すぐに書込みトランザクションを実行するため、最初の通知が最初に配信される可能性はありません。 その結果、最初の通知には、書込みトランザクション後の Realm の状態が反映されます。
let myStringMap = myObject.stringMap print("myStringMap.count: \(myStringMap?.count)") // => 0 let token = myStringMap.observe { changes in switch changes { case .initial(let myStringMap): // Will print "myStringMap.count: 1" print("myStringMap.count: \(myStringMap.count)") print("Dog Name: \(myStringMap["nameOfDog"])") // => "Rex" break case .update: // Will not be hit in this example break case .error: break } } try! realm.write { myStringMap["nameOfDog"] = "Rex" } // end of run loop execution context
アップデートをブロックに送信する場合は、返されたトークンを保持する必要があります。 更新の受信を停止するには、トークンで
invalidate()
を呼び出します。警告
このメソッドは、書込みトランザクション中、または Realm を含む が読み取り専用の場合に呼び出すことができません。
宣言
Swift
func observe(on queue: DispatchQueue?, _ block: @escaping (RealmMapChange<Self>) -> Void) -> NotificationToken
パラメーター
queue
通知を受信するシリアル ディスパッチ キュー。
nil
の場合、通知は現在のスレッドに配信されます。block
変更が発生するたびに呼び出されるブロック。
戻り値
更新を配信する限り保持する必要があるトークン。
-
このコレクションが固定されている場合は を返します
宣言
Swift
var isFrozen: Bool { get }
-
このコレクションの固定(不変)スナップショットを返します。
固定されたコピーは、このコレクションに現在含まれているデータと同じデータを含む不変のコレクションですが、含まれている Realm への書込み (write) が行われても更新されません。 ライブコレクションとは異なり、固定コレクションには任意のスレッドからアクセスできます。
警告
このメソッドは、書込みトランザクション中、または Realm を含む が読み取り専用の場合に呼び出すことができません。警告
Realm で書込みトランザクションを実行中に固定されたコレクションを長時間保持すると、Realm ファイルのサイズが大きくなる可能性があります。 詳しくは、Realm.Configuration.maximumNumberOfActiveVersions
を参照してください。宣言
Swift
func freeze() -> Self
-
この固定されたコレクションのライブ(可変)バージョンを返します。
このメソッドは、同じ固定コレクションのライブ コピーへの参照を解決します。 ライブ コレクションで呼び出されると、 は自分自身を返します。
宣言
Swift
func thaw() -> Self?
-
objectWillChange
拡張メソッドコレクションが変更されるたびに Vid を発行する出版社。
名前に関係なく、コレクションが変更された後にこれが実際に発行します。
宣言
Swift
public var objectWillChange: RealmPublishers.WillChange<Self> { get }
-
collectionPublisher
拡張メソッドコレクションが変更されるたびにコレクションを発行する出版社。
宣言
Swift
public var collectionPublisher: RealmPublishers.Value<Self> { get }
-
changesetPublisher
拡張メソッドコレクションが変更されるたびにコレクションの変更セットを発行する出版社。
宣言
Swift
public var changesetPublisher: RealmPublishers.MapChangeset<Self> { get }
-
sum()
拡張メソッドコレクション内の 値の合計を返します。コレクションが空の場合は
nil
を返します。宣言
Swift
func sum() -> Value
-
average()
拡張メソッドコレクション内のすべての値の平均を返します。
宣言
Swift
func average<T>() -> T? where T : AddableType
-
sum()
拡張メソッドコレクション内の 値の合計を返します。コレクションが空の場合は
nil
を返します。宣言
Swift
func sum() -> Value.Wrapped
-
average()
拡張メソッドコレクション内のすべての値の平均を返します。
宣言
Swift
func average<T>() -> T? where T : AddableType
-
sorted(ascending:
デフォルトの実装) デフォルトの実装
コレクション内のオブジェクトを含む
Results
をソートされた状態で返します。オブジェクトは、 値に基づいてソートされます。 たとえば、
Date
のコレクションを新しいセットから最も古い順に並べ替えるには、dates.sorted(ascending: true)
を呼び出します。パラメーター
ascending
並べ替える方向。
-
sorted(ascending:
デフォルトの実装) デフォルトの実装
コレクション内のオブジェクトを含む
Results
をソートされた状態で返します。オブジェクトは、 値に基づいてソートされます。 たとえば、
Date
のコレクションを新しいセットから最も古い順に並べ替えるには、dates.sorted(ascending: true)
を呼び出します。パラメーター
ascending
並べ替える方向。