+ ///
+ /// If you work with Windows API, you may wish to convert [`OsStr`] to `Vec<u16>`:
+ ///
+ /// ```
+ /// #[cfg(windows)]
+ /// fn os_str_to_utf16(s: &std::ffi::OsStr) -> Vec<u16> {
+ /// use std::os::windows::ffi::OsStrExt;
+ /// s.encode_wide().chain(std::iter::once(0)).collect()
+ /// }
+ /// ```
+ ///
+ /// [`once`]: fn.once.html
+ /// [`Iterator`]: trait.Iterator.html
+ /// [`IntoIterator`]: trait.IntoIterator.html
+ /// [`OsStr`]: ../../std/ffi/struct.OsStr.html