KLFBlockProcess Class Reference

A QProcess subclass for code-blocking process execution. More...

#include <klfblockprocess.h>

List of all members.

Public Slots

bool startProcess (QStringList cmd, QByteArray stdindata, QStringList env=QStringList())
bool startProcess (QStringList cmd, QCString str, QStringList env=QStringList())
bool startProcess (QStringList cmd, QStringList env=QStringList())
QString readStdoutString ()
QString readStderrString ()

Public Member Functions

 KLFBlockProcess (QObject *parent=0)
 ~KLFBlockProcess ()
QByteArray getAllStderr ()
QByteArray getAllStdout ()


Detailed Description

A QProcess subclass for code-blocking process execution.

A Code-blocking (but not GUI-blocking) process executor

Use for example like:

   KLFBlockProcess proc;
   QStringList args;
   args << "ls" << "/dev";
   proc.startProcess(args);
   QString alldevices = proc.readStdoutString();

This class provides functionality for passing data to STDIN and getting data from STDOUT and STDERR afterwards.

Author:
Philippe Faist <philippe.faist@bluewin.ch>

Definition at line 56 of file klfblockprocess.h.


Constructor & Destructor Documentation

KLFBlockProcess::KLFBlockProcess QObject *  parent = 0  ) 
 

Normal constructor, like QProcess constructor

Definition at line 29 of file klfblockprocess.cpp.

KLFBlockProcess::~KLFBlockProcess  ) 
 

Normal destructor

Definition at line 40 of file klfblockprocess.cpp.


Member Function Documentation

QByteArray KLFBlockProcess::getAllStderr  ) 
 

Returns all standard error output as a QByteArray. This function is to standardize the readStderr() and readAllStandardError() functions in QT 3 or QT 4 respectively

Definition at line 67 of file klfblockprocess.h.

QByteArray KLFBlockProcess::getAllStdout  ) 
 

Returns all standard output as a QByteArray. This function is to standardize the readStdout() and readAllStandardOutput() functions in QT 3 or QT 4 respectively

Definition at line 77 of file klfblockprocess.h.

bool KLFBlockProcess::startProcess QStringList  cmd,
QByteArray  stdindata,
QStringList  env = QStringList()
[slot]
 

Starts cmd (which is a list of arguments, the first being the program itself) and blocks until process stopped. The QT event loop is updated regularly so that the GUI doesn't freeze.

Read result with QProcess::readStdout() and QProcess::readStderr(), get process exit info with QProcess::normalExit() and QProcess::exitStatus().

Returns:
TRUE upon success, FALSE upon failure.

Definition at line 66 of file klfblockprocess.cpp.

Referenced by startProcess().

bool KLFBlockProcess::startProcess QStringList  cmd,
QCString  str,
QStringList  env = QStringList()
[slot]
 

Convenient function if you want to pass string input to program This mostly truncates the last '\0' because programs don't like it.

Warning:
this function is only available with QT 3.

Definition at line 56 of file klfblockprocess.cpp.

References startProcess().

bool KLFBlockProcess::startProcess QStringList  cmd,
QStringList  env = QStringList()
[slot]
 

Convenient function to be used in the case where program doesn't expect stdin data or if you chose to directly close stdin without writing anything to it.

Definition at line 61 of file klfblockprocess.cpp.

References startProcess().

QString KLFBlockProcess::readStdoutString  )  [slot]
 

Like QProcess::readStdout(), except returns a QString instead of a QByteArray

Definition at line 131 of file klfblockprocess.h.

QString KLFBlockProcess::readStderrString  )  [slot]
 

Like QProcess::readStderr(), except returns a QString instead of a QByteArray

Definition at line 139 of file klfblockprocess.h.


The documentation for this class was generated from the following files:
Generated on Sat Apr 28 14:14:02 2007 for KLatexFormula-Library-Backend by  doxygen 1.4.6