Fix buffered reads.

[catagits/fcgi2.git] / include / fcgio.h

//
// Provides support for FastCGI via C++ iostreams.\r
//\r
// $Id: fcgio.h,v 1.8 2001/11/21 20:18:13 robs Exp $
//
// This work is based on routines written by George Feinberg. They
// have been mostly re-written and extensively changed by
// Michael Richards.
//
// Rewritten again with bug fixes and numerous enhancements by
// Michael Shell.\r
// \r
// And rewritten again by Rob Saccoccio. 
//
// Special Thanks to Dietmar Kuehl for his help and the numerous custom
// streambuf examples on his web site.
//
// Copyright (c) 2000 Tux the Linux Penguin\r
// Copyright (c) 2001 Rob Saccoccio and Chelsea Networks
//
// You are free to use this software without charge or royalty
// as long as this notice is not removed or altered, and recognition
// is given to the author(s)
//
// This code is offered as-is without any warranty either expressed or
// implied; without even the implied warranty of MERCHANTABILITY or
// FITNESS FOR A PARTICULAR PURPOSE.  If it breaks, you get to keep \r
// both halves.

#ifndef FCGIO_H
#define FCGIO_H

#include <iostream.h>

#include "fcgiapp.h"

#ifndef DLLAPI
#ifdef _WIN32
#define DLLAPI __declspec(dllimport)
#else
#define DLLAPI
#endif
#endif

/*
 *  fcgi_streambuf
 */
class fcgi_streambuf : public streambuf
{
public:

    // Note that if no buf is assigned (the default), iostream methods\r
    // such as peek(), unget() and putback() will fail.  If a buf is\r
    // assigned, I/O is a bit less effecient and output streams will\r
    // have to be flushed (or the streambuf destroyed) before the next \r
    // call to "accept".\r
    DLLAPI fcgi_streambuf(FCGX_Stream * fcgx, char * buf, int len);\r
    \r
    DLLAPI fcgi_streambuf(char * buf, int len);\r
    \r
    DLLAPI fcgi_streambuf(FCGX_Stream * fcgx = NULL);\r

    DLLAPI ~fcgi_streambuf(void);

    DLLAPI int attach(FCGX_Stream * fcgx);

    // Consume the put area (if buffered) and c (if c is not EOF).
    DLLAPI virtual int overflow(int);

    // Flush the put area (if buffered) and the FCGX buffer to the client.\r
    // Note: sync() is protected in some implementations.
    DLLAPI virtual int sync();

    // Fill the get area (if buffered) and return the next character.
    DLLAPI virtual int underflow();

    // Use a buffer.  The only reasons that a buffer would be useful is\r
    // to support the use of the unget()/putback() or seek() methods.  Using\r
    // a buffer will result in less efficient I/O.  Note: the underlying\r
    // FastCGI library (FCGX) maintains its own input and output buffers.  \r
    // Note: setbuf() is protected in some implementations.
    DLLAPI virtual streambuf * setbuf(char * buf, int len);

    DLLAPI virtual int xsgetn(char * s, int n);\r
    DLLAPI virtual int xsputn(const char * s, int n);\r

private:

    FCGX_Stream * fcgx;

    // buf is just handy to have around\r
    char * buf;\r
\r
    // this isn't kept by the base class\r
    int bufsize;
    \r
    void init(FCGX_Stream * fcgx, char * buf, int bufsize);\r
\r
    void reset(void);\r
};

/*
 *  fcgi_istream - deprecated
 */
class fcgi_istream : public istream
{
public:

    // deprecated
    DLLAPI fcgi_istream(FCGX_Stream * fcgx = NULL);
    
    // deprecated
    DLLAPI ~fcgi_istream(void) {}

    // deprecated
    DLLAPI virtual void attach(FCGX_Stream * fcgx);

private:

    fcgi_streambuf fcgi_strmbuf;
};

/*
 *  fcgi_ostream - deprecated
 */
class fcgi_ostream : public ostream
{
public:
    
    // deprecated
    DLLAPI fcgi_ostream(FCGX_Stream * fcgx = NULL);
    
    // deprecated
    DLLAPI ~fcgi_ostream(void) {}

    // deprecated
    DLLAPI virtual void attach(FCGX_Stream *fcgx);

private:

    fcgi_streambuf fcgi_strmbuf;
};

#endif /* FCGIO_H */