Zig 0.17.0-dev (Split by item) This is an example of documentation generated by
ZigDoc , an alternative to Zig's built-in
Auto Doc feature. See also
examples in other modes/formats . The project being documented here (as the example) is the Zig standard library.
std › Io › Writer › Allocating › toOwnedSlice Public Function toOwnedSlice Doc Source Public Function std.Io.Writer.Allocating.toOwnedSlice
pub fn toOwnedSlice (a : *Allocating ) Allocator .Error ![]u8 Params File Io/Writer.zig: 2788
2788
2789
2790
2791
2792
2793
2794
2795
2796
2797
2798
2799
2800
2801
2802
2803
2804
2805
2806
2807
2808
2809
2810
2811
2812
2813
2814
2815
2816 pub fn toOwnedSlice (a : *Allocating ) Allocator .Error ![]u8 {
const old_memory = a .writer .buffer ;
const alignment = a .alignment ;
const buffered_len = a .writer .end ;
if (old_memory .len > 0 ) {
if (buffered_len == 0 ) {
a .allocator .rawFree (old_memory , alignment , @returnAddress ());
a .writer .buffer = &.{};
a .writer .end = 0 ;
return old_memory [0 ..0 ];
} else if (a .allocator .rawRemap (old_memory , alignment , buffered_len , @returnAddress ())) |new | {
a .writer .buffer = &.{};
a .writer .end = 0 ;
return new [0 ..buffered_len ];
}
}
if (buffered_len == 0 )
return a .writer .buffer [0 ..0 ];
const new_memory = (a .allocator .rawAlloc (buffered_len , alignment , @returnAddress ()) orelse
return error .OutOfMemory )[0 ..buffered_len ];
@memcpy (new_memory , old_memory [0 ..buffered_len ]);
if (old_memory .len != 0 ) a .allocator .rawFree (old_memory , alignment , @returnAddress ());
a .writer .buffer = &.{};
a .writer .end = 0 ;
return new_memory ;
}