1 stable release
1.0.0 | Mar 31, 2020 |
---|
#138 in Windows APIs
3,962 downloads per month
Used in 8 crates
(2 directly)
12KB
148 lines
w32-error
w32-error is a Rust crate for encapsulating Windows API error codes. It provides the W32Error
type, a thin wrapper over a DWORD
with trait implementations for error handling.
Features
#![no_std]
-friendly - almost all of w32-error is available to#![no_std]
crates. Parts that require libstd (Error
trait impl, conversion to/fromio::Error
) are kept behind an opt-in feature gate.- Zero overhead -
W32Error
is guaranteed to have the same layout as aDWORD
.Display::fmt
doesn't access the heap; instead, it uses a small buffer on the stack to receive error messages.
Usage
To use w32-error, simply add it to your Cargo.toml
.
By default, w32-error is configured for a #![no_std]
environment:
[dependencies]
w32-error = "^1.0.0"
Alternatively, features that require libstd can be manually enabled:
[dependencies]
w32-error = { version = "^1.0.0", features = ["std"] }
For more details, see the API documentation.
License
Licensed under either of
- Apache License, Version 2.0, (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
- MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)
at your option.
Contribution
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.
Dependencies
~175KB