c

crates/polars-io/src/utils/other.rs

@@ -42,8 +42,11 @@ pub fn get_reader_bytes<'a, R: Read + MmapBytesReader + ?Sized>(
     }
 }
 
+/// Decompress `bytes` if compression is detected, otherwise simply return it.
+/// An `out` vec must be given for ownership of the decompressed data.
+///
 /// # Safety
-/// The `out` vec outlives `bytes`.
+/// The `out` vec outlives `bytes` (declare `out` first).
 pub unsafe fn maybe_decompress_bytes<'a>(
     bytes: &'a [u8],
     out: &'a mut Vec<u8>,