Platforms to show: All Mac Windows Linux Cross-Platform

NSStreamMBS class

Type Topic Plugin Version macOS Windows Linux iOS Targets
class Cocoa MBS MacBase Plugin 18.1 ✅ Yes ❌ No ❌ No ✅ Yes All
An abstract class representing a stream.

This class's interface is common to all Cocoa stream classes, including its concrete subclasses NSInputStream and NSOutputStream.
NSStream objects provide an easy way to read and write data to and from a variety of media in a device-independent way. You can create stream objects for data located in memory, in a file, or on a network (using sockets), and you can use stream objects without loading all of the data into memory at once.
By default, NSStream instances that are not file-based are non-seekable, one-way streams (although custom seekable subclasses are possible). Once the data has been provided or consumed, the data cannot be retrieved from the stream.
This is an abstract class. You can't create an instance, but you can get one from various plugin functions.

Status Constants

Constant Value Description
kStatusAtEnd 5 There is no more data to read, or no more data can be written to the stream. When this status is returned, the stream is in a “non-blocking” mode and no data are available.
kStatusClosed 6 The stream is closed (close has been called on it).
kStatusError 7 The remote end of the connection can’t be contacted, or the connection has been severed for some other reason.
kStatusNotOpen 0 The stream is not open for reading or writing. This status is returned before the underlying call to open a stream but after it’s been created.
kStatusOpen 2 The stream is open, but no reading or writing is occurring.
kStatusOpening 1 The stream is in the process of being opened for reading or for writing. For network streams, this status might include the time after the stream was opened, but while network DNS resolution is happening.
kStatusReading 3 Data is being read from the stream. This status would be returned if code on another thread were to call
Status on the stream while a read() was in progress.
kStatusWriting 4 Data is being written to the stream. This status would be returned if code on another thread were to call
Status on the stream while a write() was in progress.

Sub classes:

Blog Entries

Release notes


The items on this page are in the following plugins: MBS MacBase Plugin.


NSStepperMBS   -   NSSwitchMBS


The biggest plugin in space...