NSStream documentation

inputStreamWithData:

+ (id) inputStreamWithData: (NSData*)data;

Availability: MacOS-X 10.4.0, Base 1.2.0

Creates and returns an initialized NSInputStream object for reading from data.

inputStreamWithFileAtPath:

+ (id) inputStreamWithFileAtPath: (NSString*)path;

Availability: MacOS-X 10.4.0, Base 1.2.0

Creates and returns an initialized NSInputStream object that reads data from the file at the specified path.

inputStreamWithURL:

+ (id) inputStreamWithURL: (NSURL*)url;

Availability: MacOS-X 10.4.0, Base 1.2.0

Creates and returns an initialized NSInputStream object that reads data from the specified URL.

getBuffer: length:

- (BOOL) getBuffer: (uint8_t**)buffer length: (NSUInteger*)len;

Availability: MacOS-X 10.4.0, Base 1.2.0

Returns a pointer to the read buffer in buffer and, by reference, the number of bytes available in len.

hasBytesAvailable

- (BOOL) hasBytesAvailable;

Availability: MacOS-X 10.4.0, Base 1.2.0

Returns YES if the receiver has bytes available to read. The receiver may also return YES if a read must be attempted in order to determine the availability of bytes.

initWithData:

- (id) initWithData: (NSData*)data;

Availability: MacOS-X 10.4.0, Base 1.2.0

Returns an initialized NSInputStream object for reading from data.

initWithFileAtPath:

- (id) initWithFileAtPath: (NSString*)path;

Availability: MacOS-X 10.4.0, Base 1.2.0

Returns an initialized NSInputStream object for reading from the file at the specified path.

initWithURL:

- (id) initWithURL: (NSURL*)url;

Availability: MacOS-X 10.4.0, Base 1.2.0

Returns an initialized NSInputStream object for reading from the specified URL.

read: maxLength:

- (NSInteger) read: (uint8_t*)buffer maxLength: (NSUInteger)len;

Availability: MacOS-X 10.4.0, Base 1.2.0

Reads up to len bytes into buffer, returning the actual number of bytes read.

Software documentation for the NSOutputStream class

NSOutputStream : NSStream

outputStreamToBuffer: capacity:

+ (id) outputStreamToBuffer: (uint8_t*)buffer capacity: (NSUInteger)capacity;

Availability: MacOS-X 10.4.0, Base 1.2.0

Creates and returns an initialized NSOutputStream object that can write to buffer, up to a maximum of capacity bytes.

outputStreamToFileAtPath: append:

+ (id) outputStreamToFileAtPath: (NSString*)path append: (BOOL)shouldAppend;

Availability: MacOS-X 10.4.0, Base 1.2.0

Creates and returns an initialized NSOutputStream object for writing to the file specified by path.

outputStreamToMemory

+ (id) outputStreamToMemory;

Availability: MacOS-X 10.4.0, Base 1.2.0

Creates and returns an initialized NSOutputStream object that will write stream data to memory.

hasSpaceAvailable

- (BOOL) hasSpaceAvailable;

Availability: MacOS-X 10.4.0, Base 1.2.0

Returns YES if the receiver can be written to, or if a write must be attempted in order to determine if space is available.

initToBuffer: capacity:

- (id) initToBuffer: (uint8_t*)buffer capacity: (NSUInteger)capacity;

Availability: MacOS-X 10.4.0, Base 1.2.0

Returns an initialized NSOutputStream object that can write to buffer, up to a maximum of capacity bytes.

initToFileAtPath: append:

- (id) initToFileAtPath: (NSString*)path append: (BOOL)shouldAppend;

Availability: MacOS-X 10.4.0, Base 1.2.0

Returns an initialized NSOutputStream object for writing to the file specified by path.
If shouldAppend is YES, newly written data will be appended to any existing file contents.

initToMemory

- (id) initToMemory;

Availability: MacOS-X 10.4.0, Base 1.2.0

Returns an initialized NSOutputStream object that will write to memory.

write: maxLength:

- (NSInteger) write: (const uint8_t*)buffer maxLength: (NSUInteger)len;

Availability: MacOS-X 10.4.0, Base 1.2.0

Writes the contents of buffer, up to a maximum of len bytes, to the receiver.

Software documentation for the NSStream class

NSStream : NSObject

getStreamsToHost: port: inputStream: outputStream:

+ (void) getStreamsToHost: (NSHost*)host port: (NSInteger)port inputStream: (NSInputStream**)inputStream outputStream: (NSOutputStream**)outputStream;

Availability: MacOS-X 10.4.0, Base 1.2.0

Creates and returns by reference an NSInputStream object and NSOutputStream object for a socket connection with the specified port on host.

close

- (void) close;

Availability: MacOS-X 10.4.0, Base 1.2.0

Closes the receiver.
Repeated calls to this method on the same stream are quietly ignored.

delegate

- (id) delegate;

Availability: MacOS-X 10.4.0, Base 1.2.0

Returns the receiver's delegate.

open

- (void) open;

Availability: MacOS-X 10.4.0, Base 1.2.0

Opens the receiving stream.
Upon completion of the open operation, an NSStreamEventOpenCompleted event is sent to the recevier's delegate.
Repeated calls to this method on the same stream are quietly ignored.

propertyForKey:

- (id) propertyForKey: (NSString*)key;

Availability: MacOS-X 10.4.0, Base 1.2.0

Returns the receiver's property for the specified key.

removeFromRunLoop: forMode:

- (void) removeFromRunLoop: (NSRunLoop*)aRunLoop forMode: (NSString*)mode;

Availability: MacOS-X 10.4.0, Base 1.2.0

Removes the receiver from the NSRunLoop specified by aRunLoop running in the mode.
Attempts to remove the receiver from a run loop or a mode in which it has not been scheduled are quietly ignored.

scheduleInRunLoop: forMode:

- (void) scheduleInRunLoop: (NSRunLoop*)aRunLoop forMode: (NSString*)mode;

Availability: MacOS-X 10.4.0, Base 1.2.0

Schedules the receiver on aRunLoop using the specified mode.
You must not attempt to add a stream to more than one run loop, but you may call this method multiple times to add the receiver in different modes for the same run loop.