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 DITRGA if possible, otherwise the return value will be nil.

    Note that the returned type, DITRGA, is deprecated and does not allow any mutation. RGAs cannot be created or mutated with this version of the SDK; they can only be read and this is for backwards compatibility reasons.

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

    Declaration

    Objective-C

    @property (nonatomic, readonly, nullable) DITRGA *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;