class KProcIO

Public Methods

•  KProcIO ( QTextCodec *codec = 0 )
•  ~KProcIO ()
• bool  start (RunMode runmode = NotifyOnExit, bool includeStderr = false)
• bool  writeStdin (const QString &line, bool AppendNewLine=TRUE)
• bool  writeStdin (const QCString &line, bool appendnewline)
• bool  writeStdin (const QByteArray &data)
• bool  fputs (const QString &line, bool AppendNewLine=TRUE)
• void  closeWhenDone ()
• int  readln (QString &line, bool autoAck=true, bool *partial=0)
• int  fgets (QString &line, bool autoAck=false)
• void  resetAll ()
• void  ackRead ()
• void  enableReadSignals (bool enable)

Signals

• void  readReady (KProcIO *)

Protected Methods

• void  controlledEmission ()
• virtual void  virtual_hook ( int id, void* data )

Protected Slots

• void  received (KProcess *proc, char *buffer, int buflen)
• void  sent (KProcess *)

Protected Members

• QPtrList outbuffer
• QCString recvbuffer
• QTextCodec *codec
• int rbi
• bool needreadsignal
• bool readsignalon
• bool writeready

Detailed Description

Starts the process.

The following problems could cause this function to return false:

• The process is already running.
• The command line argument list is empty.
• The starting of the process failed (could not fork).
• The executable was not found.

Parameters:

runmode	For a detailed description of the various run modes, have a look at the general description of the KProcess class.
includeStderr	If true, data from both stdout and stderr is listened to. If false, only stdout is listened to.

Returns: true on success, false on error

Reimplemented from KProcess.

Writes text to stdin of the process.

Parameters:

line	Text to write.
AppendNewLine	if true, a newline '\n' is appended.

Reimplemented from KProcess.

Reimplemented from KProcess.

Writes data to stdin of the process.

Parameters:

data	Data to write.

Reimplemented from KProcess.

closes stdin after all data has been send.

reads a line of text (up to and including '\n')

Use readln() in response to a readReady() signal. You may use it multiple times if more than one line of data is available. Be sure to use ackRead() when you have finished processing the readReady() signal. This informs KProcIO that you are ready for another readReady() signal.

readln() never blocks.

autoAck==TRUE makes these functions call ackRead() for you.

Parameters:

line	is used to store the line that was read.
autoAck	when true, ackRead() is called for you.
partial	when provided the line is returned even if it does not contain a '\n'. *partial will be set to false if the line contains a '\n' and false otherwise.

Returns: the number of characters read, or -1 if no data is available.

Reset the class. Doesn't kill the process.

Call this after you have finished processing a readReady() signal. This call need not be made in the slot that was signalled by readReady(). You won't receive any more readReady() signals until you acknowledge with ackRead(). This prevents your slot from being reentered while you are still processing the current data. If this doesn't matter, then call ackRead() right away in your readReady()-processing slot.

Turns readReady() signals on and off. You can turn this off at will and not worry about losing any data. (as long as you turn it back on at some point...)

[signal]

[protected]

[protected]

[protected]

[protected]

[protected]

[protected]

[protected]

[protected]

[protected slots slot]

[protected slots slot]

[protected virtual]

Reimplemented from KProcess.