RLMObjectId

@interface RLMObjectId : NSObject

A 12-byte (probably) unique object identifier.

ObjectIds are similar to a GUID or a UUID, and can be used to uniquely identify objects without a centralized ID generator. An ObjectID consists of:

  1. A 4 byte timestamp measuring the creation time of the ObjectId in seconds since the Unix epoch.
  2. A 5 byte random value
  3. A 3 byte counter, initialized to a random value.

ObjectIds are intended to be fast to generate. Sorting by an ObjectId field will typically result in the objects being sorted in creation order.

  • Creates a new randomly-initialized ObjectId.

    Declaration

    Objective-C

    + (nonnull instancetype)objectId;
    Show on GitHub

  • Creates a new zero-initialized ObjectId.

    Declaration

    Objective-C

    - (nonnull instancetype)init;
    Show on GitHub

  • Creates a new ObjectId from the given 24-byte hexadecimal string.

    Returns nil and sets error if the string is not 24 characters long or contains any characters other than 0-9a-fA-F.

    Declaration

    Objective-C

    - (nullable instancetype)initWithString:(nonnull NSString *)string
                                  error:(NSError *_Nullable *_Nullable)error;

    Parameters

    string

    The string to parse.
    Show on GitHub

  • Get the ObjectId as a 24-character hexadecimal string.

    Declaration

    Objective-C

    @property (readonly, nonatomic) NSString *_Nonnull stringValue;
    Show on GitHub