Struct windows_core::BSTR

pub struct BSTR(/* private fields */);

A BSTR string (BSTR) is a length-prefixed wide string.

Implementations

impl BSTR

pub const fn new() -> Self

Create an empty BSTR.

This function does not allocate memory.

pub fn is_empty(&self) -> bool

Returns true if the string is empty.

pub fn len(&self) -> usize

Returns the length of the string.

pub fn as_wide(&self) -> &[u16]

Get the string as 16-bit wide characters (wchars).

pub fn as_ptr(&self) -> *const u16

Returns a raw pointer to the BSTR buffer.

pub fn from_wide(value: &[u16]) -> Result<Self>

Create a BSTR from a slice of 16 bit characters (wchars).

Trait Implementations

impl Clone for BSTR

fn clone(&self) -> Self

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for BSTR

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for BSTR

fn default() -> Self

Returns the “default value” for a type.

impl Display for BSTR

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Drop for BSTR

fn drop(&mut self)

Executes the destructor for this type.

impl From<&String> for BSTR

fn from(value: &String) -> Self

Converts to this type from the input type.

impl From<&str> for BSTR

fn from(value: &str) -> Self

Converts to this type from the input type.

impl From<BSTR> for PROPVARIANT

fn from(value: BSTR) -> Self

Converts to this type from the input type.

impl From<BSTR> for VARIANT

fn from(value: BSTR) -> Self

Converts to this type from the input type.

impl From<String> for BSTR

fn from(value: String) -> Self

Converts to this type from the input type.

impl PartialEq<BSTR> for &str

fn eq(&self, other: &BSTR) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialEq<BSTR> for String

fn eq(&self, other: &BSTR) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<T: AsRef<str> + ?Sized> PartialEq<T> for BSTR

fn eq(&self, other: &T) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialEq for BSTR

fn eq(&self, other: &Self) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<'a> TryFrom<&'a BSTR> for String

type Error = FromUtf16Error

The type returned in the event of a conversion error.

fn try_from(value: &BSTR) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<&PROPVARIANT> for BSTR

type Error = Error

The type returned in the event of a conversion error.

fn try_from(from: &PROPVARIANT) -> Result<Self>

Performs the conversion.

impl TryFrom<&VARIANT> for BSTR

type Error = Error

The type returned in the event of a conversion error.

fn try_from(from: &VARIANT) -> Result<Self>

Performs the conversion.

impl TryFrom<BSTR> for String

type Error = FromUtf16Error

The type returned in the event of a conversion error.

fn try_from(value: BSTR) -> Result<Self, Self::Error>

Performs the conversion.

impl Eq for BSTR

impl Param<PCWSTR> for &BSTR