Struct pyo3::types::PyString

#[repr(transparent)]
pub struct PyString(_);

Represents a Python string.

Methods

impl PyString

pub fn new(_py: Python, s: &str) -> Py<PyString>

Creates a new Python string object.

Panics if out of memory.

pub fn from_object<'p>(     src: &'p PyObjectRef,     encoding: &str,     errors: &str ) -> PyResult<&'p PyString>

pub fn as_bytes(&self) -> &[u8]

Get the Python string as a byte slice.

pub fn to_string(&self) -> PyResult<Cow<str>>

Convert the PyString into a Rust string.

Returns a UnicodeDecodeError if the input is not valid unicode (containing unpaired surrogates).

pub fn to_string_lossy(&self) -> Cow<str>

Convert the PyString into a Rust string.

Unpaired surrogates invalid UTF-8 sequences are replaced with U+FFFD REPLACEMENT CHARACTER.

Trait Implementations

impl ToPyObject for PyString

fn to_object(&self, py: Python) -> PyObject

Converts self into a Python object.

impl PyObjectWithGIL for PyString

fn py(&self) -> Python

impl ToPyPointer for PyString

fn as_ptr(&self) -> *mut PyObject

Gets the underlying FFI pointer, returns a borrowed pointer.

impl PyTypeInfo for PyString

type Type = ()

Type of objects to store in PyObject struct

type BaseType = PyObjectRef

Base class

const NAME: &'static str

Class name

const SIZE: usize

Size of the rust PyObject structure (PyObject + rust structure)

const OFFSET: isize

Type instance offset inside PyObject structure

unsafe fn type_object() -> &'static mut PyTypeObject

PyTypeObject instance for this type

fn is_instance(ptr: &PyObjectRef) -> bool

Check if *mut ffi::PyObject is instance of this type

const DESCRIPTION: &'static str

Class doc string

const FLAGS: usize

Type flags (ie PY_TYPE_FLAG_GC, PY_TYPE_FLAG_WEAKREF)

fn is_exact_instance(object: &PyObjectRef) -> bool

Check if *mut ffi::PyObject is exact instance of this type

impl PyObjectAlloc for PyString

unsafe fn alloc(_py: Python) -> PyResult<*mut PyObject>

unsafe fn dealloc(py: Python, obj: *mut PyObject)

Calls the rust destructor for the object and frees the memory (usually by calling ptr->ob_type->tp_free). This function is used as tp_dealloc implementation.

unsafe fn drop(py: Python, obj: *mut PyObject)

Calls the rust destructor for the object.

impl PyTypeCreate for PyString

fn init_type()

fn type_object() -> Py<PyType>

#[must_use] fn create(py: Python) -> PyResult<PyRawObject>

Create PyRawObject which can be initialized with rust value

impl PartialEq<PyString> for PyString

fn eq(&self, o: &PyString) -> bool

This method tests for self and other values to be equal, and is used by ==.

#[must_use] fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl<'a> From<&'a PyString> for &'a PyObjectRef

fn from(ob: &'a PyString) -> Self

Performs the conversion.

impl AsRef<PyObjectRef> for PyString

fn as_ref(&self) -> &PyObjectRef

Performs the conversion.

impl Display for PyString

fn fmt(&self, f: &mut Formatter) -> Result<(), Error>

Formats the value using the given formatter.

impl Debug for PyString

fn fmt(&self, f: &mut Formatter) -> Result<(), Error>

Formats the value using the given formatter.