Pipe.hxx
上传用户:sy_wanhua
上传日期:2013-07-25
资源大小:3048k
文件大小:5k
源码类别:

流媒体/Mpeg4/MP4

开发平台:

C/C++

  1. #if !defined(PIPE_DOT_H)
  2. #define PIPE_DOT_H
  3. /* ====================================================================
  4.  * The Vovida Software License, Version 1.0 
  5.  * 
  6.  * Copyright (c) 2000 Vovida Networks, Inc.  All rights reserved.
  7.  * 
  8.  * Redistribution and use in source and binary forms, with or without
  9.  * modification, are permitted provided that the following conditions
  10.  * are met:
  11.  * 
  12.  * 1. Redistributions of source code must retain the above copyright
  13.  *    notice, this list of conditions and the following disclaimer.
  14.  * 
  15.  * 2. Redistributions in binary form must reproduce the above copyright
  16.  *    notice, this list of conditions and the following disclaimer in
  17.  *    the documentation and/or other materials provided with the
  18.  *    distribution.
  19.  * 
  20.  * 3. The names "VOCAL", "Vovida Open Communication Application Library",
  21.  *    and "Vovida Open Communication Application Library (VOCAL)" must
  22.  *    not be used to endorse or promote products derived from this
  23.  *    software without prior written permission. For written
  24.  *    permission, please contact vocal@vovida.org.
  25.  *
  26.  * 4. Products derived from this software may not be called "VOCAL", nor
  27.  *    may "VOCAL" appear in their name, without prior written
  28.  *    permission of Vovida Networks, Inc.
  29.  * 
  30.  * THIS SOFTWARE IS PROVIDED "AS IS" AND ANY EXPRESSED OR IMPLIED
  31.  * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
  32.  * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, TITLE AND
  33.  * NON-INFRINGEMENT ARE DISCLAIMED.  IN NO EVENT SHALL VOVIDA
  34.  * NETWORKS, INC. OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT DAMAGES
  35.  * IN EXCESS OF $1,000, NOR FOR ANY INDIRECT, INCIDENTAL, SPECIAL,
  36.  * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
  37.  * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
  38.  * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY
  39.  * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  40.  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
  41.  * USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
  42.  * DAMAGE.
  43.  * 
  44.  * ====================================================================
  45.  * 
  46.  * This software consists of voluntary contributions made by Vovida
  47.  * Networks, Inc. and many individuals on behalf of Vovida Networks,
  48.  * Inc.  For more information on Vovida Networks, Inc., please see
  49.  * <http://www.vovida.org/>.
  50.  *
  51.  */
  52. static const char* const Pipe_hxx_Version = 
  53.     "$Id: Pipe.hxx,v 1.1 2001/03/30 02:49:21 icahoon Exp $";
  54. #include "Writer.hxx"
  55. #include "FileDescriptor.hxx"
  56. /** Infrastructure common to VOCAL.
  57.  */
  58. namespace Vocal 
  59. {
  60. class SystemException;
  61. /** Infrastructure in VOCAL related to Input/Output.<br><br>
  62.  */
  63. namespace IO
  64. {
  65. /** A wrapper class for the operating systems pipe.<br><br>
  66.  *  
  67.  *  @see     Vocal::IO::FileDescriptor
  68.  *  @see     Vocal::IO::Writer
  69.  *  @see     Vocal::SystemException
  70.  */
  71. class Pipe : public Vocal::IO::Writer
  72. {
  73.     public:
  74. /** The default constructor creates a pipe. If is file descriptor
  75.  *  array parameter is zero, then a new pipe will be created. 
  76.  *  Otherwise the given parameter will be used to initialize the pipe.
  77.  *
  78.  *  @param  descriptors     An optional array of two file descriptors, 
  79.  *                 created using the pipe(2) system call.
  80.  * 
  81.  *  @exception Vocal::SystemException
  82.  *   Thrown if a pipe could not be created.
  83.  */
  84.      Pipe(const file_descriptor_t * descriptors = 0)
  85.     throw ( Vocal::SystemException );
  86. /** Creates a pipe given a pair of file descriptors.
  87.  */
  88.      Pipe(
  89.     const FileDescriptor    &  readFd,
  90.     const FileDescriptor    & writeFd
  91. );
  92. /** The destructor will close() the file descriptors if valid.
  93.  *
  94.  *  @exception Vocal::SystemException
  95.  *   Thrown if the closure of the pipe failed.
  96.  */
  97. virtual ~Pipe()
  98.     throw ( Vocal::SystemException );
  99. /** Accessor to FileDescriptors.
  100.  *
  101.  *  @param index    Index 0 indicated the file descriptor for reading,
  102.  *            and an index of 1 (or non zero) indicates the
  103.  *            file descriptor for writing.
  104.  */
  105.      FileDescriptor &    operator[](size_t index);
  106.      /** Accessor to file descriptor used for reading.
  107.  */
  108. FileDescriptor &    readFD();
  109.      /** Accessor to file descriptor used for reading.
  110.  */
  111. const FileDescriptor &    readFD() const;
  112. /** Accessor to file descriptor used for writing.
  113.  */
  114. FileDescriptor &    writeFD();
  115. /** Accessor to file descriptor used for writing.
  116.  */
  117. const FileDescriptor &    writeFD() const;
  118. /** Equality relational operator.
  119.  */
  120. bool operator==(const Pipe &) const;
  121. /** Less than relational operator.
  122.  */
  123. bool operator<(const Pipe &) const;
  124. /** Write to an ostream.
  125.  */
  126. virtual ostream &       writeTo(ostream &) const;
  127.     private:
  128.      FileDescriptor     readFD_;
  129. FileDescriptor     writeFD_;
  130. /** Copying is suppressed.
  131.  */
  132.      Pipe(const Pipe &);
  133. /** Copying is suppressed.
  134.  */
  135. Pipe & operator=(const Pipe &);
  136. };
  137. } // namespace Transport
  138. } // namespace Vocal
  139. #endif // !defined(PIPE_DOT_H)