Struct pyo3::typeob::PyRawObject

pub struct PyRawObject { /* fields omitted */ }

Special object that is used for python object creation. pyo3 library automatically creates this object for class __new__ method. Behavior is undefined if constructor of custom class does not initialze instance of PyRawObject with rust value with init method. Calling of __new__ method of base class is developer's responsibility.

Example of custom class implementation with __new__ method:

#![feature(specialization)]

use pyo3::prelude::*;

#[pyclass]
struct MyClass {
   token: PyToken
}

#[pymethods]
impl MyClass {
   #[new]
   fn __new__(obj: &PyRawObject) -> PyResult<()> {
       obj.init(|token| MyClass { token })
   }
}

Methods

impl PyRawObject

#[must_use]

pub unsafe fn new(
    py: Python,
    tp_ptr: *mut PyTypeObject,
    curr_ptr: *mut PyTypeObject
) -> PyResult<PyRawObject>

#[must_use]

pub unsafe fn new_with_ptr(
    py: Python,
    ptr: *mut PyObject,
    tp_ptr: *mut PyTypeObject,
    curr_ptr: *mut PyTypeObject
) -> PyResult<PyRawObject>

pub fn init<T, F>(&self, f: F) -> PyResult<()> where
    F: FnOnce(PyToken) -> T,
    T: PyTypeInfo, 

pub fn type_object(&self) -> &PyType

Type object

Trait Implementations

impl PyObjectWithToken for PyRawObject

fn py(&self) -> Python

impl IntoPyPointer for PyRawObject

fn into_ptr(self) -> *mut PyObject

Retrieves the underlying FFI pointer. Whether pointer owned or borrowed depends on implementation.

impl<T: PyTypeInfo> AsRef<T> for PyRawObject

fn as_ref(&self) -> &T

Performs the conversion.