boost/boost/scoped_array.hpp

   1 #ifndef BOOST_SCOPED_ARRAY_HPP_INCLUDED
   2 #define BOOST_SCOPED_ARRAY_HPP_INCLUDED
   3
   4 //  (C) Copyright Greg Colvin and Beman Dawes 1998, 1999.
   5 //  Copyright (c) 2001, 2002 Peter Dimov
   6 //
   7 //  Permission to copy, use, modify, sell and distribute this software
   8 //  is granted provided this copyright notice appears in all copies.
   9 //  This software is provided "as is" without express or implied
  10 //  warranty, and with no claim as to its suitability for any purpose.
  11 //
  12 //  See http://www.boost.org/libs/smart_ptr/scoped_array.htm for documentation.
  13 //
  14
  15 #include <boost/assert.hpp>
  16 #include <boost/checked_delete.hpp>
  17 #include <boost/config.hpp>   // in case ptrdiff_t not in std
  18 #include <cstddef>            // for std::ptrdiff_t
  19
  20 namespace boost
  21 {
  22
  23 //  scoped_array extends scoped_ptr to arrays. Deletion of the array pointed to
  24 //  is guaranteed, either on destruction of the scoped_array or via an explicit
  25 //  reset(). Use shared_array or std::vector if your needs are more complex.
  26
  27 template<typename T> class scoped_array // noncopyable
  28 {
  29 private:
  30
  31     T * ptr;
  32
  33     scoped_array(scoped_array const &);
  34     scoped_array & operator=(scoped_array const &);
  35
  36     typedef scoped_array<T> this_type;
  37
  38 public:
  39
  40     typedef T element_type;
  41
  42     explicit scoped_array(T * p = 0) : ptr(p) // never throws
  43     {
  44     }
  45
  46     ~scoped_array() // never throws
  47     {
  48         checked_array_delete(ptr);
  49     }
  50
  51     void reset(T * p = 0) // never throws
  52     {
  53         if (ptr != p)
  54         {
  55             checked_array_delete(ptr);
  56             ptr = p;
  57         }
  58     }
  59
  60     T & operator[](std::ptrdiff_t i) const // never throws
  61     {
  62         BOOST_ASSERT(ptr != 0);
  63         BOOST_ASSERT(i >= 0);
  64         return ptr[i];
  65     }
  66
  67     T * get() const // never throws
  68     {
  69         return ptr;
  70     }
  71
  72     // implicit conversion to "bool"
  73
  74     typedef T * (this_type::*unspecified_bool_type)() const;
  75
  76     operator unspecified_bool_type() const // never throws
  77     {
  78         return ptr == 0? 0: &this_type::get;
  79     }
  80
  81     bool operator! () const // never throws
  82     {
  83         return ptr == 0;
  84     }
  85
  86     void swap(scoped_array & b) // never throws
  87     {
  88         T * tmp = b.ptr;
  89         b.ptr = ptr;
  90         ptr = tmp;
  91     }
  92
  93 };
  94
  95 template<class T> inline void swap(scoped_array<T> & a, scoped_array<T> & b) // never throws
  96 {
  97     a.swap(b);
  98 }
  99
 100 } // namespace boost
 101
 102 #endif  // #ifndef BOOST_SCOPED_ARRAY_HPP_INCLUDED