Windy

Windows string library for ANSI strings and wide strings.

Features

• Owned ANSI strings: AString.
• Owned wide strings: WString.
• Borrowed ANSI strings: AStr.
• Borrowed wide strings: WStr.
• Dynamically-code-paged ANSI strings: DAString and DAStr.
• Windows ANSI_STRING and UNICODE_STRING wrappers.
• Conversions between ANSI strings, wide strings, and UTF-8 String values.
• no_std support for borrowed string types.

Installation

Add this crate to Cargo.toml:

[dependencies]

windy = "0.4.0"

no_std support

Disable default features to build without std:

--no-default-features

Owned string types are available only with the std feature.

Macros

windy-macros crate provides compile-time conversion from UTF-8 string literals to ANSI strings or wide strings.

[dependencies]

windy = "0.4.0"

windy-macros = "0.3.0"

Example

use std::ffi::c_void;
use windy::WStr;
use windy_macros::wstr;

#[allow(non_snake_case)]
#[link(name = "user32")]
unsafe extern "system" {
    pub fn MessageBoxW(
        hWnd: *mut c_void,
        lpText: *const u16,
        lpCaption: *const u16,
        uType: u32,
    ) -> i32;
}

const MB_OK: u32 = 0;

fn main() {
    let text: &WStr = wstr!("World");
    let caption: &WStr = wstr!("CaptionW");
    unsafe {
        MessageBoxW(std::ptr::null_mut(), text.as_ptr(), caption.as_ptr(), MB_OK);
    }
}

License

This software is released under the MIT or Apache-2.0 License, see LICENSE-MIT or LICENSE-APACHE.