W3cubDocs

/Rust

Trait std::os::windows::ffi::OsStrExt

pub trait OsStrExt {
    fn encode_wide(&self) -> EncodeWide;
}
This is supported on Windows only.

Windows-specific extensions to OsStr.

Required Methods

ⓘImportant traits for EncodeWide<'a>
impl<'a> Iterator for EncodeWide<'a>
    type Item = u16;

This is supported on Windows only.

Re-encodes an OsStr as a wide character sequence, i.e. potentially ill-formed UTF-16.

This is lossless: calling OsString::from_wide and then encode_wide on the result will yield the original code units. Note that the encoding does not add a final null terminator.

Examples

use std::ffi::OsString;
use std::os::windows::prelude::*;

// UTF-16 encoding for "Unicode".
let source = [0x0055, 0x006E, 0x0069, 0x0063, 0x006F, 0x0064, 0x0065];

let string = OsString::from_wide(&source[..]);

let result: Vec<u16> = string.encode_wide().collect();
assert_eq!(&source[..], &result[..]);

Implementors

impl OsStrExt for OsStr [src]

ⓘImportant traits for EncodeWide<'a>
impl<'a> Iterator for EncodeWide<'a>
    type Item = u16;
This is supported on Windows only.

© 2010 The Rust Project Developers
Licensed under the Apache License, Version 2.0 or the MIT license, at your option.
https://doc.rust-lang.org/std/os/windows/ffi/trait.OsStrExt.html