LCOV - lcov.info - /usr/include/c++/4.3/bits/postypes.h

LTP GCOV extension - code coverage report
Current view: | directory - usr/include/c++/4.3/bits - postypes.h
Test: | lcov.info
Date: | 2008-08-14 |  | Instrumented lines: | 3
Code covered: | 0.0 % |  | Executed lines: | 0

           1                 : // Position types -*- C++ -*-
           2                 :
           3                 : // Copyright (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005,
           4                 : // 2006, 2007, 2008
           5                 : // Free Software Foundation, Inc.
           6                 : //
           7                 : // This file is part of the GNU ISO C++ Library.  This library is free
           8                 : // software; you can redistribute it and/or modify it under the
           9                 : // terms of the GNU General Public License as published by the
          10                 : // Free Software Foundation; either version 2, or (at your option)
          11                 : // any later version.
          12                 :
          13                 : // This library is distributed in the hope that it will be useful,
          14                 : // but WITHOUT ANY WARRANTY; without even the implied warranty of
          15                 : // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
          16                 : // GNU General Public License for more details.
          17                 :
          18                 : // You should have received a copy of the GNU General Public License along
          19                 : // with this library; see the file COPYING.  If not, write to the Free
          20                 : // Software Foundation, 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301,
          21                 : // USA.
          22                 :
          23                 : // As a special exception, you may use this file as part of a free software
          24                 : // library without restriction.  Specifically, if other files instantiate
          25                 : // templates or use macros or inline functions from this file, or you compile
          26                 : // this file and link it with other files to produce an executable, this
          27                 : // file does not by itself cause the resulting executable to be covered by
          28                 : // the GNU General Public License.  This exception does not however
          29                 : // invalidate any other reasons why the executable file might be covered by
          30                 : // the GNU General Public License.
          31                 :
          32                 : /** @file postypes.h
          33                 :  *  This is an internal header file, included by other library headers.
          34                 :  *  You should not attempt to use it directly.
          35                 :  */
          36                 :
          37                 : //
          38                 : // ISO C++ 14882: 27.4.1 - Types
          39                 : // ISO C++ 14882: 27.4.3 - Template class fpos
          40                 : //
          41                 :
          42                 : #ifndef _GLIBCXX_POSTYPES_H
          43                 : #define _GLIBCXX_POSTYPES_H 1
          44                 :
          45                 : #pragma GCC system_header
          46                 :
          47                 : #include <cwchar> // For mbstate_t
          48                 :
          49                 : #ifdef _GLIBCXX_HAVE_STDINT_H
          50                 : #include <stdint.h> // For int64_t
          51                 : #endif
          52                 :
          53                 : _GLIBCXX_BEGIN_NAMESPACE(std)
          54                 :
          55                 :   // The types streamoff, streampos and wstreampos and the class
          56                 :   // template fpos<> are described in clauses 21.1.2, 21.1.3, 27.1.2,
          57                 :   // 27.2, 27.4.1, 27.4.3 and D.6. Despite all this verbiage, the
          58                 :   // behaviour of these types is mostly implementation defined or
          59                 :   // unspecified. The behaviour in this implementation is as noted
          60                 :   // below.
          61                 :
          62                 :   /**
          63                 :    *  @brief  Type used by fpos, char_traits<char>, and char_traits<wchar_t>.
          64                 :    *
          65                 :    *  In clauses 21.1.3.1 and 27.4.1 streamoff is described as an
          66                 :    *  implementation defined type.
          67                 :    *  Note: In versions of GCC up to and including GCC 3.3, streamoff
          68                 :    *  was typedef long.
          69                 :   */
          70                 : #ifdef _GLIBCXX_HAVE_INT64_T
          71                 :   typedef int64_t       streamoff;
          72                 : #else
          73                 :   typedef long long     streamoff;
          74                 : #endif
          75                 :
          76                 :   /// Integral type for I/O operation counts and buffer sizes.
          77                 :   typedef ptrdiff_t     streamsize; // Signed integral type
          78                 :
          79                 :   /**
          80                 :    *  @brief  Class representing stream positions.
          81                 :    *
          82                 :    *  The standard places no requirements upon the template parameter StateT.
          83                 :    *  In this implementation StateT must be DefaultConstructible,
          84                 :    *  CopyConstructible and Assignable.  The standard only requires that fpos
          85                 :    *  should contain a member of type StateT. In this implementation it also
          86                 :    *  contains an offset stored as a signed integer.
          87                 :    *
          88                 :    *  @param  StateT  Type passed to and returned from state().
          89                 :    */
          90                 :   template<typename _StateT>
          91                 :     class fpos
          92                 :     {
          93                 :     private:
          94                 :       streamoff                 _M_off;
          95                 :       _StateT                   _M_state;
          96                 :
          97                 :     public:
          98                 :       // The standard doesn't require that fpos objects can be default
          99                 :       // constructed. This implementation provides a default
         100                 :       // constructor that initializes the offset to 0 and default
         101                 :       // constructs the state.
         102                 :       fpos()
         103                 :       : _M_off(0), _M_state() { }
         104                 :
         105                 :       // The standard requires that fpos objects can be constructed
         106                 :       // from streamoff objects using the constructor syntax, and
         107                 :       // fails to give any meaningful semantics. In this
         108                 :       // implementation implicit conversion is also allowed, and this
         109                 :       // constructor stores the streamoff as the offset and default
         110                 :       // constructs the state.
         111                 :       /// Construct position from offset.
         112               0 :       fpos(streamoff __off)
         113               0 :       : _M_off(__off), _M_state() { }
         114                 :
         115                 :       /// Convert to streamoff.
         116               0 :       operator streamoff() const { return _M_off; }
         117                 :
         118                 :       /// Remember the value of @a st.
         119                 :       void
         120                 :       state(_StateT __st)
         121                 :       { _M_state = __st; }
         122                 :
         123                 :       /// Return the last set value of @a st.
         124                 :       _StateT
         125                 :       state() const
         126                 :       { return _M_state; }
         127                 :
         128                 :       // The standard requires that this operator must be defined, but
         129                 :       // gives no semantics. In this implementation it just adds its
         130                 :       // argument to the stored offset and returns *this.
         131                 :       /// Add offset to this position.
         132                 :       fpos&
         133                 :       operator+=(streamoff __off)
         134                 :       {
         135                 :         _M_off += __off;
         136                 :         return *this;
         137                 :       }
         138                 :
         139                 :       // The standard requires that this operator must be defined, but
         140                 :       // gives no semantics. In this implementation it just subtracts
         141                 :       // its argument from the stored offset and returns *this.
         142                 :       /// Subtract offset from this position.
         143                 :       fpos&
         144                 :       operator-=(streamoff __off)
         145                 :       {
         146                 :         _M_off -= __off;
         147                 :         return *this;
         148                 :       }
         149                 :
         150                 :       // The standard requires that this operator must be defined, but
         151                 :       // defines its semantics only in terms of operator-. In this
         152                 :       // implementation it constructs a copy of *this, adds the
         153                 :       // argument to that copy using operator+= and then returns the
         154                 :       // copy.
         155                 :       /// Add position and offset.
         156                 :       fpos
         157                 :       operator+(streamoff __off) const
         158                 :       {
         159                 :         fpos __pos(*this);
         160                 :         __pos += __off;
         161                 :         return __pos;
         162                 :       }
         163                 :
         164                 :       // The standard requires that this operator must be defined, but
         165                 :       // defines its semantics only in terms of operator+. In this
         166                 :       // implementation it constructs a copy of *this, subtracts the
         167                 :       // argument from that copy using operator-= and then returns the
         168                 :       // copy.
         169                 :       /// Subtract offset from position.
         170                 :       fpos
         171                 :       operator-(streamoff __off) const
         172                 :       {
         173                 :         fpos __pos(*this);
         174                 :         __pos -= __off;
         175                 :         return __pos;
         176                 :       }
         177                 :
         178                 :       // The standard requires that this operator must be defined, but
         179                 :       // defines its semantics only in terms of operator+. In this
         180                 :       // implementation it returns the difference between the offset
         181                 :       // stored in *this and in the argument.
         182                 :       /// Subtract position to return offset.
         183                 :       streamoff
         184                 :       operator-(const fpos& __other) const
         185                 :       { return _M_off - __other._M_off; }
         186                 :     };
         187                 :
         188                 :   // The standard only requires that operator== must be an
         189                 :   // equivalence relation. In this implementation two fpos<StateT>
         190                 :   // objects belong to the same equivalence class if the contained
         191                 :   // offsets compare equal.
         192                 :   /// Test if equivalent to another position.
         193                 :   template<typename _StateT>
         194                 :     inline bool
         195                 :     operator==(const fpos<_StateT>& __lhs, const fpos<_StateT>& __rhs)
         196                 :     { return streamoff(__lhs) == streamoff(__rhs); }
         197                 :
         198                 :   template<typename _StateT>
         199                 :     inline bool
         200                 :     operator!=(const fpos<_StateT>& __lhs, const fpos<_StateT>& __rhs)
         201                 :     { return streamoff(__lhs) != streamoff(__rhs); }
         202                 :
         203                 :   // Clauses 21.1.3.1 and 21.1.3.2 describe streampos and wstreampos
         204                 :   // as implementation defined types, but clause 27.2 requires that
         205                 :   // they must both be typedefs for fpos<mbstate_t>
         206                 :   /// File position for char streams.
         207                 :   typedef fpos<mbstate_t> streampos;
         208                 :   /// File position for wchar_t streams.
         209                 :   typedef fpos<mbstate_t> wstreampos;
         210                 :
         211                 : _GLIBCXX_END_NAMESPACE
         212                 :
         213                 : #endif

Generated by: LTP GCOV extension version 1.6