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 › heap › testAllocatorAlignedShrink Public Function testAllocatorAlignedShrink Doc Source Public Function std.heap.testAllocatorAlignedShrink
pub fn testAllocatorAlignedShrink (base_allocator : mem .Allocator ) !void Params base_allocator : mem .Allocator File heap.zig: 535
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565 pub fn testAllocatorAlignedShrink (base_allocator : mem .Allocator ) !void {
var validationAllocator = mem .validationWrap (base_allocator );
const allocator = validationAllocator .allocator ();
var debug_buffer : [1000 ]u8 = undefined ;
var fib = FixedBufferAllocator .init (&debug_buffer );
const debug_allocator = fib .allocator ();
const alloc_size = pageSize () * 2 + 50 ;
var slice = try allocator .alignedAlloc (u8 , .@"16" , alloc_size );
defer allocator .free (slice );
var stuff_to_free = std .array_list .Managed ([]align (16 ) u8 ).init (debug_allocator );
// On Windows, VirtualAlloc returns addresses aligned to a 64K boundary,
// which is 16 pages, hence the 32. This test may require to increase
// the size of the allocations feeding the `allocator` parameter if they
// fail, because of this high over-alignment we want to have.
while (@intFromPtr (slice .ptr ) == mem .alignForward (usize , @intFromPtr (slice .ptr ), pageSize () * 32 )) {
try stuff_to_free .append (slice );
slice = try allocator .alignedAlloc (u8 , .@"16" , alloc_size );
}
while (stuff_to_free .pop ()) |item | {
allocator .free (item );
}
slice [0 ] = 0x12 ;
slice [60 ] = 0x34 ;
slice = try allocator .reallocAdvanced (slice , alloc_size / 2 , 0 );
try testing .expect (slice [0 ] == 0x12 );
try testing .expect (slice [60 ] == 0x34 );
}