DITMutableDocumentPath

@interface DITMutableDocumentPath : NSObject

Provides an interface to specify a path to a key in a document that you can then call various update functions on. You obtain a DITMutableDocumentPath by subscripting a DITMutableDocument and you can then further subscript a DITMutbaleDocumentPath to further specify the key of the document that you want to update.

  • Used to specify a path to a key in the document that you can subscript further to access a nested key in the document and eventually perform an update operation on.

    Declaration

    Objective-C

    - (nonnull DITMutableDocumentPath *)objectForKeyedSubscript:
        (nonnull NSString *)key;

    Parameters

    key

    The next part of the path needed to get to the key in the document you wish to update.

    Return Value

    A DITMutableDocumentPath with the provided key incorporated into the path.

  • Used to specify an index in the array at the preceding key-path specified through the subscripting defined previously. You can subscript the return value further to access a further nested key in the document and eventually perform an update operation.

    Declaration

    Objective-C

    - (nonnull DITMutableDocumentPath *)objectAtIndexedSubscript:(NSUInteger)index;

    Parameters

    index

    The index of the array that you wish to access in the key previously specified with the preceding subscripting.

    Return Value

    A DITMutableDocumentPath with the provided index incorporated into the path.

  • Returns the value at the previously specified key in the document as an NSObject if possible, otherwise the return value will be nil.

    Declaration

    Objective-C

    @property (nonatomic, readonly, nullable) id value;
  • Returns the value at the previously specified key in the document as an NSString if possible, otherwise the return value will be nil.

    Declaration

    Objective-C

    @property (nonatomic, readonly, nullable) NSString *string;
  • Returns the value at the previously specified key in the document as an NSString. If the key was invalid the return value will be an empty string.

    Declaration

    Objective-C

    @property (nonatomic, readonly) NSString *_Nonnull stringValue;
  • Returns the value at the previously specified key in the document as a BOOL. If the key was invalid the return value will be false.

    Declaration

    Objective-C

    @property (nonatomic, readonly) BOOL booleanValue;
  • Returns the value at the previously specified key in the document as an NSInteger if possible, otherwise the return value will be 0.

    Declaration

    Objective-C

    @property (nonatomic, readonly) NSInteger integerValue;
  • Returns the value at the previously specified key in the document as an NSNumber if possible, otherwise the return value will be nil.

    Declaration

    Objective-C

    @property (nonatomic, readonly, nullable) NSNumber *number;
  • Returns the value at the previously specified key in the document as an NSNumber. If the key was invalid the return value will be an NSNumber with a value of 0.

    Declaration

    Objective-C

    @property (nonatomic, readonly) NSNumber *_Nonnull numberValue;
  • Returns the value at the previously specified key in the document as an NSArray if possible, otherwise the return value will be nil.

    Declaration

    Objective-C

    @property (nonatomic, readonly, nullable) NSArray *array;
  • Returns the value at the previously specified key in the document as an NSArray. If the key was invalid the return value will be an empty array.

    Declaration

    Objective-C

    @property (nonatomic, readonly) NSArray *_Nonnull arrayValue;
  • Returns the value at the previously specified key in the document as an NSDictionary if possible, otherwise the return value will be nil.

    Declaration

    Objective-C

    @property (nonatomic, readonly, nullable) NSDictionary<NSString *, id> *dictionary;
  • Returns the value at the previously specified key in the document as an NSDictionary. If the key was invalid the return value will be an empty dictionary.

    Declaration

    Objective-C

    @property (nonatomic, readonly) NSDictionary<NSString *, id> *_Nonnull dictionaryValue;
  • Returns the value at the previously specified key in the document as a DITAttachmentToken if possible, otherwise the return value will be nil.

    Declaration

    Objective-C

    @property (nonatomic, readonly, nullable) DITAttachmentToken *attachmentToken;
  • Returns the value at the previously specified key in the document as a DITMutableCounter if possible, otherwise the return value will be nil.

    Declaration

    Objective-C

    @property (nonatomic, readonly, nullable) DITMutableCounter *counter;
  • Returns the value at the previously specified key in the document as a DITMutableRegister if possible, otherwise the return value will be nil.

    Declaration

    Objective-C

    @property (nonatomic, readonly, nullable) DITMutableRegister *lwwRegister;
  • rga

    Deprecated

    DITRGA usage should be replaced. Use arrays inside DITRegisters instead.

    Returns the value at the previously specified key in the document as a DITMutableRGA if possible, otherwise the return value will be nil.

    Declaration

    Objective-C

    @property (nonatomic, readonly, nullable) DITMutableRGA *rga;
  • Set a value at the document’s key defined by the preceding subscripting.

    Declaration

    Objective-C

    - (void)set:(nonnull id)value isDefault:(BOOL)isDefault;

    Parameters

    value

    The value to set at the subscripting-defined document key.

    isDefault

    Represents whether or not the value should be set as a default value. Set this to true if you want to set a default value that you expect to be overwritten by other devices in the network. The default value is false.

  • Set a value at the document’s key defined by the preceding subscripting.

    Declaration

    Objective-C

    - (void)set:(nonnull id)value;

    Parameters

    value

    The value to set at the subscripting-defined document key.

  • Remove a value at the document’s key defined by the preceding subscripting. If removing an index from an array, any subsequent indexes will be shifted left to fill the gap.

    Declaration

    Objective-C

    - (void)remove;