This class is used to read and write data to and from an open file or open communications channel, such as a networking socket. The class provides methods for working with files, and contains methods and notifications useful for implementing asynchronous background socket communication.

@interface NSFileHandle : NSObject
// Initializers
- (id)initWithFileDescriptor:(int)fd;
- (id)initWithFileDescriptor:(int)fd closeOnDealloc:(BOOL)closeopt;
- (id)initWithNativeHandle:(void *)nativeHandle;
- (id)initWithNativeHandle:(void *)nativeHandle closeOnDealloc:(BOOL)closeopt;
// Class Methods
+ (id)fileHandleForReadingAtPath:(NSString *)path;
+ (id)fileHandleForUpdatingAtPath:(NSString *)path;
+ (id)fileHandleForWritingAtPath:(NSString *)path;
+ (id)fileHandleWithNullDevice;
+ (id)fileHandleWithStandardError;
+ (id)fileHandleWithStandardInput;
+ (id)fileHandleWithStandardOutput;
// Instance Methods
- (void)acceptConnectionInBackgroundAndNotify;
- (void)acceptConnectionInBackgroundAndNotifyForModes:(NSArray *)modes;
- (NSData *)availableData;
- (void)closeFile;
- (int)fileDescriptor;
- (void *)nativeHandle;
- (unsigned long long)offsetInFile;
- (NSData *)readDataOfLength:(unsigned int)length;
- (NSData *)readDataToEndOfFile;
- (void)readInBackgroundAndNotify;
- (void)readInBackgroundAndNotifyForModes:(NSArray *)modes;
- (void)readToEndOfFileInBackgroundAndNotify;
- (void)readToEndOfFileInBackgroundAndNotifyForModes:(NSArray *)modes;
- (unsigned long long)seekToEndOfFile;
- (void)seekToFileOffset:(unsigned long long)offset;
- (void)synchronizeFile;
- (void)truncateFileAtOffset:(unsigned long long)offset;
- (void)waitForDataInBackgroundAndNotify;
- (void)waitForDataInBackgroundAndNotifyForModes:(NSArray *)modes;
- (void)writeData:(NSData *)data;