NSMutableDictionary category

Each method in the NSMutableDictionary category corresponds to a method in the NSMutableDictionary class, but provides a secure version of the functionality. For more information about the functionality and usage, see NSMutableDictionary in developer.apple.com.

Note The Following:  

• The url parameter in the category methods must be a file URL, and point to a regular file.
• The category methods return an NSError object. The methods set the properties on the object as described in NSError objects that secure Objective-C methods return.

The following table shows each added method and its corresponding method in NSMutableDictionary.

Table 1. NSMutableDictionary category methods

Method in category

Corresponding method in NSMutableDictionary

 
+ (id)
   dictionaryWithContentsOfSecureFile:
   (NSString *)path
   error:(
      NSError *__autoreleasing *)error;
 
+ (id)dictionaryWithContentsOfFile:
   (NSString *)path;
 
+ (id)
   dictionaryWithContentsOfSecureURL:
   (NSURL *)aURL
   error:(
      NSError *__autoreleasing *)error;
 
+ (id)dictionaryWithContentsOfURL:
   (NSURL *)aURL;
 
 
- (id)initWithContentsOfSecureFile:
   (NSString *)path
   error:(
      NSError *__autoreleasing *)error;
 
- (id)initWithContentsOfFile:
   (NSString *)path;
 
 
- (id)initWithContentsOfSecureURL:
   (NSURL *)aURL
   error:(
      NSError *__autoreleasing *)error;
 
- (id)initWithContentsOfURL:
   (NSURL *)aURL;
 
 
- (BOOL)writeToSecureFile:
   (NSString *)path 
   atomically:(BOOL)flag
   error:(
      NSError *__autoreleasing *)error;
 
- (BOOL)writeToFile:
   (NSString *)path 
   atomically:(BOOL)flag;
 
 
- (BOOL)writeToSecureURL:
   (NSURL *)aURL 
   atomically:(BOOL)flag
   error:(
      NSError *__autoreleasing *)error;
 
- (BOOL)writeToURL:
   (NSURL *)aURL 
   atomically:(BOOL)flag;
 

For a code example, see NSMutableDictionary category.