Type Aliases

PropertyType is an enum describing all property types supported in Realm models.

For more information, see Realm Models.

Primitive types

• Int
• Bool
• Float
• Double

Object types

• String
• Data
• Date
• Decimal128
• ObjectId

Relationships: Array (in Swift, List) and Object types

• Object
• Array

An opaque token which is returned from methods which subscribe to changes to a Realm.

An object representing the Realm App configuration

An object representing a client which performs network calls on Realm Cloud user api keys

An object representing a client which performs network calls on Realm Cloud user registration & password functions

A block type used to report an error

An object representing a client which performs network calls on Realm Cloud for registering devices to push notifications

An object which is used within UserAPIKeyProviderClient

The App has the fundamental set of methods for communicating with a Realm application backend. This interface provides access to login and authentication.

Use this delegate to be provided a callback once authentication has succeed or failed

A Dictionary object representing a BSON document.

MaxKey will always be the greatest value when comparing to other BSON types

MinKey will always be the smallest value when comparing to other BSON types

Object is a class used to define Realm model objects.

In Realm you define your model classes by subclassing Object and adding properties to be managed. You then instantiate and use your custom subclasses instead of using the Object class directly.

class Dog: Object {
    @objc dynamic var name: String = ""
    @objc dynamic var adopted: Bool = false
    let siblings = List<Dog>()
}

Supported property types

• String, NSString
• Int
• Int8, Int16, Int32, Int64
• Float
• Double
• Bool
• Date, NSDate
• Data, NSData
• Decimal128
• ObjectId
• UUID
• @objc enum which has been delcared as conforming to RealmEnum.
• RealmOptional<Value> for optional numeric properties
• Object subclasses, to model many-to-one relationships
• EmbeddedObject subclasses, to model owning one-to-one relationships
• List<Element>, to model many-to-many relationships

String, NSString, Date, NSDate, Data, NSData, UUID, NSUUID, Decimal128 and ObjectId properties can be declared as optional. Object and EmbeddedObject subclasses must be declared as optional. Int, Int8, Int16, Int32, Int64, Float, Double, Bool, enum, and List properties cannot. To store an optional number, use RealmOptional<Int>, RealmOptional<Float>, RealmOptional<Double>, or RealmOptional<Bool> instead, which wraps an optional numeric value. Lists cannot be optional at all.

All property types except for List and RealmOptional must be declared as @objc dynamic var. List and RealmOptional properties must be declared as non-dynamic let properties. Swift lazy properties are not allowed.

Note that none of the restrictions listed above apply to properties that are configured to be ignored by Realm.

Querying

You can retrieve all objects of a given type from a Realm by calling the objects(_:) instance method.

Relationships

See our Cocoa guide for more details.

EmbeddedObject is a base class used to define embedded Realm model objects.

Embedded objects work similarly to normal objects, but are owned by a single parent Object (which itself may be embedded). Unlike normal top-level objects, embedded objects cannot be directly created in or added to a Realm. Instead, they can only be created as part of a parent object, or by assigning an unmanaged object to a parent object’s property. Embedded objects are automatically deleted when the parent object is deleted or when the parent is modified to no longer point at the embedded object, either by reassigning an Object property or by removing the embedded object from the List containing it.

Embedded objects can only ever have a single parent object which links to them, and attempting to link to an existing managed embedded object will throw an exception.

The property types supported on EmbeddedObject are the same as for Object, except for that embedded objects cannot link to top-level objects, so Object and List<Object> properties are not supported (EmbeddedObject and List<EmbeddedObject> are).

Embedded objects cannot have primary keys or indexed properties.

class Owner: Object {
    @objc dynamic var name: String = ""
    let dogs = List<Dog>()
}
class Dog: EmbeddedObject {
    @objc dynamic var name: String = ""
    @objc dynamic var adopted: Bool = false
    let owner = LinkingObjects(fromType: Owner.self, property: "dogs")
}

The type of a migration block used to migrate a Realm.

An object class used during migrations.

A block type which provides both the old and new versions of an object in the Realm. Object properties can only be accessed using subscripting.

The MongoClient enables reading and writing on a MongoDB database via the Realm Cloud service.

It provides access to instances of MongoDatabase, which in turn provide access to specific MongoCollections that hold your data.

The MongoDatabase represents a MongoDB database, which holds a group of collections that contain your data.

It can be retrieved from the MongoClient.

Use it to get MongoCollections for reading and writing data.

Options to use when executing a find command on a MongoCollection.

Options to use when executing a findOneAndUpdate, findOneAndReplace, or findOneAndDelete command on a MongoCollection.

The result of an updateOne or updateMany operation a MongoCollection.

Block which returns Result.success(DocumentId) on a successful insert or Result.failure(error)

Block which returns Result.success([ObjectId]) on a successful insertMany or Result.failure(error)

Block which returns Result.success([Document]) on a successful find operation or Result.failure(error)

Block which returns Result.success(Document?) on a successful findOne operation or Result.failure(error)

Block which returns Result.success(Int) on a successful count operation or Result.failure(error)

Block which returns Result.success(UpdateResult) on a successful update operation or Result.failure(error)

The MongoCollection represents a MongoDB collection.

You can get an instance from a MongoDatabase.

Create, read, update, and delete methods are available.

Operations against the Realm Cloud server are performed asynchronously.

Acts as a middleman and processes events with WatchStream

The type of a block to run for notification purposes when the data in a Realm is modified.

An object representing a MongoDB Realm user.

A singleton which configures and manages MongoDB Realm synchronization-related functionality.

Options for configuring timeouts and intervals in the sync client.

A session object which represents communication between the client and server for a specific Realm.

A closure type for a closure which can be set on the SyncManager to allow errors to be reported to the application.

A closure type for a closure which is used by certain APIs to asynchronously return a SyncUser object to the application.

An error associated with the SDK’s synchronization functionality. All errors reported by an error handler registered on the SyncManager are of this type.

An error associated with network requests made to the authentication server. This type of error may be returned in the callback block to SyncUser.logIn() upon certain types of failed login attempts (for example, if the request is malformed or if the server is experiencing an issue).

An enum which can be used to specify the level of logging.

A data type whose values represent different authentication providers that can be used with MongoDB Realm.