Method new

src/objects/string.rs:245–263

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 m

(py: Python, s: &str)

    ///
    /// Panics if out of memory.
    pub fn new(py: Python, s: &str) -> PyString {
        #[cfg(feature = "python27-sys")]
        fn new_impl(py: Python, s: &str) -> PyString {
            if cfg!(feature = "py2-no-auto-unicode-promotion") || s.is_ascii() {
                PyBytes::new(py, s.as_bytes()).into_basestring()
            } else {
                PyUnicode::new(py, s).into_basestring()
            }
        }
        #[cfg(feature = "python3-sys")]
        fn new_impl(py: Python, s: &str) -> PyString {
            let ptr = s.as_ptr() as *const c_char;
            let len = s.len() as ffi::Py_ssize_t;
            unsafe {
                err::cast_from_owned_ptr_or_panic(py, ffi::PyUnicode_FromStringAndSize(ptr, len))
            }
        }
        new_impl(py, s)
    }

    /// Gets the python string data in its underlying representation.
    ///