предоставляет шаблон классов handle, интеллектуальный указатель для управления объектами Python с исходным кодом.

handle является умным указателем на тип объекта Python; он содержит указатель типа T*, где T является параметром шаблона. T должен быть либо типом, полученным из PyObject, либо типом POD, начальный sizeof(PyObject) байты компоновки совместимы с PyObject. Используйте handle<> на границе между API Python/'C' и высокоуровневым кодом; предпочтите объект для обобщенного интерфейса объектам Python.

В этом документе термин «upcast» относится к операции, которая преобразует указатель Y в базовый класс pointerT через static_cast<T>, если Y получен из T, или через каст в стиле C (T), если это не так. Однако в последнем случае «подкаст» плохо формируется, если начальный размер (PyObject) байты Y не совместимы с макетом PyObject.

namespace boost { namespace python
{
  template <class T>
  class handle
  {
      typedef unspecified-member-function-pointer bool_type;
   public: // types
      typedef T element_type;
   public: // member functions
      ~handle();
      template <class Y>
      explicit handle(detail::borrowed<null_ok<Y> >* p);
      template <class Y>
      explicit handle(null_ok<detail::borrowed<Y> >* p);
      template <class Y>
      explicit handle(detail::borrowed<Y>* p);
      template <class Y>
      explicit handle(null_ok<Y>* p);
      template <class Y>
      explicit handle(Y* p);
      handle();
      handle& operator=(handle const& r);
      template<typename Y>
      handle& operator=(handle<Y> const & r); // never throws
      template <typename Y>
      handle(handle<Y> const& r);
      handle(handle const& r);
      T* operator-> () const;
      T& operator* () const;
      T* get() const;
      void reset();
      T* release();
      operator bool_type() const; // never throws
   private:
      T* m_p;
  };
  template <class T> struct null_ok;
  namespace detail { template <class T> struct borrowed; }
}}

virtual ~handle();

template <class Y>
explicit handle(detail::borrowed<null_ok<Y> >* p);

template <class Y>
explicit handle(null_ok<detail::borrowed<Y> >* p);

template <class Y>
explicit handle(detail::borrowed<Y>* p);

template <class Y>
explicit handle(null_ok<Y>* p);

template <class Y>
explicit handle(Y* p);

handle();

template <typename Y>
handle(handle<Y> const& r);
handle(handle const& r);

handle& operator=(handle const& r);
template<typename Y>
handle& operator=(handle<Y> const & r); // never throws

T* release();

void reset();

T* operator-> () const;
T* get() const;

T& operator* () const;

operator bool_type() const; // never throws