#utf-16 #utf-32 #wide #winapi #string

no-std widestring

A wide string Rust library for converting to and from wide strings, such as those often used in Windows API or other FFI libaries. Both u16 and u32 string types are provided, including support for UTF-16 and UTF-32, malformed encoding, C-style strings, etc.

15 releases (4 stable)

1.1.0 Apr 6, 2024
1.0.2 Jul 15, 2022
1.0.1 Jun 24, 2022
1.0.0-beta.1 Nov 8, 2021
0.1.0 Jan 25, 2016

#181 in FFI

Download history 245895/week @ 2024-03-15 251219/week @ 2024-03-22 272551/week @ 2024-03-29 261285/week @ 2024-04-05 268939/week @ 2024-04-12 267890/week @ 2024-04-19 249134/week @ 2024-04-26 228511/week @ 2024-05-03 271532/week @ 2024-05-10 278122/week @ 2024-05-17 276608/week @ 2024-05-24 289924/week @ 2024-05-31 298487/week @ 2024-06-07 267577/week @ 2024-06-14 275627/week @ 2024-06-21 186515/week @ 2024-06-28

1,080,703 downloads per month
Used in 2,522 crates (179 directly)

MIT/Apache

525KB
7K SLoC

widestring

Crates.io Documentation Crates.io Build status

A wide string Rust library for converting to and from wide strings, such as those often used in Windows API or other FFI libaries. Both u16 and u32 string types are provided, including support for UTF-16 and UTF-32, malformed encoding, C-style strings, etc.

Macros for converting string literals to UTF-16 and UTF-32 strings at compile time are also included.

Requires Rust 1.58 or greater. If you need support for older versions of Rust, use 0.x versions of this crate.

Documentation

Optional Features

  • alloc - Enabled by default. Enable use of the alloc crate when not using the std library.

    This enables the owned string types and aliases.

  • std - Enabled by default. Enable features that depend on the Rust std library, including everything in the alloc feature.

  • debugger_visualizer Add debugger visualizer data for crate types. Requires Rust 1.71 or newer

License

This library is distributed under the terms of either of:

at your option.

This project is REUSE-compliant. Copyrights are retained by their contributors. Some files may include explicit copyright notices and/or license SPDX identifiers. For full authorship information, see the version control history.

Contributing

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

No runtime deps