process Class Reference

The process class manages an asynchronous process with redirected IO. More...

#include <process.hpp>

Public Member Functions
	process (process const &)=delete
process &	operator= (process const &)=delete
bool	spawn (native_string const &cmd, std::vector< native_string > const &args=std::vector< native_string >())
	Start the process. More...
void	kill ()
	Stops the spawned process. More...
int	read (char *buffer, unsigned int len)
	Read data from process. More...
bool	write (char const *buffer, unsigned int len)
	Write data data process. More...
bool	write (std::string const &s)

Detailed Description

The process class manages an asynchronous process with redirected IO.

No console window is being created.

To use, spawn the process and, since it's blocking, call read from a different thread.

Examples:

process.cpp.

Member Function Documentation

kill()

void kill

(

)

Stops the spawned process.

This function doesn't actually kill the process, it merely closes the pipes.

Blocks until the process has quit.

read()

int read	(	char *	buffer,
		unsigned int	len
	)

Read data from process.

This function blocks

Returns

>0 Number of octets read, can be less than requested

0 on EOF

-1 on error.

Examples:

process.cpp.

spawn()

bool spawn	(	native_string const &	cmd,
		std::vector< native_string > const &	args = std::vector< native_string >()
	)

Start the process.

This function takes care of properly quoting and escaping the the program's path and its arguments. Fails if process has already been spawned.

Parameters

cmd	The path of the program to execute
args	The command-line arguments for the process.

Note

May return true even if the process cannot be started. In that case, trying to read from the process will fail with an error or EOF.

Examples:

process.cpp.

write()

bool write	(	char const *	buffer,
		unsigned int	len
	)

Write data data process.

This function blocks

Returns

true if all octets have been written.

false on error.

Examples:

process.cpp.

---

The documentation for this class was generated from the following file:

• process.hpp