QChildProcess.h

Go to the documentation of this file.

/********************************************************************************
*                                                                               *
*                           Child Process i/o device                            *
*                                                                               *
*********************************************************************************
*        Copyright (C) 2007 by Niall Douglas.   All Rights Reserved.            *
*       NOTE THAT I DO NOT PERMIT ANY OF MY CODE TO BE PROMOTED TO THE GPL      *
*********************************************************************************
* This code is free software; you can redistribute it and/or modify it under    *
* the terms of the GNU Library General Public License v2.1 as published by the  *
* Free Software Foundation EXCEPT that clause 3 does not apply ie; you may not  *
* "upgrade" this code to the GPL without my prior written permission.           *
* Please consult the file "License_Addendum2.txt" accompanying this file.       *
*                                                                               *
* This code is distributed in the hope that it will be useful,                  *
* but WITHOUT ANY WARRANTY; without even the implied warranty of                *
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.                          *
*********************************************************************************
* $Id:                                                                          *
********************************************************************************/


#ifndef QCHILDPROCESS_H
#define QCHILDPROCESS_H
#include "QIODeviceS.h"
#include "FXString.h"

namespace FX {

struct QChildProcessPrivate;
class FXAPIR QChildProcess : public QIODeviceS
{
    QChildProcessPrivate *p;
    QChildProcess(const QChildProcess &);
    QChildProcess &operator=(const QChildProcess &);
    virtual FXDLLLOCAL void *int_getOSHandle() const;
    FXDLLLOCAL void int_killChildI(bool);
public:
    enum ReadChannel
    {
        StdOut=1,       
        StdErr=2,       
        Combined=3      
    };
public:
    QChildProcess();
    QChildProcess(const FXString &command, const FXString &args=FXString::nullStr(), ReadChannel channel=Combined);
    ~QChildProcess();

    const FXString &command() const;
    void setCommand(const FXString &command);
    FXString arguments() const;
    void setArguments(const FXString &args);
    FXString workingDir() const;
    void setWorkingDir(const FXString &dir);
    ReadChannel readChannel() const throw();
    void setReadChannel(ReadChannel channel);

    FXlong returnCode() const throw();
    void detach();
    bool waitForExit(FXuint waitfor=FXINFINITE);
    bool terminate();
private:
    bool create(FXuint mode=IO_ReadWrite);
public:
    bool open(FXuint mode=IO_ReadWrite);
    void close();
    void flush();

    FXfval size() const;

    FXuval readBlock(char *data, FXuval maxlen);
    FXuval writeBlock(const char *data, FXuval maxlen);

    int ungetch(int);
};

} // namespace

#endif

---

(C) 2002-2009 Niall Douglas. Some parts (C) to assorted authors.