The NSRelationshipDescription class is used to describe relationships of an entity in an NSEntityDescription object.


NSRelationshipDescription extends NSPropertyDescription to describe features appropriate to relationships, including cardinality (the number of objects allowed in the relationship), the destination entity, and delete rules.


The maximum and minimum counts for a relationship indicate the number of objects referenced (1/1 for a to-one relationship, 0 means undefined). The counts are only enforced if the relationship value in the containing object is not nil. That is, optional relationships may have zero objects in the relationship, which might be less than the minimum count.

Editing Relationship Descriptions

Relationship descriptions are editable until they are used by an object graph manager. This allows you to create or modify them dynamically. However, once a description is used (when the managed object model to which it belongs is associated with a persistent store coordinator), it must not (indeed cannot) be changed. This is enforced at runtime: any attempt to mutate a model or any of its sub-objects after the model is associated with a persistent store coordinator causes an exception to be thrown. If you need to modify a model that is in use, create a copy, modify the copy, and then discard the objects with the old model.


Managing Type Information

var destinationEntity: NSEntityDescription?

The entity description of the receiver's destination.

var inverseRelationship: NSRelationshipDescription?

The relationship that represents the inverse of the receiver.

Getting and Setting Delete Rules

var deleteRule: NSDeleteRule

The delete rule of the receiver.


var maxCount: Int

The maximum count of the receiver.

var minCount: Int

The minimum count of the receiver.

var isToMany: Bool

A Boolean value that indicates whether the receiver represents a to-many relationship.


var isOrdered: Bool

Returns a Boolean value that indicates whether the receiver describes an ordered relationship.

Versioning Support

var versionHash: Data

The version hash for the receiver.



These constants define what happens to relationships when an object is deleted.