typedef pbase_type::pmode pmode

Type used to specify how to connect to the process. typedef pbase_type::argv_type argv_type

Type used to hold the arguments for a command. typedef int fd_type

Type used for file descriptors. typedef int fd_type

Type used for file descriptors.

basic_opstream ()

Default constructor, creates an uninitialised stream. basic_opstream (const std::string &command, pmode mode=pstdin)

Constructor that initialises the stream by starting a process. basic_opstream (const std::string &file, const argv_type &argv, pmode mode=pstdin)

Constructor that initialises the stream by starting a process. ~basic_opstream ()

Destructor. void open (const std::string &command, pmode mode=pstdin)

Start a process. void open (const std::string &file, const argv_type &argv, pmode mode=pstdin)

Start a process. void close ()

Close the pipe. bool is_open () const

Report whether the stream's buffer has been initialised. const std::string & command () const

Return the command used to initialise the stream. streambuf_type * rdbuf () const

Return a pointer to the stream buffer.

static const pmode pstdin = std::ios_base::out

Write to stdin. static const pmode pstdout = std::ios_base::in

Read from stdout. static const pmode pstderr = std::ios_base::app

Read from stderr. static const pmode pstdin = std::ios_base::out

Write to stdin. static const pmode pstdout = std::ios_base::in

Read from stdout. static const pmode pstderr = std::ios_base::app

Read from stderr.

typedef basic_pstreambuf< CharT, Traits > streambuf_type

enum { bufsz = 32 }

enum { pbsz = 2 }

enum { bufsz = 32 }

enum { pbsz = 2 }

void do_open (const std::string &command, pmode mode)

Start a process. void do_open (const std::string &file, const argv_type &argv, pmode mode)

Start a process.

std::string command_

The command used to start the process. streambuf_type buf_

The stream buffer.

(Note that these are not member functions.) std::basic_ostream< C, T > & peof (std::basic_ostream< C, T > &s)

Manipulator to close the pipe connected to the process' stdin.

Class template for Output PStreams.

Writing to an open opstream writes to the standard input of the command; the command's standard output is the same as that of the process that created the pstream object, unless altered by the command itself.

Constructor that initialises the stream by starting a process.

Initialises the stream buffer by calling do_open() with the supplied arguments.

Parameters: command a string containing a shell command.

mode the I/O mode to use when opening the pipe.

See also: do_open(const std::string&, pmode)

Constructor that initialises the stream by starting a process.

Initialises the stream buffer by calling do_open() with the supplied arguments.

Parameters: file a string containing the pathname of a program to execute.

argv a vector of argument strings passed to the new program.

mode the I/O mode to use when opening the pipe.

See also: do_open(const std::string&, const argv_type&, pmode)

Destructor.

Closes the stream and waits for the child to exit.

Close the pipe.

Calls rdbuf->close() and sets failbit on error.

Return the command used to initialise the stream.

Returns: a string containing the command used to initialise the stream.

Start a process.

Calls rdbuf()->open( file, argv, mode ) and sets failbit on error.

Parameters: file a string containing the pathname of a program to execute.

argv a vector of argument strings passed to the new program.

mode the I/O mode to use when opening the pipe.

See also: basic_pstreambuf::open(const std::string&, const argv_type&, pmode)

Start a process.

Calls rdbuf()->open( command , mode ) and sets failbit on error.

Parameters: command a string containing a shell command.

mode the I/O mode to use when opening the pipe.

See also: basic_pstreambuf::open(const std::string&, pmode)

Report whether the stream's buffer has been initialised.

Returns: rdbuf()->is_open().

See also: basic_pstreambuf::is_open()

Start a process.

Calls do_open( file , argv , mode|pstdin ).

Parameters: file a string containing the pathname of a program to execute.

argv a vector of argument strings passed to the new program.

mode the I/O mode to use when opening the pipe.

See also: do_open(const std::string&, const argv_type&, pmode)

Start a process.

Calls do_open( command , mode|pstdin ).

Parameters: command a string containing a shell command.

mode the I/O mode to use when opening the pipe.

See also: do_open(const std::string&, pmode)

Return a pointer to the stream buffer.

Returns: a pointer to the private stream buffer member.

Manipulator to close the pipe connected to the process' stdin.

When inserted into an output pstream the manipulator calls basic_pstreambuf<C,T>::peof() to close the output pipe, causing the child process to receive the end-of-file indicator on subsequent reads from its stdin stream.

Parameters: s An output PStream class.

Returns: The stream object the manipulator was invoked on.

See also: basic_pstreambuf<C,T>::peof() basic_pstream basic_rpstream