Struct pyo3::exceptions::PyUnicodeDecodeError

pub struct PyUnicodeDecodeError(PyAny);

Represents Python’s UnicodeDecodeError exception.

Tuple Fields

0: PyAny

Implementations

impl PyUnicodeDecodeError

pub fn new_err<A>(args: A) -> PyErr

where A: PyErrArguments + Send + Sync + 'static,

Creates a new PyErr of this type.

impl PyUnicodeDecodeError

#[doc(hidden)] pub const _PYO3_DEF: AddTypeToModule<Self> = _

impl PyUnicodeDecodeError

pub fn new_bound<'p>( py: Python<'p>, encoding: &CStr, input: &[u8], range: Range<usize>, reason: &CStr ) -> PyResult<Bound<'p, PyUnicodeDecodeError>>

Creates a Python UnicodeDecodeError.

pub fn new_utf8_bound<'p>( py: Python<'p>, input: &[u8], err: Utf8Error ) -> PyResult<Bound<'p, PyUnicodeDecodeError>>

Creates a Python UnicodeDecodeError from a Rust UTF-8 decoding error.

Examples

#![cfg_attr(invalid_from_utf8_lint, allow(invalid_from_utf8))]
use pyo3::prelude::*;
use pyo3::exceptions::PyUnicodeDecodeError;

Python::with_gil(|py| {
    let invalid_utf8 = b"fo\xd8o";
    let err = std::str::from_utf8(invalid_utf8).expect_err("should be invalid utf8");
    let decode_err = PyUnicodeDecodeError::new_utf8_bound(py, invalid_utf8, err)?;
    assert_eq!(
        decode_err.to_string(),
        "'utf-8' codec can't decode byte 0xd8 in position 2: invalid utf-8"
    );
    Ok(())
})

Methods from Deref<Target = PyAny>

#[doc(hidden)] pub const _PYO3_DEF: AddTypeToModule<Self> = _

Trait Implementations

impl AsPyPointer for PyUnicodeDecodeError

fn as_ptr(&self) -> *mut PyObject

Gets the underlying FFI pointer, returns a borrowed pointer.

impl AsRef<PyAny> for PyUnicodeDecodeError

fn as_ref(&self) -> &PyAny

Converts this type into a shared reference of the (usually inferred) input type.

impl Deref for PyUnicodeDecodeError

type Target = PyAny

The resulting type after dereferencing.

fn deref(&self) -> &PyAny

Dereferences the value.

impl PyClassBaseType for PyUnicodeDecodeError

type LayoutAsBase = PyClassObjectBase<PyBaseExceptionObject>

type BaseNativeType = PyUnicodeDecodeError

type Initializer = PyNativeTypeInitializer<PyUnicodeDecodeError>

type PyClassMutability = ImmutableClass

impl PyTypeInfo for PyUnicodeDecodeError

const NAME: &'static str = "PyUnicodeDecodeError"

Available on non-crate feature gil-refs only.

Class name.

const MODULE: Option<&'static str> = _

Available on non-crate feature gil-refs only.

Module name, if any.

fn type_object_raw(py: Python<'_>) -> *mut PyTypeObject

Available on non-crate feature gil-refs only.

Returns the PyTypeObject instance for this type.

fn type_object_bound(py: Python<'_>) -> Bound<'_, PyType>

Available on non-crate feature gil-refs only.

Returns the safe abstraction over the type object.

fn is_type_of_bound(object: &Bound<'_, PyAny>) -> bool

Available on non-crate feature gil-refs only.

Checks if object is an instance of this type or a subclass of this type.

fn is_exact_type_of_bound(object: &Bound<'_, PyAny>) -> bool

Available on non-crate feature gil-refs only.

Checks if object is an instance of this type.

impl DerefToPyAny for PyUnicodeDecodeError

impl PyLayout<PyUnicodeDecodeError> for PyBaseExceptionObject

impl PySizedLayout<PyUnicodeDecodeError> for PyBaseExceptionObject

impl ToPyErr for PyUnicodeDecodeError