Struct std::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.
The need for this type arises from the fact that:
-
On Unix systems, strings are often arbitrary sequences of non-zero bytes, in many cases interpreted as UTF-8.
-
On Windows, strings are often arbitrary sequences of non-zero 16-bit values, interpreted as UTF-16 when it is valid to do so.
-
In Rust, strings are always valid UTF-8, which may contain zeros.
OsString and OsStr bridge this gap by simultaneously representing Rust and platform-native string values, and in particular allowing a Rust string to be converted into an “OS” string with no cost if possible. A consequence of this is that OsString instances are not NUL terminated; in order to pass to e.g., Unix system call, you should create a CStr.
OsString is to &OsStr as String is to &str: the former in each pair are owned strings; the latter are borrowed references.
Note, OsString and OsStr internally do not necessarily hold strings in the form native to the platform; While on Unix, strings are stored as a sequence of 8-bit values, on Windows, where strings are 16-bit value based as just discussed, strings are also actually stored as a sequence of 8-bit values, encoded in a less-strict variant of UTF-8. This is useful to understand when handling capacity and length values.
Creating an OsString
From a Rust string: OsString implements From<String>, so you can use my_string.from to create an OsString from a normal Rust string.
From slices: Just like you can start with an empty Rust String and then String::push_str &str sub-string slices into it, you can create an empty OsString with the OsString::new method and then push string slices into it with the OsString::push method.
Extracting a borrowed reference to the whole OS string
You can use the OsString::as_os_str method to get an &OsStr from an OsString; this is effectively a borrowed reference to the whole string.
Conversions
See the module’s toplevel documentation about conversions for a discussion on the traits which OsString implements for conversions from/to native representations.
Implementations
impl OsString
pub fn new() -> OsString
Constructs a new empty OsString.
Examples
use std::ffi::OsString; let os_string = OsString::new();
pub fn as_os_str(&self) -> &OsStr
Converts to an OsStr slice.
Examples
use std::ffi::{OsString, OsStr};
let os_string = OsString::from("foo");
let os_str = OsStr::new("foo");
assert_eq!(os_string.as_os_str(), os_str);pub fn into_string(self) -> Result<String, OsString>
Converts the OsString into a String if it contains valid Unicode data.
On failure, ownership of the original OsString is returned.
Examples
use std::ffi::OsString;
let os_string = OsString::from("foo");
let string = os_string.into_string();
assert_eq!(string, Ok(String::from("foo")));pub fn push<T: AsRef<OsStr>>(&mut self, s: T)
Extends the string with the given &OsStr slice.
Examples
use std::ffi::OsString;
let mut os_string = OsString::from("foo");
os_string.push("bar");
assert_eq!(&os_string, "foobar");pub fn with_capacity(capacity: usize) -> OsString
Creates a new OsString with the given capacity.
The string will be able to hold exactly capacity length units of other OS strings without reallocating. If capacity is 0, the string will not allocate.
See main OsString documentation information about encoding.
Examples
use std::ffi::OsString;
let mut os_string = OsString::with_capacity(10);
let capacity = os_string.capacity();
// This push is done without reallocating
os_string.push("foo");
assert_eq!(capacity, os_string.capacity());pub fn clear(&mut self)
Truncates the OsString to zero length.
Examples
use std::ffi::OsString;
let mut os_string = OsString::from("foo");
assert_eq!(&os_string, "foo");
os_string.clear();
assert_eq!(&os_string, "");pub fn capacity(&self) -> usize
Returns the capacity this OsString can hold without reallocating.
See OsString introduction for information about encoding.
Examples
use std::ffi::OsString; let os_string = OsString::with_capacity(10); assert!(os_string.capacity() >= 10);
pub fn reserve(&mut self, additional: usize)
Reserves capacity for at least additional more capacity to be inserted in the given OsString.
The collection may reserve more space to avoid frequent reallocations.
Examples
use std::ffi::OsString; let mut s = OsString::new(); s.reserve(10); assert!(s.capacity() >= 10);
pub fn reserve_exact(&mut self, additional: usize)
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.
Examples
use std::ffi::OsString; let mut s = OsString::new(); s.reserve_exact(10); assert!(s.capacity() >= 10);
pub fn shrink_to_fit(&mut self)
Shrinks the capacity of the OsString to match its length.
Examples
use std::ffi::OsString;
let mut s = OsString::from("foo");
s.reserve(100);
assert!(s.capacity() >= 100);
s.shrink_to_fit();
assert_eq!(3, s.capacity());pub fn shrink_to(&mut self, min_capacity: usize)
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.
If the current capacity is less than the lower limit, this is a no-op.
Examples
use std::ffi::OsString;
let mut s = OsString::from("foo");
s.reserve(100);
assert!(s.capacity() >= 100);
s.shrink_to(10);
assert!(s.capacity() >= 10);
s.shrink_to(0);
assert!(s.capacity() >= 3);pub fn into_boxed_os_str(self) -> Box<OsStr>
impl<I, A> Iterator for Box<I, A> where
I: Iterator + ?Sized,
A: Allocator,
type Item = <I as Iterator>::Item;
impl<F, A> Future for Box<F, A> where
F: Future + Unpin + ?Sized,
A: Allocator + 'static,
type Output = <F as Future>::Output;
impl<R: Read + ?Sized> Read for Box<R>
impl<W: Write + ?Sized> Write for Box<W>
Converts this OsString into a boxed OsStr.
Examples
use std::ffi::{OsString, OsStr};
let s = OsString::from("hello");
let b: Box<OsStr> = s.into_boxed_os_str();Methods from Deref<Target = OsStr>
pub fn to_str(&self) -> Option<&str>
Yields a &str slice if the OsStr is valid Unicode.
This conversion may entail doing a check for UTF-8 validity.
Examples
use std::ffi::OsStr;
let os_str = OsStr::new("foo");
assert_eq!(os_str.to_str(), Some("foo"));pub fn to_string_lossy(&self) -> Cow<'_, str>
Converts an OsStr to a Cow<str>.
Any non-Unicode sequences are replaced with U+FFFD REPLACEMENT CHARACTER.
Examples
Calling to_string_lossy on an OsStr with invalid unicode:
// Note, due to differences in how Unix and Windows represent strings,
// we are forced to complicate this example, setting up example `OsStr`s
// with different source data and via different platform extensions.
// Understand that in reality you could end up with such example invalid
// sequences simply through collecting user command line arguments, for
// example.
#[cfg(unix)] {
use std::ffi::OsStr;
use std::os::unix::ffi::OsStrExt;
// Here, the values 0x66 and 0x6f correspond to 'f' and 'o'
// respectively. The value 0x80 is a lone continuation byte, invalid
// in a UTF-8 sequence.
let source = [0x66, 0x6f, 0x80, 0x6f];
let os_str = OsStr::from_bytes(&source[..]);
assert_eq!(os_str.to_string_lossy(), "fo�o");
}
#[cfg(windows)] {
use std::ffi::OsString;
use std::os::windows::prelude::*;
// Here the values 0x0066 and 0x006f correspond to 'f' and 'o'
// respectively. The value 0xD800 is a lone surrogate half, invalid
// in a UTF-16 sequence.
let source = [0x0066, 0x006f, 0xD800, 0x006f];
let os_string = OsString::from_wide(&source[..]);
let os_str = os_string.as_os_str();
assert_eq!(os_str.to_string_lossy(), "fo�o");
}pub fn to_os_string(&self) -> OsString
Copies the slice into an owned OsString.
Examples
use std::ffi::{OsStr, OsString};
let os_str = OsStr::new("foo");
let os_string = os_str.to_os_string();
assert_eq!(os_string, OsString::from("foo"));pub fn is_empty(&self) -> bool
Checks whether the OsStr is empty.
Examples
use std::ffi::OsStr;
let os_str = OsStr::new("");
assert!(os_str.is_empty());
let os_str = OsStr::new("foo");
assert!(!os_str.is_empty());pub fn len(&self) -> usize
Returns the length of this OsStr.
Note that this does not return the number of bytes in the string in OS string form.
The length returned is that of the underlying storage used by OsStr. As discussed in the OsString introduction, OsString and OsStr store strings in a form best suited for cheap inter-conversion between native-platform and Rust string forms, which may differ significantly from both of them, including in storage size and encoding.
This number is simply useful for passing to other methods, like OsString::with_capacity to avoid reallocations.
Examples
use std::ffi::OsStr;
let os_str = OsStr::new("");
assert_eq!(os_str.len(), 0);
let os_str = OsStr::new("foo");
assert_eq!(os_str.len(), 3);pub fn make_ascii_lowercase(&mut self)
Converts this string to its ASCII lower case equivalent in-place.
ASCII letters ‘A’ to ‘Z’ are mapped to ‘a’ to ‘z’, but non-ASCII letters are unchanged.
To return a new lowercased value without modifying the existing one, use OsStr::to_ascii_lowercase.
Examples
use std::ffi::OsString;
let mut s = OsString::from("GRÜßE, JÜRGEN ❤");
s.make_ascii_lowercase();
assert_eq!("grÜße, jÜrgen ❤", s);pub fn make_ascii_uppercase(&mut self)
Converts this string to its ASCII upper case equivalent in-place.
ASCII letters ‘a’ to ‘z’ are mapped to ‘A’ to ‘Z’, but non-ASCII letters are unchanged.
To return a new uppercased value without modifying the existing one, use OsStr::to_ascii_uppercase.
Examples
use std::ffi::OsString;
let mut s = OsString::from("Grüße, Jürgen ❤");
s.make_ascii_uppercase();
assert_eq!("GRüßE, JüRGEN ❤", s);pub fn to_ascii_lowercase(&self) -> OsString
Returns a copy of this string where each character is mapped to its ASCII lower case equivalent.
ASCII letters ‘A’ to ‘Z’ are mapped to ‘a’ to ‘z’, but non-ASCII letters are unchanged.
To lowercase the value in-place, use OsStr::make_ascii_lowercase.
Examples
use std::ffi::OsString;
let s = OsString::from("Grüße, Jürgen ❤");
assert_eq!("grüße, jürgen ❤", s.to_ascii_lowercase());pub fn to_ascii_uppercase(&self) -> OsString
Returns a copy of this string where each character is mapped to its ASCII upper case equivalent.
ASCII letters ‘a’ to ‘z’ are mapped to ‘A’ to ‘Z’, but non-ASCII letters are unchanged.
To uppercase the value in-place, use OsStr::make_ascii_uppercase.
Examples
use std::ffi::OsString;
let s = OsString::from("Grüße, Jürgen ❤");
assert_eq!("GRüßE, JüRGEN ❤", s.to_ascii_uppercase());pub fn is_ascii(&self) -> bool
Checks if all characters in this string are within the ASCII range.
Examples
use std::ffi::OsString;
let ascii = OsString::from("hello!\n");
let non_ascii = OsString::from("Grüße, Jürgen ❤");
assert!(ascii.is_ascii());
assert!(!non_ascii.is_ascii());pub fn eq_ignore_ascii_case<S: AsRef<OsStr>>(&self, other: S) -> bool
Checks that two strings are an ASCII case-insensitive match.
Same as to_ascii_lowercase(a) == to_ascii_lowercase(b), but without allocating and copying temporaries.
Examples
use std::ffi::OsString;
assert!(OsString::from("Ferris").eq_ignore_ascii_case("FERRIS"));
assert!(OsString::from("Ferrös").eq_ignore_ascii_case("FERRöS"));
assert!(!OsString::from("Ferrös").eq_ignore_ascii_case("FERRÖS"));Trait Implementations
impl AsRef<OsStr> for OsString
fn as_ref(&self) -> &OsStr
Performs the conversion.
impl AsRef<Path> for OsString
fn as_ref(&self) -> &Path
Performs the conversion.
impl Borrow<OsStr> for OsString
impl Clone for OsString
fn clone(&self) -> Self
Returns a copy of the value. Read more
fn clone_from(&mut self, source: &Self)
Performs copy-assignment from source. Read more
impl Debug for OsString
fn fmt(&self, formatter: &mut Formatter<'_>) -> Result
Formats the value using the given formatter. Read more
impl Default for OsString
fn default() -> OsString
Constructs an empty OsString.
impl Deref for OsString
type Target = OsStr
The resulting type after dereferencing.
fn deref(&self) -> &OsStr
Dereferences the value.
impl DerefMut for OsString
fn deref_mut(&mut self) -> &mut OsStr
Mutably dereferences the value.
impl<'a> Extend<&'a OsStr> for OsString
fn extend<T: IntoIterator<Item = &'a OsStr>>(&mut self, iter: T)
Extends a collection with the contents of an iterator. Read more
fn extend_one(&mut self, item: A)
Extends a collection with exactly one element.
fn extend_reserve(&mut self, additional: usize)
Reserves capacity in a collection for the given number of additional elements. Read more
impl<'a> Extend<Cow<'a, OsStr>> for OsString
fn extend<T: IntoIterator<Item = Cow<'a, OsStr>>>(&mut self, iter: T)
Extends a collection with the contents of an iterator. Read more
fn extend_one(&mut self, item: A)
Extends a collection with exactly one element.
fn extend_reserve(&mut self, additional: usize)
Reserves capacity in a collection for the given number of additional elements. Read more
impl Extend<OsString> for OsString
fn extend<T: IntoIterator<Item = OsString>>(&mut self, iter: T)
Extends a collection with the contents of an iterator. Read more
fn extend_one(&mut self, item: A)
Extends a collection with exactly one element.
fn extend_reserve(&mut self, additional: usize)
Reserves capacity in a collection for the given number of additional elements. Read more
impl<T: ?Sized + AsRef<OsStr>> From<&'_ T> for OsString
fn from(s: &T) -> OsString
Performs the conversion.
impl<'a> From<&'a OsString> for Cow<'a, OsStr>
fn from(s: &'a OsString) -> Cow<'a, OsStr>
Performs the conversion.
impl From<Box<OsStr, Global>> for OsString
fn from(boxed: Box<OsStr>) -> OsString
impl<'a> From<Cow<'a, OsStr>> for OsString
fn from(s: Cow<'a, OsStr>) -> Self
Performs the conversion.
impl From<OsString> for Box<OsStr>
fn from(s: OsString) -> Box<OsStr>
impl<I, A> Iterator for Box<I, A> where
I: Iterator + ?Sized,
A: Allocator,
type Item = <I as Iterator>::Item;
impl<F, A> Future for Box<F, A> where
F: Future + Unpin + ?Sized,
A: Allocator + 'static,
type Output = <F as Future>::Output;
impl<R: Read + ?Sized> Read for Box<R>
impl<W: Write + ?Sized> Write for Box<W>
impl From<OsString> for Arc<OsStr>
fn from(s: OsString) -> Arc<OsStr>
impl From<OsString> for Rc<OsStr>
fn from(s: OsString) -> Rc<OsStr>
impl<'a> From<OsString> for Cow<'a, OsStr>
fn from(s: OsString) -> Cow<'a, OsStr>
Performs the conversion.
impl From<OsString> for PathBuf
fn from(s: OsString) -> PathBuf
impl From<PathBuf> for OsString
fn from(path_buf: PathBuf) -> OsString
impl From<String> for OsString
fn from(s: String) -> OsString
impl<'a> FromIterator<&'a OsStr> for OsString
fn from_iter<I: IntoIterator<Item = &'a OsStr>>(iter: I) -> Self
Creates a value from an iterator. Read more
impl<'a> FromIterator<Cow<'a, OsStr>> for OsString
fn from_iter<I: IntoIterator<Item = Cow<'a, OsStr>>>(iter: I) -> Self
Creates a value from an iterator. Read more
impl FromIterator<OsString> for OsString
fn from_iter<I: IntoIterator<Item = OsString>>(iter: I) -> Self
Creates a value from an iterator. Read more
impl FromStr for OsString
type Err = Infallible
The associated error which can be returned from parsing.
fn from_str(s: &str) -> Result<Self, Self::Err>
Parses a string s to return a value of this type. Read more
impl Hash for OsString
fn hash<H: Hasher>(&self, state: &mut H)
impl Index<RangeFull> for OsString
type Output = OsStr
The returned type after indexing.
fn index(&self, _index: RangeFull) -> &OsStr
Performs the indexing (container[index]) operation. Read more
impl IndexMut<RangeFull> for OsString
fn index_mut(&mut self, _index: RangeFull) -> &mut OsStr
Performs the mutable indexing (container[index]) operation. Read more
impl Ord for OsString
fn cmp(&self, other: &OsString) -> Ordering
fn max(self, other: Self) -> Self
Compares and returns the maximum of two values. Read more
fn min(self, other: Self) -> Self
Compares and returns the minimum of two values. Read more
fn clamp(self, min: Self, max: Self) -> Self
Restrict a value to a certain interval. Read more
fn from_vec(vec: Vec<u8>) -> OsString
fn into_vec(self) -> Vec<u8>
fn from_vec(vec: Vec<u8>) -> OsString
fn into_vec(self) -> Vec<u8>
fn from_wide(wide: &[u16]) -> OsString
Creates an OsString from a potentially ill-formed UTF-16 slice of 16-bit code units. Read more
impl PartialEq<&'_ str> for OsString
fn eq(&self, other: &&str) -> bool
This method tests for self and other values to be equal, and is used by ==. Read more
fn ne(&self, other: &Rhs) -> bool
This method tests for !=.
impl<'a, 'b> PartialEq<&'a OsStr> for OsString
fn eq(&self, other: &&'a OsStr) -> bool
This method tests for self and other values to be equal, and is used by ==. Read more
fn ne(&self, other: &Rhs) -> bool
This method tests for !=.
impl<'a, 'b> PartialEq<&'a Path> for OsString
fn eq(&self, other: &&'a Path) -> bool
This method tests for self and other values to be equal, and is used by ==. Read more
fn ne(&self, other: &Rhs) -> bool
This method tests for !=.
impl<'a, 'b> PartialEq<Cow<'a, OsStr>> for OsString
fn eq(&self, other: &Cow<'a, OsStr>) -> bool
This method tests for self and other values to be equal, and is used by ==. Read more
fn ne(&self, other: &Rhs) -> bool
This method tests for !=.
impl<'a, 'b> PartialEq<Cow<'a, Path>> for OsString
fn eq(&self, other: &Cow<'a, Path>) -> bool
This method tests for self and other values to be equal, and is used by ==. Read more
fn ne(&self, other: &Rhs) -> bool
This method tests for !=.
impl<'a, 'b> PartialEq<OsStr> for OsString
fn eq(&self, other: &OsStr) -> bool
This method tests for self and other values to be equal, and is used by ==. Read more
fn ne(&self, other: &Rhs) -> bool
This method tests for !=.
impl PartialEq<OsString> for OsString
fn eq(&self, other: &OsString) -> bool
This method tests for self and other values to be equal, and is used by ==. Read more
fn ne(&self, other: &Rhs) -> bool
This method tests for !=.
impl PartialEq<OsString> for str
fn eq(&self, other: &OsString) -> bool
This method tests for self and other values to be equal, and is used by ==. Read more
fn ne(&self, other: &Rhs) -> bool
This method tests for !=.
impl<'a> PartialEq<OsString> for &'a str
fn eq(&self, other: &OsString) -> bool
This method tests for self and other values to be equal, and is used by ==. Read more
fn ne(&self, other: &Rhs) -> bool
This method tests for !=.
impl<'a, 'b> PartialEq<OsString> for OsStr
fn eq(&self, other: &OsString) -> bool
This method tests for self and other values to be equal, and is used by ==. Read more
fn ne(&self, other: &Rhs) -> bool
This method tests for !=.
impl<'a, 'b> PartialEq<OsString> for &'a OsStr
fn eq(&self, other: &OsString) -> bool
This method tests for self and other values to be equal, and is used by ==. Read more
fn ne(&self, other: &Rhs) -> bool
This method tests for !=.
impl<'a, 'b> PartialEq<OsString> for Cow<'a, OsStr>
fn eq(&self, other: &OsString) -> bool
This method tests for self and other values to be equal, and is used by ==. Read more
fn ne(&self, other: &Rhs) -> bool
This method tests for !=.
impl<'a, 'b> PartialEq<OsString> for PathBuf
fn eq(&self, other: &OsString) -> bool
This method tests for self and other values to be equal, and is used by ==. Read more
fn ne(&self, other: &Rhs) -> bool
This method tests for !=.
impl<'a, 'b> PartialEq<OsString> for Path
fn eq(&self, other: &OsString) -> bool
This method tests for self and other values to be equal, and is used by ==. Read more
fn ne(&self, other: &Rhs) -> bool
This method tests for !=.
impl<'a, 'b> PartialEq<OsString> for &'a Path
fn eq(&self, other: &OsString) -> bool
This method tests for self and other values to be equal, and is used by ==. Read more
fn ne(&self, other: &Rhs) -> bool
This method tests for !=.
impl<'a, 'b> PartialEq<OsString> for Cow<'a, Path>
fn eq(&self, other: &OsString) -> bool
This method tests for self and other values to be equal, and is used by ==. Read more
fn ne(&self, other: &Rhs) -> bool
This method tests for !=.
impl<'a, 'b> PartialEq<Path> for OsString
fn eq(&self, other: &Path) -> bool
This method tests for self and other values to be equal, and is used by ==. Read more
fn ne(&self, other: &Rhs) -> bool
This method tests for !=.
impl<'a, 'b> PartialEq<PathBuf> for OsString
fn eq(&self, other: &PathBuf) -> bool
This method tests for self and other values to be equal, and is used by ==. Read more
fn ne(&self, other: &Rhs) -> bool
This method tests for !=.
impl PartialEq<str> for OsString
fn eq(&self, other: &str) -> bool
This method tests for self and other values to be equal, and is used by ==. Read more
fn ne(&self, other: &Rhs) -> bool
This method tests for !=.
impl<'a, 'b> PartialOrd<&'a OsStr> for OsString
fn partial_cmp(&self, other: &&'a OsStr) -> Option<Ordering>
This method returns an ordering between self and other values if one exists. Read more
fn lt(&self, other: &Rhs) -> bool
This method tests less than (for self and other) and is used by the < operator. Read more
fn le(&self, other: &Rhs) -> bool
This method tests less than or equal to (for self and other) and is used by the <= operator. Read more
fn gt(&self, other: &Rhs) -> bool
This method tests greater than (for self and other) and is used by the > operator. Read more
fn ge(&self, other: &Rhs) -> bool
This method tests greater than or equal to (for self and other) and is used by the >= operator. Read more
impl<'a, 'b> PartialOrd<&'a Path> for OsString
fn partial_cmp(&self, other: &&'a Path) -> Option<Ordering>
This method returns an ordering between self and other values if one exists. Read more
fn lt(&self, other: &Rhs) -> bool
This method tests less than (for self and other) and is used by the < operator. Read more
fn le(&self, other: &Rhs) -> bool
This method tests less than or equal to (for self and other) and is used by the <= operator. Read more
fn gt(&self, other: &Rhs) -> bool
This method tests greater than (for self and other) and is used by the > operator. Read more
fn ge(&self, other: &Rhs) -> bool
This method tests greater than or equal to (for self and other) and is used by the >= operator. Read more
impl<'a, 'b> PartialOrd<Cow<'a, OsStr>> for OsString
fn partial_cmp(&self, other: &Cow<'a, OsStr>) -> Option<Ordering>
This method returns an ordering between self and other values if one exists. Read more
fn lt(&self, other: &Rhs) -> bool
This method tests less than (for self and other) and is used by the < operator. Read more
fn le(&self, other: &Rhs) -> bool
This method tests less than or equal to (for self and other) and is used by the <= operator. Read more
fn gt(&self, other: &Rhs) -> bool
This method tests greater than (for self and other) and is used by the > operator. Read more
fn ge(&self, other: &Rhs) -> bool
This method tests greater than or equal to (for self and other) and is used by the >= operator. Read more
impl<'a, 'b> PartialOrd<Cow<'a, Path>> for OsString
fn partial_cmp(&self, other: &Cow<'a, Path>) -> Option<Ordering>
This method returns an ordering between self and other values if one exists. Read more
fn lt(&self, other: &Rhs) -> bool
This method tests less than (for self and other) and is used by the < operator. Read more
fn le(&self, other: &Rhs) -> bool
This method tests less than or equal to (for self and other) and is used by the <= operator. Read more
fn gt(&self, other: &Rhs) -> bool
This method tests greater than (for self and other) and is used by the > operator. Read more
fn ge(&self, other: &Rhs) -> bool
This method tests greater than or equal to (for self and other) and is used by the >= operator. Read more
impl<'a, 'b> PartialOrd<OsStr> for OsString
fn partial_cmp(&self, other: &OsStr) -> Option<Ordering>
This method returns an ordering between self and other values if one exists. Read more
fn lt(&self, other: &Rhs) -> bool
This method tests less than (for self and other) and is used by the < operator. Read more
fn le(&self, other: &Rhs) -> bool
This method tests less than or equal to (for self and other) and is used by the <= operator. Read more
fn gt(&self, other: &Rhs) -> bool
This method tests greater than (for self and other) and is used by the > operator. Read more
fn ge(&self, other: &Rhs) -> bool
This method tests greater than or equal to (for self and other) and is used by the >= operator. Read more
impl PartialOrd<OsString> for OsString
fn partial_cmp(&self, other: &OsString) -> Option<Ordering>
This method returns an ordering between self and other values if one exists. Read more
fn lt(&self, other: &OsString) -> bool
This method tests less than (for self and other) and is used by the < operator. Read more
fn le(&self, other: &OsString) -> bool
This method tests less than or equal to (for self and other) and is used by the <= operator. Read more
fn gt(&self, other: &OsString) -> bool
This method tests greater than (for self and other) and is used by the > operator. Read more
fn ge(&self, other: &OsString) -> bool
This method tests greater than or equal to (for self and other) and is used by the >= operator. Read more
impl<'a, 'b> PartialOrd<OsString> for OsStr
fn partial_cmp(&self, other: &OsString) -> Option<Ordering>
This method returns an ordering between self and other values if one exists. Read more
fn lt(&self, other: &Rhs) -> bool
This method tests less than (for self and other) and is used by the < operator. Read more
fn le(&self, other: &Rhs) -> bool
This method tests less than or equal to (for self and other) and is used by the <= operator. Read more
fn gt(&self, other: &Rhs) -> bool
This method tests greater than (for self and other) and is used by the > operator. Read more
fn ge(&self, other: &Rhs) -> bool
This method tests greater than or equal to (for self and other) and is used by the >= operator. Read more
impl<'a, 'b> PartialOrd<OsString> for &'a OsStr
fn partial_cmp(&self, other: &OsString) -> Option<Ordering>
This method returns an ordering between self and other values if one exists. Read more
fn lt(&self, other: &Rhs) -> bool
This method tests less than (for self and other) and is used by the < operator. Read more
fn le(&self, other: &Rhs) -> bool
This method tests less than or equal to (for self and other) and is used by the <= operator. Read more
fn gt(&self, other: &Rhs) -> bool
This method tests greater than (for self and other) and is used by the > operator. Read more
fn ge(&self, other: &Rhs) -> bool
This method tests greater than or equal to (for self and other) and is used by the >= operator. Read more
impl<'a, 'b> PartialOrd<OsString> for Cow<'a, OsStr>
fn partial_cmp(&self, other: &OsString) -> Option<Ordering>
This method returns an ordering between self and other values if one exists. Read more
fn lt(&self, other: &Rhs) -> bool
This method tests less than (for self and other) and is used by the < operator. Read more
fn le(&self, other: &Rhs) -> bool
This method tests less than or equal to (for self and other) and is used by the <= operator. Read more
fn gt(&self, other: &Rhs) -> bool
This method tests greater than (for self and other) and is used by the > operator. Read more
fn ge(&self, other: &Rhs) -> bool
This method tests greater than or equal to (for self and other) and is used by the >= operator. Read more
impl<'a, 'b> PartialOrd<OsString> for PathBuf
fn partial_cmp(&self, other: &OsString) -> Option<Ordering>
This method returns an ordering between self and other values if one exists. Read more
fn lt(&self, other: &Rhs) -> bool
This method tests less than (for self and other) and is used by the < operator. Read more
fn le(&self, other: &Rhs) -> bool
This method tests less than or equal to (for self and other) and is used by the <= operator. Read more
fn gt(&self, other: &Rhs) -> bool
This method tests greater than (for self and other) and is used by the > operator. Read more
fn ge(&self, other: &Rhs) -> bool
This method tests greater than or equal to (for self and other) and is used by the >= operator. Read more
impl<'a, 'b> PartialOrd<OsString> for Path
fn partial_cmp(&self, other: &OsString) -> Option<Ordering>
This method returns an ordering between self and other values if one exists. Read more
fn lt(&self, other: &Rhs) -> bool
This method tests less than (for self and other) and is used by the < operator. Read more
fn le(&self, other: &Rhs) -> bool
This method tests less than or equal to (for self and other) and is used by the <= operator. Read more
fn gt(&self, other: &Rhs) -> bool
This method tests greater than (for self and other) and is used by the > operator. Read more
fn ge(&self, other: &Rhs) -> bool
This method tests greater than or equal to (for self and other) and is used by the >= operator. Read more
impl<'a, 'b> PartialOrd<OsString> for &'a Path
fn partial_cmp(&self, other: &OsString) -> Option<Ordering>
This method returns an ordering between self and other values if one exists. Read more
fn lt(&self, other: &Rhs) -> bool
This method tests less than (for self and other) and is used by the < operator. Read more
fn le(&self, other: &Rhs) -> bool
This method tests less than or equal to (for self and other) and is used by the <= operator. Read more
fn gt(&self, other: &Rhs) -> bool
This method tests greater than (for self and other) and is used by the > operator. Read more
fn ge(&self, other: &Rhs) -> bool
This method tests greater than or equal to (for self and other) and is used by the >= operator. Read more
impl<'a, 'b> PartialOrd<OsString> for Cow<'a, Path>
fn partial_cmp(&self, other: &OsString) -> Option<Ordering>
This method returns an ordering between self and other values if one exists. Read more
fn lt(&self, other: &Rhs) -> bool
This method tests less than (for self and other) and is used by the < operator. Read more
fn le(&self, other: &Rhs) -> bool
This method tests less than or equal to (for self and other) and is used by the <= operator. Read more
fn gt(&self, other: &Rhs) -> bool
This method tests greater than (for self and other) and is used by the > operator. Read more
fn ge(&self, other: &Rhs) -> bool
This method tests greater than or equal to (for self and other) and is used by the >= operator. Read more
impl<'a, 'b> PartialOrd<Path> for OsString
fn partial_cmp(&self, other: &Path) -> Option<Ordering>
This method returns an ordering between self and other values if one exists. Read more
fn lt(&self, other: &Rhs) -> bool
This method tests less than (for self and other) and is used by the < operator. Read more
fn le(&self, other: &Rhs) -> bool
This method tests less than or equal to (for self and other) and is used by the <= operator. Read more
fn gt(&self, other: &Rhs) -> bool
This method tests greater than (for self and other) and is used by the > operator. Read more
fn ge(&self, other: &Rhs) -> bool
This method tests greater than or equal to (for self and other) and is used by the >= operator. Read more
impl<'a, 'b> PartialOrd<PathBuf> for OsString
fn partial_cmp(&self, other: &PathBuf) -> Option<Ordering>
This method returns an ordering between self and other values if one exists. Read more
fn lt(&self, other: &Rhs) -> bool
This method tests less than (for self and other) and is used by the < operator. Read more
fn le(&self, other: &Rhs) -> bool
This method tests less than or equal to (for self and other) and is used by the <= operator. Read more
fn gt(&self, other: &Rhs) -> bool
This method tests greater than (for self and other) and is used by the > operator. Read more
fn ge(&self, other: &Rhs) -> bool
This method tests greater than or equal to (for self and other) and is used by the >= operator. Read more
impl PartialOrd<str> for OsString
fn partial_cmp(&self, other: &str) -> Option<Ordering>
This method returns an ordering between self and other values if one exists. Read more
fn lt(&self, other: &Rhs) -> bool
This method tests less than (for self and other) and is used by the < operator. Read more
fn le(&self, other: &Rhs) -> bool
This method tests less than or equal to (for self and other) and is used by the <= operator. Read more
fn gt(&self, other: &Rhs) -> bool
This method tests greater than (for self and other) and is used by the > operator. Read more
fn ge(&self, other: &Rhs) -> bool
This method tests greater than or equal to (for self and other) and is used by the >= operator. Read more
impl Eq for OsString
Auto Trait Implementations
impl RefUnwindSafe for OsString
impl Send for OsString
impl Sync for OsString
impl Unpin for OsString
impl UnwindSafe for OsString
Blanket Implementations
impl<T> From<T> for T
pub fn from(t: T) -> T
Performs the conversion.
pub fn into(self) -> U
Performs the conversion.
type Owned = T
The resulting type after obtaining ownership.
pub fn to_owned(&self) -> T
Creates owned data from borrowed data, usually by cloning. Read more
pub fn clone_into(&self, target: &mut T)
toowned_clone_into #41263)recently added
Uses borrowed data to replace owned data, usually by cloning. Read more
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>
Performs the conversion.
type Error = <U as TryFrom<T>>::Error
The type returned in the event of a conversion error.
pub fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>
Performs the conversion.
© 2010 The Rust Project Developers
Licensed under the Apache License, Version 2.0 or the MIT license, at your option.
https://doc.rust-lang.org/std/ffi/struct.OsString.html