[−][src]Struct sgx_tstd::ffi::OsString

pub struct OsString { /* fields omitted */ }

A type that can represent owned, mutable platform-native strings, but is cheaply inter-convertible with Rust strings.

Methods

`impl OsString`[src]

`pub fn new() -> OsString`[src]

Constructs a new empty OsString.

`pub fn as_os_str(&self) -> &OsStr`[src]

Converts to an OsStr slice.

`pub fn into_string(self) -> Result<String, OsString>`[src]

Converts the OsString into a String if it contains valid Unicode data.

On failure, ownership of the original OsString is returned.

`pub fn push<T: AsRef<OsStr>>(&mut self, s: T)`[src]

Extends the string with the given [&OsStr] slice.

`pub fn with_capacity(capacity: usize) -> OsString`[src]

Creates a new OsString with the given capacity.

The string will be able to hold exactly capacity lenth units of other OS strings without reallocating. If capacity is 0, the string will not allocate.

`pub fn clear(&mut self)`[src]

Truncates the OsString to zero length.

`pub fn capacity(&self) -> usize`[src]

Returns the capacity this OsString can hold without reallocating.

`pub fn reserve(&mut self, additional: usize)`[src]

Reserves capacity for at least additional more capacity to be inserted in the given OsString.

`pub fn reserve_exact(&mut self, additional: usize)`[src]

Reserves the minimum capacity for exactly additional more capacity to be inserted in the given OsString. Does nothing if the capacity is already sufficient.

Note that the allocator may give the collection more space than it requests. Therefore capacity can not be relied upon to be precisely minimal. Prefer reserve if future insertions are expected.

`pub fn shrink_to_fit(&mut self)`[src]

Shrinks the capacity of the OsString to match its length.

`pub fn shrink_to(&mut self, min_capacity: usize)`[src]

Shrinks the capacity of the OsString with a lower bound.

The capacity will remain at least as large as both the length and the supplied value.

Panics if the current capacity is smaller than the supplied minimum capacity.

ⓘImportant traits for Box<F>
Important traits for Box<F>
`impl<F> Future for Box<F> where F: Unpin + Future + ?Sized, type Output = <F as Future>::Output;impl Iterator for Box where I: Iterator + ?Sized, type Item = ::Item;`
`pub fn into_boxed_os_str(self) -> Box<OsStr>`[src]

Converts this OsString into a boxed OsStr.

Methods from Deref<Target = OsStr>

`pub fn to_str(&self) -> Option<&str>`[src]

Yields a [&str] slice if the OsStr is valid Unicode.

This conversion may entail doing a check for UTF-8 validity.

`pub fn to_string_lossy(&self) -> Cow<str>`[src]

Converts an OsStr to a Cow<str>.

Any non-Unicode sequences are replaced with U+FFFD REPLACEMENT CHARACTER.

`pub fn to_os_string(&self) -> OsString`[src]

Copies the slice into an owned OsString.

`pub fn is_empty(&self) -> bool`[src]

Checks whether the OsStr is empty.

`pub fn len(&self) -> usize`[src]

Returns the length of this OsStr.

Note that this does not return the number of bytes in this string as, for example, OS strings on Windows are encoded as a list of u16 rather than a list of bytes. This number is simply useful for passing to other methods like OsString::with_capacity to avoid reallocations.

See OsStr introduction for more information about encoding.