Struct pyo3::type_object::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:

use pyo3::prelude::*;

#[pyclass]
struct MyClass { }

#[pymethods]
impl MyClass {
   #[new]
   fn new(obj: &PyRawObject) {
       obj.init(MyClass { })
   }
}

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: PyTypeInfo>(&self, value: T)

pub fn type_object(&self) -> &PyType

Type object

Trait Implementations

impl IntoPyPointer for PyRawObject

fn into_ptr(self) -> *mut PyObject

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

impl PyNativeType for PyRawObject

fn py(&self) -> Python

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

fn as_ref(&self) -> &T

Performs the conversion.