Struct PyUnicodeDecodeError 

pub struct PyUnicodeDecodeError(/* private fields */);

Available on crate feature tls only.

Represents Python’s UnicodeDecodeError exception.

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

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

Creates a Python UnicodeDecodeError.

pub fn new_utf8<'py>( py: Python<'py>, input: &[u8], err: Utf8Error, ) -> Result<Bound<'py, PyUnicodeDecodeError>, PyErr>

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

Examples

use pyo3::prelude::*;
use pyo3::exceptions::PyUnicodeDecodeError;

Python::attach(|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(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(())
})

Trait Implementations

impl PyTypeInfo for PyUnicodeDecodeError

const NAME: &'static str = "PyUnicodeDecodeError"

👎Deprecated since 0.28.0:

prefer using ::type_object(py).name() to get the correct runtime value

Class name.

const MODULE: Option<&'static str>

👎Deprecated since 0.28.0:

prefer using ::type_object(py).module() to get the correct runtime value

Module name, if any.

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

Returns the PyTypeObject instance for this type.

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

Returns the safe abstraction over the type object.

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

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

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

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