Экспонирует механизм извлечения значений объекта C++ из обобщенных объектов Python. Обратите внимание, что Extract<...> также может быть использован для «нисходения» объекта к определенному ObjectWrapper. Поскольку ссылка на мутабельный тип питона с аргументом того же типа (например, list([1,2]), как правило, делает копию аргументированного объекта, это может быть единственным способом доступа к интерфейсу ObjectWrapper на исходном объекте.

Extract<T> может использоваться для извлечения значения произвольного типа C++ из экземпляра объект. Поддерживаются два использования:

namespace boost { namespace python
{
  template <class T>
  struct extract
  {
      typedef unspecified result_type;
      extract(PyObject*);
      extract(object const&);
      result_type operator()() const;
      operator result_type() const;
      bool check() const;
  };
}}

extract(PyObject* p);
extract(object const&);

result_type operator()() const;
operator result_type() const;

bool check() const;

#include <cstdio>
using namespace boost::python;
int Print(str s)
{
   // extract a C string from the Python string object
   char const* c_str = extract<char const*>(s);
   // Print it using printf
   std::printf("%s\n", c_str);
   // Get the Python string's length and convert it to an int
   return extract<int>(s.attr("__len__")())
}

Следующий пример показывает, как экстракт может быть использован вместе с класс_<...> для создания и доступа к экземпляру завернутого класса C++.

struct X
{
   X(int x) : v(x) {}
   int value() { return v; }
 private:
   int v;
};
BOOST_PYTHON_MODULE(extract_ext)
{
    object x_class(
       class_<X>("X", init<int>())
          .def("value", &X::value))
          ;
    // Instantiate an X object through the Python interface. 
    // Its lifetime is now managed by x_obj.
    object x_obj = x_class(3);
    // Get a reference to the C++ object out of the Python object
    X& x = extract<X&>(x_obj);
    assert(x.value() == 3);
}