itkSmartPointer.h

Go to the documentation of this file.

/*=========================================================================
 *
 *  Copyright Insight Software Consortium
 *
 *  Licensed under the Apache License, Version 2.0 (the "License");
 *  you may not use this file except in compliance with the License.
 *  You may obtain a copy of the License at
 *
 *         http://www.apache.org/licenses/LICENSE-2.0.txt
 *
 *  Unless required by applicable law or agreed to in writing, software
 *  distributed under the License is distributed on an "AS IS" BASIS,
 *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 *  See the License for the specific language governing permissions and
 *  limitations under the License.
 *
 *=========================================================================*/
#ifndef itkSmartPointer_h
#define itkSmartPointer_h

#include <iostream>

namespace itk
{
#if __cplusplus >= 201103L
// In c++11 there is an explicit nullptr type that introduces a new keyword to
// serve as a distinguished null pointer constant: nullptr. It is of type
// nullptr_t, which is implicitly convertible and comparable to any pointer type
// or pointer-to-member type. It is not implicitly convertible or comparable to
// integral types, except for bool.
#define ITK_SP_NULLPTR  nullptr
#define ITK_SP_NOEXCEPT noexcept
#else
#define ITK_SP_NULLPTR  NULL
#define ITK_SP_NOEXCEPT
#endif
template< typename TObjectType >
class SmartPointer
{
public:
  typedef TObjectType ObjectType;

  SmartPointer ()
  { m_Pointer = ITK_SP_NULLPTR; }

  SmartPointer (const SmartPointer< ObjectType > & p):
    m_Pointer(p.m_Pointer)
  { this->Register(); }

  SmartPointer (ObjectType *p):
    m_Pointer(p)
  { this->Register(); }

  ~SmartPointer ()
  {
    this->UnRegister();
    m_Pointer = ITK_SP_NULLPTR;
  }

  ObjectType * operator->() const
  { return m_Pointer; }

  operator ObjectType *() const
        { return m_Pointer; }

  bool IsNotNull() const
  { return m_Pointer != ITK_SP_NULLPTR; }

  bool IsNull() const
  { return m_Pointer == ITK_SP_NULLPTR; }

  template< typename TR >
  bool operator==(TR r) const
  { return ( m_Pointer == static_cast< const ObjectType * >( r ) ); }

  template< typename TR >
  bool operator!=(TR r) const
  { return ( m_Pointer != static_cast< const ObjectType * >( r ) ); }

  ObjectType * GetPointer() const
  { return m_Pointer; }

  bool operator<(const SmartPointer & r) const
  { return (void *)m_Pointer < (void *)r.m_Pointer; }

  bool operator>(const SmartPointer & r) const
  { return (void *)m_Pointer > (void *)r.m_Pointer; }

  bool operator<=(const SmartPointer & r) const
  { return (void *)m_Pointer <= (void *)r.m_Pointer; }

  bool operator>=(const SmartPointer & r) const
  { return (void *)m_Pointer >= (void *)r.m_Pointer; }

  // cppcheck-suppress operatorEqVarError
  SmartPointer & operator=(const SmartPointer & r)
  { return this->operator=( r.GetPointer() ); }

  SmartPointer & operator=(ObjectType *r)
  {
    SmartPointer temp(r);
    temp.Swap(*this);

    return *this;
  }

  ObjectType * Print(std::ostream & os) const
  {
    if( this->IsNull() )
      {
      os << "(null)";
      }
    else
      {
      // This prints the object pointed to by the pointer
      ( *m_Pointer ).Print(os);
      }
    return m_Pointer;
  }

#if ! defined ( ITK_FUTURE_LEGACY_REMOVE )
  void swap(SmartPointer &other)
    {
      this->Swap(other);
    }
#endif

  void Swap(SmartPointer &other)
    {
      ObjectType *tmp = this->m_Pointer;
      this->m_Pointer = other.m_Pointer;
      other.m_Pointer = tmp;
    }

private:
  ObjectType *m_Pointer;

  void Register()
  {
    if ( m_Pointer ) { m_Pointer->Register(); }
  }

  void UnRegister() ITK_SP_NOEXCEPT
  {
    if ( m_Pointer ) { m_Pointer->UnRegister(); }
  }
};

template< typename T >
std::ostream & operator<<(std::ostream & os, SmartPointer< T > p)
{
  p.Print(os);
  return os;
}

template<typename T>
inline void swap( SmartPointer<T> &a, SmartPointer<T> &b )
{
  a.Swap(b);
}

} // end namespace itk

#ifdef ITK_SP_NULLPTR
#undef ITK_SP_NULLPTR
#endif
#ifdef ITK_SP_NOEXECPT
#undef ITK_SP_NOEXCEPT
#endif

#endif