test:zig

guide/standard-libaray/02-array-list.zig

@@ -0,0 +1,37 @@
+const std = @import("std");
+const expect = std.testing.expect;
+// The `std.ArrayList` is commonly used throughout Zig, and serves as a buffer that can change in size.
+// `std.ArrayList(T)` is similar to C++'s `std::vector<T>` and Rust's `Vec<T>`.
+// The `deinit()` method frees all of the `std.ArrayList`'s memory.
+// The memory can be read from and written to via its slice field - `.items`.
+// `std.ArrayList` 는 Zig 에서 많이 사용되는 버퍼로, 크기를 변경할 수 있는 버퍼를 제공합니다.
+// `std.ArrayList(T)` 는 C++의 `std::vector<T>` 와 Rust의 `Vec<T>` 와 유사합니다.
+// `deinit()` 메서드는 `std.ArrayList`의 모든 메모리를 해제합니다.
+// 메모리는 `.items` 필드를 통해 읽거나 쓸 수 있습니다.
+
+// Here we will introduce the usage of the testing allocator.
+// This is a special allocator that only works in tests and can detect memory leaks.
+// In your code, use whatever allocator is appropriate.
+// 여기서는 테스트 할당자(testing allocator)의 사용법을 소개합니다.
+// 이 할당자는 테스트에서만 동작하며 메모리 누수를 감지할 수 있는 특별한 할당자입니다.
+// 실제 코드에서는 상황에 맞는 할당자를 사용하면 됩니다.
+const eql = std.mem.eql;
+const ArrayList = std.ArrayList;
+const allocator = std.testing.allocator;
+
+test "arraylist" {
+    var list: ArrayList(u8) = .empty;
+    defer list.deinit(allocator);
+    try list.append(allocator, 'H');
+    try list.append(allocator, 'e');
+    try list.append(allocator, 'l');
+    try list.append(allocator, 'l');
+    try list.append(allocator, 'o');
+    try list.appendSlice(allocator, " World!");
+
+    try expect(eql(u8, list.items, "Hello World!"));
+}
+
+// Coming from C++?
+// Zig's std.ArrayList is very comparable to C++'s std::vector.
+// Zig의 std.ArrayList는 C++의 std::vector와 매우 비슷합니다.