Struct std::ffi::OsStr
[−]
[src]
pub struct OsStr { // some fields omitted }
Slices into OS strings.
Methods
impl OsStr
fn new<S: AsRef<OsStr> + ?Sized>(s: &S) -> &OsStr
Coerces into an OsStr
`OsStr` slice.
fn to_str(&self) -> Option<&str>
Yields a &str
`&strslice if the
` slice if the OsStr
`OsStr` is valid unicode.
This conversion may entail doing a check for UTF-8 validity.
fn to_string_lossy(&self) -> Cow<str>
Converts an OsStr
`OsStrto a
` to a Cow<str>
`Cow
Any non-Unicode sequences are replaced with U+FFFD REPLACEMENT CHARACTER.
fn to_os_string(&self) -> OsString
Copies the slice into an owned OsString
`OsString`.
fn to_bytes(&self) -> Option<&[u8]>
: recently added
Yields this OsStr
`OsStr` as a byte slice.
Platform behavior
On Unix systems, this is a no-op.
On Windows systems, this returns None
`Noneunless the
` unless the OsStr
`OsStr` is
valid unicode, in which case it produces UTF-8-encoded
data. This may entail checking validity.
fn to_cstring(&self) -> Option<CString>
: recently added
Creates a CString
`CStringcontaining this
` containing this OsStr
`OsStr` data.
Fails if the OsStr
`OsStr` contains interior nulls.
This is a convenience for creating a CString
`CStringfrom
` from
self.to_bytes()
`self.to_bytes(), and inherits the platform behavior of the
`, and inherits the platform behavior of the
to_bytes
`to_bytes` method.