Struct WString

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

WString is the utf16 string, similar to std::wstring in cpp. It is used for passing utf16 string buffers between Rust and COM.

Implementations

impl WString

pub const fn new() -> WString

creates an empty string

pub const fn is_empty(&self) -> bool

returns if the string is empty

pub fn len(&self) -> usize

len is the utf16 len not including the null terminator bytes

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

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

pub fn to_string_lossy(&self) -> String

Get the contents of this WString as a String lossily.

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

Returns a raw pointer to the WString buffer.

pub fn as_pcwstr(&self) -> PCWSTR

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

From slice without the null terminator.

Trait Implementations

impl Clone for WString

fn clone(&self) -> WString

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for WString

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

Formats the value using the given formatter.

impl Default for WString

fn default() -> WString

Returns the “default value” for a type.

impl Display for WString

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

Formats the value using the given formatter.

impl From<&PCWSTR> for WString

fn from(value: &PCWSTR) -> WString

Requires value points to valid memory location Null is ok.

impl From<&String> for WString

fn from(value: &String) -> WString

Converts to this type from the input type.

impl From<&str> for WString

fn from(value: &str) -> WString

Converts to this type from the input type.

impl From<PCWSTR> for WString

fn from(value: PCWSTR) -> WString

Converts to this type from the input type.

impl From<String> for WString

fn from(value: String) -> WString

Converts to this type from the input type.

impl From<WString> for Uri

fn from(value: WString) -> Self

Converts to this type from the input type.

impl From<WString> for WStringWrap

fn from(value: WString) -> Self

Converts to this type from the input type.

impl From<WStringWrap> for WString

fn from(val: WStringWrap) -> Self

Converts to this type from the input type.

impl PartialEq for WString

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

Tests for self and other values to be equal, and is used by ==.

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

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

impl Eq for WString

impl StructuralPartialEq for WString