Object

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

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

Supported property types

  • String
  • Int
  • Float
  • Double
  • Bool
  • NSDate
  • NSData
  • Object subclasses for to-one relationships
  • List<T: Object> for to-many relationships

Querying

You can gets Results of an Object subclass via tha objects(_:) free function or the objects(_:) instance method on Realm.

Relationships

See our Cocoa guide for more details.

Initializers

  • Returns or sets the value of the property with the given name.

    Declaration

    Swift

    public subscript(key: String) -> AnyObject?
    Show on GitHub

  • Initialize a standalone (unpersisted) Object. Call add(_:) on a Realm to add standalone objects to a realm.

    Declaration

    Swift

    public required override init()
    Show on GitHub

  • Initialize a standalone (unpersisted) Object with values from an Array<AnyObject> or Dictionary<String, AnyObject>. Call add(_:) on a Realm to add standalone objects to a realm.

    Declaration

    Swift

    public init(value: AnyObject)
    Show on GitHub

Properties

  • The Realm this object belongs to, or nil if the object does not belong to a realm (the object is standalone).

    Declaration

    Swift

    public var realm: Realm?
    Show on GitHub

  • The ObjectSchema which lists the persisted properties for this object.

    Declaration

    Swift

    public var objectSchema: ObjectSchema
    Show on GitHub

  • Indicates if an object can no longer be accessed.

    Declaration

    Swift

    public override var invalidated: Bool { return super.invalidated }
    Show on GitHub

  • Returns a human-readable description of this object.

    Declaration

    Swift

    public override var description: String { return super.description }
    Show on GitHub

  • Helper to return the class name for an Object subclass.

    Declaration

    Swift

    public final override var className: String { return "" }
    Show on GitHub

  • Undocumented

    Declaration

    Swift

    public class Object: RLMObjectBase

Object Customization

  • Override to designate a property as the primary key for an Object subclass. Only properties of type String and Int can be designated as the primary key. Primary key properties enforce uniqueness for each value whenever the property is set which incurs some overhead. Indexes are created automatically for primary key properties.

    Declaration

    Swift

    public class func primaryKey() -> String? { return nil }
    Show on GitHub

  • Override to return an array of property names to ignore. These properties will not be persisted and are treated as transient.

    Declaration

    Swift

    public class func ignoredProperties() -> [String] { return [] }
    Show on GitHub

  • Return an array of property names for properties which should be indexed. Only supported for string and int properties.

    Declaration

    Swift

    public class func indexedProperties() -> [String] { return [] }
    Show on GitHub

Inverse Relationships

  • Get an Array of objects of type className which have this object as the given property value. This can be used to get the inverse relationship value for Object and List properties.

    Declaration

    Swift

    public func linkingObjects<T: Object>(type: T.Type, forProperty propertyName: String) -> [T]
    Show on GitHub

Equatable

  • Returns whether both objects are equal. Objects are considered equal when they are both from the same Realm and point to the same underlying object in the database.

    Declaration

    Swift

    public override func isEqual(object: AnyObject?) -> Bool
    Show on GitHub