Struct Utf16Writer

pub struct Utf16Writer<'a> { /* private fields */ }

A helper type for writing string data into [u16] buffers.

This type is mainly useful for interop with libctru APIs that expect UTF-16 text as input. The writer implements the std::fmt::Write trait and ensures that the text is written in-bounds and properly nul-terminated.

Notes

Subsequent writes to the same Utf16Writer will append to the buffer instead of overwriting the existing contents. If you want to start over from the beginning of the buffer, simply create a new Utf16Writer.

If a write causes the buffer to reach the end of its capacity, std::fmt::Error will be returned, but all string data up until the end of the capacity will still be written.

Implementations

impl Utf16Writer<'_>

pub fn new(buf: &mut [u16]) -> Utf16Writer<'_>

Creates a new Utf16Writer that writes its output into the provided buffer.

Trait Implementations

impl Write for Utf16Writer<'_>

fn write_str(&mut self, s: &str) -> Result

Writes a string slice into this writer, returning whether the write succeeded.

fn write_char(&mut self, c: char) -> Result<(), Error>

Writes a [char] into this writer, returning whether the write succeeded.

fn write_fmt(&mut self, args: Arguments<'_>) -> Result<(), Error>

Glue for usage of the [write!] macro with implementors of this trait.