#include <pstream.h>
Public Types | |
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. | |
Public Member Functions | |
basic_pstream () | |
Default constructor, creates an uninitialised stream. | |
basic_pstream (const std::string &command, pmode mode=pstdout|pstdin) | |
Constructor that initialises the stream by starting a process. | |
basic_pstream (const std::string &file, const argv_type &argv, pmode mode=pstdout|pstdin) | |
Constructor that initialises the stream by starting a process. | |
~basic_pstream () | |
Destructor. | |
void | open (const std::string &command, pmode mode=pstdout|pstdin) |
Start a process. | |
void | open (const std::string &file, const argv_type &argv, pmode mode=pstdout|pstdin) |
Start a process. | |
basic_pstream & | out () |
Set streambuf to read from process' stdout . | |
basic_pstream & | err () |
Set streambuf to read from process' stderr . | |
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 Public Attributes | |
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. | |
Protected Types | |
typedef basic_pstreambuf < CharT, Traits > | streambuf_type |
enum | { bufsz = 32 } |
enum | { pbsz = 2 } |
enum | { bufsz = 32 } |
enum | { pbsz = 2 } |
Protected Member Functions | |
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. | |
Protected Attributes | |
std::string | command_ |
The command used to start the process. | |
streambuf_type | buf_ |
The stream buffer. |
Writing to a pstream opened with pmode
pstdin
writes to the standard input of the command. Reading from a pstream opened with pmode
pstdout
and/or pstderr
reads the command's standard output and/or standard error. Any of the process' stdin
, stdout
or stderr
that is not connected to the pstream (as specified by the pmode
) will be the same as the process that created the pstream object, unless altered by the command itself.
redi::basic_pstream< CharT, Traits >::basic_pstream | ( | const std::string & | command, | |
pmode | mode = pstdout|pstdin | |||
) | [inline] |
Constructor that initialises the stream by starting a process.
Initialises the stream buffer by calling do_open() with the supplied arguments.
command | a string containing a shell command. | |
mode | the I/O mode to use when opening the pipe. |
redi::basic_pstream< CharT, Traits >::basic_pstream | ( | const std::string & | file, | |
const argv_type & | argv, | |||
pmode | mode = pstdout|pstdin | |||
) | [inline] |
Constructor that initialises the stream by starting a process.
Initialises the stream buffer by calling do_open() with the supplied arguments.
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. |
redi::basic_pstream< CharT, Traits >::~basic_pstream | ( | ) | [inline] |
Destructor.
Closes the stream and waits for the child to exit.
basic_pstream& redi::basic_pstream< CharT, Traits >::err | ( | ) | [inline] |
Set streambuf to read from process' stderr
.
*this
References redi::pstream_common< CharT, Traits >::buf_, and redi::basic_pstreambuf< CharT, Traits >::read_err().
void redi::basic_pstream< CharT, Traits >::open | ( | const std::string & | file, | |
const argv_type & | argv, | |||
pmode | mode = pstdout|pstdin | |||
) | [inline] |
Start a process.
Calls do_open( file , argv , mode ).
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. |
References redi::pstream_common< CharT, Traits >::do_open().
void redi::basic_pstream< CharT, Traits >::open | ( | const std::string & | command, | |
pmode | mode = pstdout|pstdin | |||
) | [inline] |
Start a process.
Calls do_open( command , mode ).
command | a string containing a shell command. | |
mode | the I/O mode to use when opening the pipe. |
References redi::pstream_common< CharT, Traits >::do_open().
basic_pstream& redi::basic_pstream< CharT, Traits >::out | ( | ) | [inline] |
Set streambuf to read from process' stdout
.
*this
References redi::pstream_common< CharT, Traits >::buf_, and redi::basic_pstreambuf< CharT, Traits >::read_err().