From f6549a956d640c1de2dc99340582950f9dc18c60 Mon Sep 17 00:00:00 2001
From: Andrew Kelley <andrew@ziglang.org>
Date: Tue, 21 Nov 2023 18:30:42 -0700
Subject: [PATCH] std.ArrayList: add initBuffer to the unmanaged array list

This is useful when you want to have an array list backed by a fixed
slice of memory and no Allocator will be used.

It's an alternative to BoundedArray as you will see in the following
commit.
---
 lib/std/array_list.zig | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/lib/std/array_list.zig b/lib/std/array_list.zig
index 24655046a9..570c65ae99 100644
--- a/lib/std/array_list.zig
+++ b/lib/std/array_list.zig
@@ -633,6 +633,17 @@ pub fn ArrayListAlignedUnmanaged(comptime T: type, comptime alignment: ?u29) typ
             return self;
         }
 
+        /// Initialize with externally-managed memory. The buffer determines the
+        /// capacity, and the length is set to zero.
+        /// When initialized this way, all methods that accept an Allocator
+        /// argument are illegal to call.
+        pub fn initBuffer(buffer: Slice) Self {
+            return .{
+                .items = buffer[0..0],
+                .capacity = buffer.len,
+            };
+        }
+
         /// Release all allocated memory.
         pub fn deinit(self: *Self, allocator: Allocator) void {
             allocator.free(self.allocatedSlice());