Struct windows::HString

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

A WinRT string, sometimes called an HSTRING, is reference-counted and logically immutable. It should only be used for communicating with WinRT APIs.

Implementations

impl HString

pub fn new() -> Self

Create an empty HString.

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 HString from a slice of 16 bit characters (wchars).

pub fn to_string_lossy(&self) -> String

Get the contents of this HString as a String lossily.

pub fn clear(&mut self)

Clear the contents of the string and free the memory if self holds the last reference to the string data.

Trait Implementations

impl Abi for HString

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.

fn drop_param(_: &mut Param<'_, Self>)

impl Clone for HString

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 HString

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

Formats the value using the given formatter.

impl Default for HString

fn default() -> Self

Returns the “default value” for a type.

impl Display for HString

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

Formats the value using the given formatter.

impl Drop for HString

fn drop(&mut self)

Executes the destructor for this type.

impl From<&'_ String> for HString

fn from(value: &String) -> Self

Performs the conversion.

impl From<&'_ str> for HString

fn from(value: &str) -> Self

Performs the conversion.

impl From<String> for HString

fn from(value: String) -> Self

Performs the conversion.

impl<'a> IntoParam<'a, HString> for &'a str

fn into_param(self) -> Param<'a, HString>

impl<'a> IntoParam<'a, HString> for String

fn into_param(self) -> Param<'a, HString>

impl PartialEq<&'_ str> for HString

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<HString> for HString

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<String> for HString

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 HString

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 RuntimeType for HString

type DefaultType = Self

const SIGNATURE: ConstBuffer

impl TryFrom<&'_ HString> for Object

type Error = Error

The type returned in the event of a conversion error.

fn try_from(value: &HString) -> Result<Self>

Performs the conversion.

impl TryFrom<&'_ Object> for HString

type Error = Error

The type returned in the event of a conversion error.

fn try_from(value: &Object) -> Result<Self>

Performs the conversion.

impl TryFrom<HString> for Object

type Error = Error

The type returned in the event of a conversion error.

fn try_from(value: HString) -> Result<Self>

Performs the conversion.

impl TryFrom<Object> for HString

type Error = Error

The type returned in the event of a conversion error.

fn try_from(value: Object) -> Result<Self>

Performs the conversion.