SWIbufferedInputStream.hpp
上传用户:xqtpzdz
上传日期:2022-05-21
资源大小:1764k
文件大小:5k
源码类别:

xml/soap/webservice

开发平台:

Visual C++

  1. #ifndef SWIBUFFEREDINPUTSTREAM_HPP
  2. #define SWIBUFFEREDINPUTSTREAM_HPP
  3. /****************License************************************************
  4.  * Vocalocity OpenVXI
  5.  * Copyright (C) 2004-2005 by Vocalocity, Inc. All Rights Reserved.
  6.  * This program is free software; you can redistribute it and/or
  7.  * modify it under the terms of the GNU General Public License
  8.  * as published by the Free Software Foundation; either version 2
  9.  * of the License, or (at your option) any later version.
  10.  *  
  11.  * This program is distributed in the hope that it will be useful,
  12.  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  13.  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14.  * GNU General Public License for more details.
  15.  *
  16.  * You should have received a copy of the GNU General Public License
  17.  * along with this program; if not, write to the Free Software
  18.  * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
  19.  * Vocalocity, the Vocalocity logo, and VocalOS are trademarks or 
  20.  * registered trademarks of Vocalocity, Inc. 
  21.  * OpenVXI is a trademark of Scansoft, Inc. and used under license 
  22.  * by Vocalocity.
  23.  ***********************************************************************/
  24. #include "SWIfilterInputStream.hpp"
  25. class SWIUTIL_API_CLASS SWIbufferedInputStream: public SWIfilterInputStream
  26. {
  27.   // ................. CONSTRUCTORS, DESTRUCTOR  ............
  28.   //
  29.   // ------------------------------------------------------------
  30.   /**
  31.    * Provides buffering for non-buffered stream.
  32.    *
  33.    * @param stream The stream that is being wrapped.
  34.    * @param bufSize the size of the internal buffer.  This is also the size that will be used to call
  35.    * the stream's read operation.
  36.    * @param lookAhead The amount of look ahead characters that can be looked further.
  37.    * @param ownStream  If <code>true</code>, then the stream is deleted when this reader is deleted.
  38.    *
  39.    **/
  40.  public:
  41.   SWIbufferedInputStream(SWIinputStream * stream,
  42.             int bufSize = 1024,
  43.             int lookAhead = 10,
  44.             bool ownStream = true);
  45.   /**
  46.    * Destructor.
  47.    **/
  48.  public:
  49.   virtual ~SWIbufferedInputStream();
  50.   /**
  51.    * Reads one character from the stream.
  52.    * Returns either a positive number that can be cast to a char or a negative
  53.    * number representing an error.  See SWIstream.hpp for error codes.
  54.    **/
  55.  public:
  56.   virtual int read();
  57.   /**
  58.    * Reads the specified number of bytes into the specified buffer.
  59.    *
  60.    * Returns the number of bytes stored in the buffer.
  61.    **/
  62.  public:
  63.   virtual int readBytes(void *buffer, int bufSize);
  64.   /**
  65.    * Reads a line of text.  A line is considered to be terminated by any one
  66.    * of a line feed ('n'), a carriage return ('r'), or a carriage return
  67.    * followed immediately by a linefeed.  The carriage return and line feed
  68.    * are extracted from the stream but not stored.
  69.    *
  70.    * returns the number of characters in the string, or a negative number
  71.    * representing the cause of the error. See SWIstream.hpp for error codes.
  72.    * Note that function is lost in the case where the value returned is exactly
  73.    * <code>bufSize - 1</code>.  In this case, it is impossible to know whether the reading stopped
  74.    * because of a line-termination or because the buffer is full.
  75.    *
  76.    **/
  77.  public:
  78.   virtual int readLine(char *buffer, int bufSize);
  79.   /**
  80.    * Reads a line of text and store the result into an OutputStream.
  81.    *
  82.    * Returns the number of characters that have been successfully put into the stream.
  83.    **/
  84.   virtual int readLine(SWIoutputStream& out);
  85.   /**
  86.    * Looks at the stream for look-ahead character.
  87.    *
  88.    * @param offset The offset compared to the current read position in the stream.  A value of 0 means
  89.    * the character that would be returned by the next read().
  90.    *
  91.    * @return    Returns either a positive number that can be cast to a char or a negative
  92.    * number representing an error.  See SWIstream.hpp for error codes.
  93.    **/
  94.   virtual int peek(int offset = 0) const;
  95.   virtual bool isBuffered() const;
  96.   virtual int getLookAhead() const;
  97.  public:
  98.   virtual Result close();
  99.  public:
  100.   virtual Result waitReady(long timeoutMs = -1);
  101.   /**
  102.    * Disabled copy constructor.
  103.    **/
  104.  private:
  105.   SWIbufferedInputStream(const SWIbufferedInputStream&);
  106.   /**
  107.    * Disabled assignment operator.
  108.    **/
  109.  private:
  110.   SWIbufferedInputStream& operator=(const SWIbufferedInputStream&);
  111.  private:
  112.   int fillBuffer(int lowBound = 0);
  113.  private:
  114.   SWIinputStream *_stream;
  115.   int _readSize;
  116.   int _lookAhead;
  117.   bool _ownStream;
  118.   unsigned char *_buffer;
  119.   unsigned char * _end;
  120.   unsigned char *_pos;
  121.   bool _eofSeen;
  122. };
  123. #endif