summaryrefslogtreecommitdiff
path: root/vendor/windows-strings/src/hstring_builder.rs
diff options
context:
space:
mode:
authormo khan <mo@mokhan.ca>2025-07-02 18:36:06 -0600
committermo khan <mo@mokhan.ca>2025-07-02 18:36:06 -0600
commit8cdfa445d6629ffef4cb84967ff7017654045bc2 (patch)
tree22f0b0907c024c78d26a731e2e1f5219407d8102 /vendor/windows-strings/src/hstring_builder.rs
parent4351c74c7c5f97156bc94d3a8549b9940ac80e3f (diff)
chore: add vendor directory
Diffstat (limited to 'vendor/windows-strings/src/hstring_builder.rs')
-rw-r--r--vendor/windows-strings/src/hstring_builder.rs100
1 files changed, 100 insertions, 0 deletions
diff --git a/vendor/windows-strings/src/hstring_builder.rs b/vendor/windows-strings/src/hstring_builder.rs
new file mode 100644
index 00000000..fcbe4d98
--- /dev/null
+++ b/vendor/windows-strings/src/hstring_builder.rs
@@ -0,0 +1,100 @@
+use super::*;
+
+/// An [HSTRING] builder that supports preallocating the `HSTRING` to avoid extra allocations and copies.
+///
+/// This is similar to the `WindowsPreallocateStringBuffer` function but implemented directly in Rust for efficiency.
+/// It is implemented as a separate type since [HSTRING] values are immutable.
+pub struct HStringBuilder(*mut HStringHeader);
+
+impl HStringBuilder {
+ /// Creates a preallocated `HSTRING` value.
+ pub fn new(len: usize) -> Self {
+ let header = HStringHeader::alloc(len.try_into().unwrap());
+
+ if len > 0 {
+ unsafe { core::ptr::write_bytes((*header).data, 0, len) };
+ }
+
+ Self(header)
+ }
+
+ /// Shortens the string by removing any trailing 0 characters.
+ pub fn trim_end(&mut self) {
+ if let Some(header) = self.as_header_mut() {
+ while header.len > 0
+ && unsafe { header.data.offset(header.len as isize - 1).read() == 0 }
+ {
+ header.len -= 1;
+ }
+
+ if header.len == 0 {
+ unsafe {
+ HStringHeader::free(self.0);
+ }
+ self.0 = core::ptr::null_mut();
+ }
+ }
+ }
+
+ /// Allows the `HSTRING` to be constructed from bytes.
+ pub fn as_bytes_mut(&mut self) -> &mut [u8] {
+ if let Some(header) = self.as_header() {
+ unsafe {
+ core::slice::from_raw_parts_mut(header.data as *mut _, header.len as usize * 2)
+ }
+ } else {
+ &mut []
+ }
+ }
+
+ fn as_header(&self) -> Option<&HStringHeader> {
+ unsafe { self.0.as_ref() }
+ }
+
+ fn as_header_mut(&mut self) -> Option<&mut HStringHeader> {
+ unsafe { self.0.as_mut() }
+ }
+}
+
+impl From<HStringBuilder> for HSTRING {
+ fn from(value: HStringBuilder) -> Self {
+ if let Some(header) = value.as_header() {
+ unsafe { header.data.offset(header.len as isize).write(0) };
+ let result = Self(value.0);
+ core::mem::forget(value);
+ result
+ } else {
+ Self::new()
+ }
+ }
+}
+
+impl core::ops::Deref for HStringBuilder {
+ type Target = [u16];
+
+ fn deref(&self) -> &[u16] {
+ if let Some(header) = self.as_header() {
+ unsafe { core::slice::from_raw_parts(header.data, header.len as usize) }
+ } else {
+ &[]
+ }
+ }
+}
+
+impl core::ops::DerefMut for HStringBuilder {
+ fn deref_mut(&mut self) -> &mut [u16] {
+ if let Some(header) = self.as_header() {
+ unsafe { core::slice::from_raw_parts_mut(header.data, header.len as usize) }
+ } else {
+ &mut []
+ }
+ }
+}
+
+impl Drop for HStringBuilder {
+ fn drop(&mut self) {
+ unsafe {
+ HStringHeader::free(self.0);
+ }
+ }
+}