feat: std\args()

CHANGELOG.md

@@ -34,6 +34,7 @@ list[?10] == null;
 ```
 - User input is syntax highlighted in REPL (https://github.com/buzz-language/buzz/issues/217)
 - REPL handles multilines input (https://github.com/buzz-language/buzz/issues/218)
+- `std\args()`: returns the command line arguments with which the script was launched
 
 ## Modified
 - Enum can now have `rg`, `ud`, `void`, `pat` has value type

src/buzz_api.zig

@@ -79,6 +79,15 @@ export fn bz_peek(vm: *VM, dist: u32) Value {
     return vm.peek(dist);
 }
 
+/// Absolute access to the stack.
+export fn bz_at(vm: *VM, at: u32) Value {
+    if (at < vm.current_fiber.stack.len) {
+        return vm.current_fiber.stack[at];
+    }
+
+    return Value.Null;
+}
+
 /// Converts a value to a string
 export fn bz_valueToString(value: Value, len: *usize) ?[*]const u8 {
     if (!value.isObj() or value.obj().obj_type != .String) {

src/lib/buzz_api.zig

@@ -202,6 +202,7 @@ pub const VM = opaque {
     pub extern fn bz_push(self: *VM, value: Value) void;
     pub extern fn bz_pop(self: *VM) Value;
     pub extern fn bz_peek(self: *VM, distance: u32) Value;
+    pub extern fn bz_at(vm: *VM, at: u32) Value;
     pub extern fn bz_pushError(self: *VM, qualified_name: [*]const u8, len: usize, message: ?[*]const u8, mlen: usize) void;
     pub extern fn bz_pushErrorEnum(self: *VM, qualified_name: [*]const u8, name_len: usize, case: [*]const u8, case_len: usize) void;
     pub extern fn bz_stringToValue(vm: *VM, string: ?[*]const u8, len: usize) Value;

src/lib/buzz_std.zig

@@ -9,7 +9,12 @@ pub const os = if (is_wasm)
 else
     std.os;
 
-// fun random(int? min = null, int? max = null) > int
+pub export fn args(ctx: *api.NativeCtx) c_int {
+    ctx.vm.bz_push(ctx.vm.bz_at(1));
+
+    return 1;
+}
+
 pub export fn random(ctx: *api.NativeCtx) c_int {
     if (is_wasm) {
         unreachable;

src/lib/std.buzz

@@ -55,4 +55,7 @@ export extern fun currentFiber() > fib<any, any?>;
 /// Print message and exit program
 extern fun buzzPanic(message: str) > void;
 
+/// Returns the command line arguments with which the script was launched
+export extern fun args() > [str];
+
 export buzzPanic as panic;

tests/068-testing.buzz

@@ -1,4 +1,5 @@
 import "testing" as _;
+import "std";
 
 test "Test std lib" {
     const t = Tester.init(