[−][src]Struct cpython::PyUnicode
Represents a Python string.
Corresponds to basestring
in Python 2, and str
in Python 3.
Implementations
impl PyString
[src]
pub fn new(py: Python<'_>, s: &str) -> PyString
[src]
Creates a new Python string object.
On Python 2.7, this function will create a byte string if the
feature py2-no-auto-unicode-promotion
is set, or the input
input string is ASCII-only; otherwise, the input string will be
converted to a unicode string.
Use PyUnicode::new()
to always create a unicode string.
On Python 3.x, this function always creates unicode str
objects.
Panics if out of memory.
pub fn data(&self, py: Python<'_>) -> PyStringData<'_>
[src]
Gets the python string data in its underlying representation.
For Python 2 byte strings, this function always returns PyStringData::Utf8
,
even if the bytes are not valid UTF-8.
For unicode strings, returns the underlying representation used by Python.
pub fn to_string(&self, py: Python<'_>) -> PyResult<Cow<'_, str>>
[src]
Convert the PyString
into a Rust string.
On Python 2.7, if the PyString
refers to a byte string,
it will be decoded using UTF-8.
Returns a UnicodeDecodeError
if the input is not valid unicode
(containing unpaired surrogates, or a Python 2.7 byte string that is
not valid UTF-8).
pub fn to_string_lossy(&self, py: Python<'_>) -> Cow<'_, str>
[src]
Convert the PyString
into a Rust string.
On Python 2.7, if the PyString
refers to a byte string,
it will be decoded using UTF-8.
Unpaired surrogates and (on Python 2.7) invalid UTF-8 sequences are replaced with U+FFFD REPLACEMENT CHARACTER.
Trait Implementations
impl<'s> FromPyObject<'s> for PyString
[src]
impl<'s> FromPyObject<'s> for &'s PyString
[src]
impl PythonObject for PyString
[src]
pub fn as_object(&self) -> &PyObject
[src]
pub fn into_object(self) -> PyObject
[src]
pub unsafe fn unchecked_downcast_from(obj: PyObject) -> Self
[src]
Unchecked downcast from PyObject to Self. Undefined behavior if the input object does not have the expected type.
pub unsafe fn unchecked_downcast_borrow_from<'a>(obj: &'a PyObject) -> &'a Self
[src]
Unchecked downcast from PyObject to Self. Undefined behavior if the input object does not have the expected type.
impl PythonObjectWithCheckedDowncast for PyString
[src]
pub fn downcast_from<'p>(
py: Python<'p>,
obj: PyObject
) -> Result<PyString, PythonObjectDowncastError<'p>>
[src]
py: Python<'p>,
obj: PyObject
) -> Result<PyString, PythonObjectDowncastError<'p>>
pub fn downcast_borrow_from<'a, 'p>(
py: Python<'p>,
obj: &'a PyObject
) -> Result<&'a PyString, PythonObjectDowncastError<'p>>
[src]
py: Python<'p>,
obj: &'a PyObject
) -> Result<&'a PyString, PythonObjectDowncastError<'p>>
impl PythonObjectWithTypeObject for PyString
[src]
pub fn type_object(py: Python<'_>) -> PyType
[src]
impl ToPyObject for PyString
[src]
Identity conversion: allows using existing PyObject
instances where
T: ToPyObject
is expected.
type ObjectType = PyString
pub fn to_py_object(&self, py: Python<'_>) -> PyString
[src]
pub fn into_py_object(self, _py: Python<'_>) -> PyString
[src]
pub fn with_borrowed_ptr<F, R>(&self, _py: Python<'_>, f: F) -> R where
F: FnOnce(*mut PyObject) -> R,
[src]
F: FnOnce(*mut PyObject) -> R,
Auto Trait Implementations
impl RefUnwindSafe for PyString
[src]
impl Send for PyString
[src]
impl Sync for PyString
[src]
impl Unpin for PyString
[src]
impl UnwindSafe for PyString
[src]
Blanket Implementations
impl<T> Any for T where
T: 'static + ?Sized,
[src]
T: 'static + ?Sized,
impl<T> Borrow<T> for T where
T: ?Sized,
[src]
T: ?Sized,
impl<T> BorrowMut<T> for T where
T: ?Sized,
[src]
T: ?Sized,
pub fn borrow_mut(&mut self) -> &mut T
[src]
impl<T> From<T> for T
[src]
impl<T, U> Into<U> for T where
U: From<T>,
[src]
U: From<T>,
impl<T, U> TryFrom<U> for T where
U: Into<T>,
[src]
U: Into<T>,
type Error = Infallible
The type returned in the event of a conversion error.
pub fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>
[src]
impl<T, U> TryInto<U> for T where
U: TryFrom<T>,
[src]
U: TryFrom<T>,