windows-strings 0.100.0

Windows string types
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61

#![doc = include_str!("../readme.md")]
#![cfg_attr(
    windows,
    debugger_visualizer(natvis_file = "../windows-strings.natvis")
)]
#![cfg_attr(all(not(feature = "std")), no_std)]

// `HSTRING` and its supporting types are cross-platform: the only Win32 dependency is the
// heap allocator, which `hstring_header` swaps at compile time. On Windows it uses the
// process heap (so HSTRINGs interoperate with native code); elsewhere it uses the Rust
// global allocator.
//
// `BSTR` and the `bindings` module are inherently Win32 - `BSTR` is part of the OLE
// Automation ABI and must use `SysAllocStringLen`/`SysFreeString` so callers across the
// FFI boundary can free strings allocated here - and therefore stay gated to Windows.

extern crate alloc;
use alloc::string::String;

#[cfg(windows)]
mod bstr;
#[cfg(windows)]
pub use bstr::*;

mod hstring;
pub use hstring::*;

mod hstring_builder;
pub use hstring_builder::*;

mod hstring_header;
use hstring_header::*;

#[cfg(windows)]
#[expect(clippy::upper_case_acronyms)]
mod bindings;

mod decode;
use decode::*;

mod ref_count;
use ref_count::*;

mod literals;
pub use literals::*;

mod pcstr;
pub use pcstr::*;

mod pcwstr;
pub use pcwstr::*;

mod pstr;
pub use pstr::*;

mod pwstr;
pub use pwstr::*;

unsafe extern "C" {
    fn strlen(s: *const core::ffi::c_char) -> usize;
}