A little Zig

Author: rtoal

zig/README.md

@@ -1,43 +1,45 @@
 <img src="https://raw.githubusercontent.com/rtoal/ple/main/docs/resources/zig-logo-64.png">
 
-# Zig
+# Zig Explorations
 
-## Zig Examples:
+To build and run Zig programs on your local machine, download and install Zig from the [Zig Download](https://ziglang.org/download/) or use your favorite package manager, e.g. `brew install zig` on macOS.
 
-To get Zig:
-<details><summary><b>MacOS</b></summary>
-  
-<br />In your terminal (Mac Terminal): <br />
+Once installed, programs in this folder can be run from the command line like so:
 
-After installing homebrew:
+```
+zig run triple.zig
+```
 
-  ```sh
-    $ brew install zig
-  ```  
- </details>
-<details><summary><b>Windows/Linux</b></summary>
-  
-Download zig from the website:
-- [Zig Download](https://ziglang.org/download/)
+```
+zig run permutations.zig -- I like carrots
+```
 
-</details>
+```
+zig run top_ten_scorers.zig < ../test/wnba_input
+```
 
-## About Zig:
+## About Zig
 
-The Zig language was founded by Andrew Kelley in 2016. It was created to replace the <a href="https://github.com/rtoal/ple/tree/main/c">C</a> programming language and be more pragmatic. Zig offers many advancements such as features to improve safety, simple syntax, and a testing framework built into the language. The language also provides strong compile-time guarantees and aims to eliminate common programming errors. While it is a newer language, many developers approve of its capabilities. 
+The Zig language was created by Andrew Kelley in 2016, as a pragmatic alternative to the venerable <a href="https://github.com/rtoal/ple/tree/main/c">C</a> programming language. Zig offers many safety features and a comprehensive ecosystem for building and testing. It is known for having “no surprises”: there are no hidden function calls and no hidden memory allocations.
 
-## Zig Resources:
+## Zig Resources
 
 Continue your exploration of Zig via:
 
 - [Zig Home Page](https://ziglang.org)
-- [Zig Docs](https://ziglang.org/documentation/0.10.1/)
+- [Zig Docs](https://ziglang.org/documentation/master/)
 - [Intro to Zig](https://www.youtube.com/watch?v=YXrb-DqsBNU)
-- [ZigLearn](https://ziglearn.org/chapter-1/)
-- [Zig Wiki](https://en.wikipedia.org/wiki/Zig_(programming_language))
+- [ZigLearn](https://ziglearn.org/learn/)
+- [Wikipedia](<https://en.wikipedia.org/wiki/Zig_(programming_language)>)
 
 ## Zig Open Source Projects
 
-Studying, and contributing to, open source projects is an excellent way to improve your proficiency in any language. You may enjoy:
+Studying, and contributing to, open source projects is an excellent way to improve your proficiency in any language. Of the many projects using Lua, you may enjoy:
 
-- [Zig Open Source](https://github.com/kennethreitz/requests)
+- [Trending Lua Repositories on GitHub](https://github.com/trending/zig)
+- [tigerbeetle](https://github.com/tigerbeetle/tigerbeetle)
+- [asciigen](https://github.com/seatedro/asciigen)
+
+You can contribute to Zig itself:
+
+- [Zig](https://github.com/ziglang/zig)

zig/permuations.zig

@@ -9,16 +9,16 @@ fn printPermutations(a: []u8, n: usize) void {
             printPermutations(a, n - 1);
             const j = if (n % 2 == 0) 0 else i;
 
-            const temp = a[j];
+            const old_a_j = a[j];
             a[j] = a[n];
-            a[n] = temp;
+            a[n] = old_a_j;
         }
         printPermutations(a, n - 1);
     }
 }
 
 pub fn main() anyerror!void {
-    var args = try std.process.argsAlloc(std.heap.page_allocator);
+    const args = try std.process.argsAlloc(std.heap.page_allocator);
     defer std.process.argsFree(std.heap.page_allocator, args);
 
     // Skip the first argument which is the program's own path