Next: , Previous: Accessing the data stream, Up: Accessing the data stream


4.1 Creating a BPipe object

The first step in accessing a bpipe data stream is to create a BPipe object with bpipe_new. A BPipe object is a structure which contains all of the information necessary to manage a data stream. bpipe_new returns a pointer to the newly created BPipe object, which is used by most of the utility routines. The application can create as many BPipes as is required. Multiple BPipes are necessary when reading from multiple data streams. If multiple output streams are being written with input taken from a single data stream, only one BPipe is required. Only if there are multiple output streams which have substantially different formats are multiple BPipes needed.

See bpipe_new.