Module cstr 

Available on crate features types-cstr and types only.

定容 C 字符串容器：栈上（StackCStr）与堆上（HeapCStr，需 alloc）实现，内部恒以 \0 结尾，搬运/销毁时清零残留。

与 crate::types::str 不同，本模块允许非 UTF-8 字节，仅校验 NUL 语义， 可直接投喂 sys_open / sys_execve 等取 core::ffi::CStr 的调用。

容量语义

N 包含结尾 \0（N >= 1）：有效载荷至多 N - 1 字节。 len() 返回不含 \0 的载荷长度。

需要启用 "types-cstr" 特性。

Structs

HeapCStralloc

堆上定容安全 C 字符串，语义与 StackCStr 一致，适用于较长的敏感文本。

StackCStr

栈上定容安全 C 字符串，Drop 时自动清零，适用于短路径、argv 等小敏感文本。

Enums

CStrError

安全 C 字符串的错误类型。

Traits

CStr

安全 C 字符串的统一接口：只读视图，内部恒为合法 CStr（以 \0 结尾、无内部 NUL）。