Struct win_nfd::CoTaskMemWideString

pub struct CoTaskMemWideString(_);

A Wide String allocated with CoTaskMemAlloc.

Implementations

impl CoTaskMemWideString

pub fn new(data: &OsStr) -> Option<CoTaskMemWideString>

Allocate a new string.

Errors

• Returns None if the memory could not be allocated.

pub unsafe fn from_raw(ptr: NonNull<u16>) -> CoTaskMemWideString

Make a new CoTaskMemWideString from a non-null u16 ptr.

Safety

• ptr must be a valid nul-terminated widestring
• ptr must be allocated with CoTaskMemAlloc.

pub fn len(&self) -> usize

Get the length of the string.

This does not include the NUL terminator. This is O(n).

pub fn is_empty(&self) -> bool

Check if this string is empty.

This does not include the NUL terminator. This is O(n).

pub fn iter(&self) -> impl Iterator<Item = u16>

Iterate over the code points in this wide string.

This does not include the NUL terminator.

pub fn as_os_string(&self) -> OsString

Get this as an OsString.

This does not include the NUL terminator. This is O(n).

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

Get a slice from this.

This does not include the NUL terminator. This is O(n).

Trait Implementations

impl Debug for CoTaskMemWideString

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

Formats the value using the given formatter.

impl Drop for CoTaskMemWideString

fn drop(&mut self)

Executes the destructor for this type.