diff options
Diffstat (limited to 'vendor/windows-strings/src/bstr.rs')
| -rw-r--r-- | vendor/windows-strings/src/bstr.rs | 166 |
1 files changed, 0 insertions, 166 deletions
diff --git a/vendor/windows-strings/src/bstr.rs b/vendor/windows-strings/src/bstr.rs deleted file mode 100644 index 486b2602..00000000 --- a/vendor/windows-strings/src/bstr.rs +++ /dev/null @@ -1,166 +0,0 @@ -use super::*; -use core::ops::Deref; - -/// A BSTR string ([BSTR](https://learn.microsoft.com/en-us/previous-versions/windows/desktop/automat/string-manipulation-functions)) -/// is a length-prefixed wide string. -#[repr(transparent)] -pub struct BSTR(*const u16); - -impl BSTR { - /// Create an empty `BSTR`. - /// - /// This function does not allocate memory. - pub const fn new() -> Self { - Self(core::ptr::null_mut()) - } - - /// Create a `BSTR` from a slice of 16 bit characters (wchars). - pub fn from_wide(value: &[u16]) -> Self { - if value.is_empty() { - return Self::new(); - } - - let result = unsafe { - Self(bindings::SysAllocStringLen( - value.as_ptr(), - value.len().try_into().unwrap(), - )) - }; - - if result.is_empty() { - panic!("allocation failed"); - } - - result - } - - /// # Safety - #[doc(hidden)] - pub unsafe fn from_raw(raw: *const u16) -> Self { - Self(raw) - } - - /// # Safety - #[doc(hidden)] - pub fn into_raw(self) -> *const u16 { - unsafe { core::mem::transmute(self) } - } -} - -impl Deref for BSTR { - type Target = [u16]; - - fn deref(&self) -> &[u16] { - let len = if self.0.is_null() { - 0 - } else { - unsafe { bindings::SysStringLen(self.0) as usize } - }; - - if len > 0 { - unsafe { core::slice::from_raw_parts(self.0, len) } - } else { - // This ensures that if `as_ptr` is called on the slice that the resulting pointer - // will still refer to a null-terminated string. - const EMPTY: [u16; 1] = [0]; - &EMPTY[..0] - } - } -} - -impl Clone for BSTR { - fn clone(&self) -> Self { - Self::from_wide(self) - } -} - -impl From<&str> for BSTR { - fn from(value: &str) -> Self { - let value: alloc::vec::Vec<u16> = value.encode_utf16().collect(); - Self::from_wide(&value) - } -} - -impl From<String> for BSTR { - fn from(value: String) -> Self { - value.as_str().into() - } -} - -impl From<&String> for BSTR { - fn from(value: &String) -> Self { - value.as_str().into() - } -} - -impl TryFrom<&BSTR> for String { - type Error = alloc::string::FromUtf16Error; - - fn try_from(value: &BSTR) -> core::result::Result<Self, Self::Error> { - String::from_utf16(value) - } -} - -impl TryFrom<BSTR> for String { - type Error = alloc::string::FromUtf16Error; - - fn try_from(value: BSTR) -> core::result::Result<Self, Self::Error> { - String::try_from(&value) - } -} - -impl Default for BSTR { - fn default() -> Self { - Self(core::ptr::null_mut()) - } -} - -impl core::fmt::Display for BSTR { - fn fmt(&self, f: &mut core::fmt::Formatter<'_>) -> core::fmt::Result { - core::write!( - f, - "{}", - Decode(|| core::char::decode_utf16(self.iter().cloned())) - ) - } -} - -impl core::fmt::Debug for BSTR { - fn fmt(&self, f: &mut core::fmt::Formatter<'_>) -> core::fmt::Result { - core::write!(f, "{self}") - } -} - -impl PartialEq for BSTR { - fn eq(&self, other: &Self) -> bool { - self.deref() == other.deref() - } -} - -impl Eq for BSTR {} - -impl PartialEq<BSTR> for &str { - fn eq(&self, other: &BSTR) -> bool { - other == self - } -} - -impl PartialEq<BSTR> for String { - fn eq(&self, other: &BSTR) -> bool { - other == self - } -} - -impl<T: AsRef<str> + ?Sized> PartialEq<T> for BSTR { - fn eq(&self, other: &T) -> bool { - self.iter().copied().eq(other.as_ref().encode_utf16()) - } -} - -impl Drop for BSTR { - fn drop(&mut self) { - if !self.0.is_null() { - unsafe { bindings::SysFreeString(self.0) } - } - } -} |
