Eric Coissac
8c7017a99d
- Update obioptions.Version from "Release 4.4.29" to "/v/ Release v5" - Update version.txt from 4.29 → .30 (automated by Makefile)
1.4 KiB
obiutils: Unsafe String–Byte Conversions in Go
This package provides low-level, zero-copy utilities for converting between string and []byte in Go using the unsafe package.
Core Functions
-
UnsafeBytes(str string) []byte
Converts astringto a mutable byte slice without copying, by directly accessing the underlying memory.
⚠️ Unsafe: Modifications to the returned slice may corrupt or alter the original string (undefined behavior).
Use only when performance is critical and immutability can be guaranteed. -
UnsafeString(b []byte) string
Converts a[]byteto an immutablestring, again without copying, by reinterpreting the byte slice’s memory as a string.
⚠️ Unsafe: Ifbis later modified, the resulting string may become invalid (memory safety violation).
Requires thatbremains immutable for the lifetime of the returned string.
Semantic Purpose
These functions enable high-performance interop between strings and byte slices—critical in systems programming, serialization frameworks, or memory-constrained environments where allocation overhead must be avoided.
Risks & Best Practices
- Never mutate the returned slice or original input after conversion.
- Prefer standard conversions (
[]byte(s),string(b)) unless profiling confirms a measurable bottleneck. - Ensure inputs are valid and owned (e.g., not shared across goroutines without synchronization).