write

Writes a chunk of data to the stream.

Writes data to the stream, beginning at the current position. The stream may be buffered, so use flush or close to be certain that any buffered changes have been applied. Throws a StreamNotOpenException if the stream is not open for writing. Throws a WriteAppendOnlyException if the platform only supports appending to the end of a value and the current stream position precedes the end of the value. Throws a WriteOverLengthException if the platform requires the length to be predetermined before writing and this write would exceed the predetermined length.

Syntax

- (void)write :(SUPString)data;

Parameters

data – The data chunk to be written to the stream.

Examples

– Writes to the biography file, and closes the file.
SUPSampleAuthor * author = [SUPSampleAuthor findByPrimaryKey:authorID]; SUPBigString *text = author.biography; NSString *stringToWrite = @"something"; [text openForWrite:[stringToWrite length]]; [text write:stringToWrite];