Struct windows::BString

#[repr(transparent)]pub struct BString(_);

A Basic string, sometimes called a BSTR, is a string data type used by certain COM interfaces and interop functions.

Implementations

impl BString

pub fn new() -> Self

Create an empty BString.

This function does no allocation.

pub fn is_empty(&self) -> bool

Returns true if the string is empty.

pub fn len(&self) -> usize

Returns the length of self.

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

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

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

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

pub fn to_string_lossy(&self) -> String

Get the contents of this BString as a String lossily.

pub fn clear(&mut self)

Frees the memory occupied by the string.

Trait Implementations

impl Abi for BString

type Abi = RawPtr

The abi representation of the implementing type.

fn set_abi(&mut self) -> *mut RawPtr

Returns a pointer for setting the object's value via an ABI call.

fn abi(&self) -> Self::Abi

Casts the Rust object to its ABI type without copying the object.

unsafe fn from_abi(abi: Self::Abi) -> Result<Self>

Casts the ABI representation to a Rust object by taking ownership of the bits.

impl Clone for BString

fn clone(&self) -> Self

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for BString

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

Formats the value using the given formatter.

impl Default for BString

fn default() -> Self

Returns the "default value" for a type.

impl Display for BString

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

Formats the value using the given formatter.

impl Drop for BString

fn drop(&mut self)

Executes the destructor for this type.

impl From<&'_ String> for BString

fn from(value: &String) -> Self

Performs the conversion.

impl From<&'_ str> for BString

fn from(value: &str) -> Self

Performs the conversion.

impl From<String> for BString

fn from(value: String) -> Self

Performs the conversion.

impl PartialEq<&'_ str> for BString

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

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

#[must_use]pub fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl PartialEq<BString> for BString

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

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

#[must_use]pub fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl PartialEq<BString> for &str

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

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

#[must_use]pub fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl PartialEq<String> for BString

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

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

#[must_use]pub fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl PartialEq<str> for BString

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

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

#[must_use]pub fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

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

type Error = FromUtf16Error

The type returned in the event of a conversion error.

fn try_from(value: &BString) -> StdResult<Self, Self::Error>

Performs the conversion.

impl TryFrom<BString> for String

type Error = FromUtf16Error

The type returned in the event of a conversion error.

fn try_from(value: BString) -> StdResult<Self, Self::Error>

Performs the conversion.