pub struct PyRuntimeError(PyAny);
Expand description
Represents Python’s RuntimeError
exception.
§Example: Raising RuntimeError from Rust
This exception can be sent to Python code by converting it into a
PyErr
, where Python code can then catch it.
use pyo3::prelude::*;
use pyo3::exceptions::PyRuntimeError;
#[pyfunction]
fn always_throws() -> PyResult<()> {
let message = "I'm RuntimeError, and I was raised from Rust.";
Err(PyRuntimeError::new_err(message))
}
Python code:
from my_module import always_throws
try:
always_throws()
except RuntimeError as e:
print(f"Caught an exception: {e}")
§Example: Catching RuntimeError in Rust
use pyo3::prelude::*;
use pyo3::exceptions::PyRuntimeError;
use pyo3::ffi::c_str;
Python::with_gil(|py| {
let result: PyResult<()> = py.run(c_str!("raise RuntimeError"), None, None);
let error_type = match result {
Ok(_) => "Not an error",
Err(error) if error.is_instance_of::<PyRuntimeError>(py) => "RuntimeError",
Err(_) => "Some other error",
};
assert_eq!(error_type, "RuntimeError");
});
Tuple Fields§
§0: PyAny
Implementations§
Source§impl PyRuntimeError
impl PyRuntimeError
#[doc(hidden)] pub const _PYO3_DEF: AddTypeToModule<Self> = _
Methods from Deref<Target = PyAny>§
#[doc(hidden)] pub const _PYO3_DEF: AddTypeToModule<Self> = _
Trait Implementations§
Source§impl AsRef<PyAny> for PyRuntimeError
impl AsRef<PyAny> for PyRuntimeError
Source§impl Deref for PyRuntimeError
impl Deref for PyRuntimeError
Source§impl PyClassBaseType for PyRuntimeError
Available on non-Py_LIMITED_API
only.
impl PyClassBaseType for PyRuntimeError
Available on non-
Py_LIMITED_API
only.Source§impl PyTypeInfo for PyRuntimeError
impl PyTypeInfo for PyRuntimeError
Source§fn type_object_raw(py: Python<'_>) -> *mut PyTypeObject
fn type_object_raw(py: Python<'_>) -> *mut PyTypeObject
Returns the PyTypeObject instance for this type.
Source§fn type_object(py: Python<'_>) -> Bound<'_, PyType>
fn type_object(py: Python<'_>) -> Bound<'_, PyType>
Returns the safe abstraction over the type object.
Source§fn type_object_bound(py: Python<'_>) -> Bound<'_, PyType>
fn type_object_bound(py: Python<'_>) -> Bound<'_, PyType>
👎Deprecated since 0.23.0: renamed to
PyTypeInfo::type_object
Deprecated name for
PyTypeInfo::type_object
.Source§fn is_type_of(object: &Bound<'_, PyAny>) -> bool
fn is_type_of(object: &Bound<'_, PyAny>) -> bool
Checks if
object
is an instance of this type or a subclass of this type.Source§fn is_type_of_bound(object: &Bound<'_, PyAny>) -> bool
fn is_type_of_bound(object: &Bound<'_, PyAny>) -> bool
👎Deprecated since 0.23.0: renamed to
PyTypeInfo::is_type_of
Deprecated name for
PyTypeInfo::is_type_of
.Source§fn is_exact_type_of(object: &Bound<'_, PyAny>) -> bool
fn is_exact_type_of(object: &Bound<'_, PyAny>) -> bool
Checks if
object
is an instance of this type.Source§fn is_exact_type_of_bound(object: &Bound<'_, PyAny>) -> bool
fn is_exact_type_of_bound(object: &Bound<'_, PyAny>) -> bool
👎Deprecated since 0.23.0: renamed to
PyTypeInfo::is_exact_type_of
Deprecated name for
PyTypeInfo::is_exact_type_of
.impl DerefToPyAny for PyRuntimeError
impl PyLayout<PyRuntimeError> for PyBaseExceptionObject
impl PySizedLayout<PyRuntimeError> for PyBaseExceptionObject
impl ToPyErr for PyRuntimeError
Auto Trait Implementations§
impl !Freeze for PyRuntimeError
impl !RefUnwindSafe for PyRuntimeError
impl !Send for PyRuntimeError
impl !Sync for PyRuntimeError
impl Unpin for PyRuntimeError
impl UnwindSafe for PyRuntimeError
Blanket Implementations§
Source§impl<T> AssertNotZeroSized for T
impl<T> AssertNotZeroSized for T
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more
Source§impl<T> IntoEither for T
impl<T> IntoEither for T
Source§fn into_either(self, into_left: bool) -> Either<Self, Self>
fn into_either(self, into_left: bool) -> Either<Self, Self>
Converts
self
into a Left
variant of Either<Self, Self>
if into_left
is true
.
Converts self
into a Right
variant of Either<Self, Self>
otherwise. Read moreSource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
Converts
self
into a Left
variant of Either<Self, Self>
if into_left(&self)
returns true
.
Converts self
into a Right
variant of Either<Self, Self>
otherwise. Read more