NSData Class Reference

Tasks

Creating Data Objects

• + data
• + dataWithBytes:length:
• + dataWithBytesNoCopy:length:
• + dataWithBytesNoCopy:length:freeWhenDone:
• + dataWithContentsOfFile:
• + dataWithContentsOfFile:options:error:
• + dataWithContentsOfURL:
• + dataWithContentsOfURL:options:error:
• + dataWithData:
• – initWithBytes:length:
• – initWithBytesNoCopy:length:
• – initWithBytesNoCopy:length:freeWhenDone:
• – initWithContentsOfFile:
• – initWithContentsOfFile:options:error:
• – initWithContentsOfURL:
• – initWithContentsOfURL:options:error:
• – initWithData:
• + dataWithContentsOfMappedFile: Deprecated in OS X v10.7
• – initWithContentsOfMappedFile: Deprecated in OS X v10.7

Accessing Data

• – bytes
• – description
• – getBytes:length:
• – getBytes:range:
• – subdataWithRange:
• – rangeOfData:options:range:
• – getBytes: Deprecated in OS X v10.6

Testing Data

• – isEqualToData:
• – length

Storing Data

• – writeToFile:atomically:
• – writeToFile:options:error:
• – writeToURL:atomically:
• – writeToURL:options:error:

enum {
   NSDataReadingMappedIfSafe = 1UL << 0,
   NSDataReadingUncached = 1UL << 1,
   NSDataReadingMappedAlways = 1UL << 3,
};
typedef NSUInteger NSDataReadingOptions;

enum {
   NSDataReadingMapped = NSDataReadingMappedIfSafe,
   NSMappedRead = NSDataReadingMapped,
   NSUncachedRead = NSDataReadingUncached
};

enum {
   NSDataWritingAtomic = 1UL << 0,
   NSDataWritingWithoutOverwriting = 1UL << 1,
   NSDataWritingFileProtectionNone = 0x10000000,
   NSDataWritingFileProtectionComplete = 0x20000000,
   NSDataWritingFileProtectionCompleteUnlessOpen = 0x30000000,
   NSDataWritingFileProtectionCompleteUntilFirstUserAuthentication = 0x40000000,
   NSDataWritingFileProtectionMask = 0xf0000000,
};
typedef NSUInteger NSDataWritingOptions;

enum {
   NSAtomicWrite = NSDataWritingAtomic
};

enum {
   NSDataSearchBackwards = 1UL << 0,
   NSDataSearchAnchored = 1UL << 1
};
typedef NSUInteger NSDataSearchOptions;