From c735d4b45f2db336e2aff8d94da7a08bb1fad68f Mon Sep 17 00:00:00 2001
From: Zuhaitz Méndez Fernández de Aránguiz <zuhaitz@debian>
Date: Fri, 23 Jan 2026 15:55:02 +0000
Subject: Update for tuples.

---
 README.md | 27 ++++++++++++++++++++++++---
 1 file changed, 24 insertions(+), 3 deletions(-)

(limited to 'README.md')

diff --git a/README.md b/README.md
index 2995ad4..e91e63c 100644
--- a/README.md
+++ b/README.md
@@ -172,11 +172,32 @@ var zeros: [int; 5]; // Zero-initialized
 ```
 
 #### Tuples
-Group multiple values together.
+Group multiple values together, access elements by index.
 ```zc
 var pair = (1, "Hello");
-var x = pair.0;
-var s = pair.1;
+var x = pair.0;  // 1
+var s = pair.1;  // "Hello"
+```
+
+**Multiple Return Values**
+
+Functions can return tuples to provide multiple results:
+```zc
+fn add_and_subtract(a: int, b: int) -> (int, int) {
+    return (a + b, a - b);
+}
+
+var result = add_and_subtract(3, 2);
+var sum = result.0;   // 5
+var diff = result.1;  // 1
+```
+
+**Destructuring**
+
+Tuples can be destructured directly into variables:
+```zc
+var (sum, diff) = add_and_subtract(3, 2);
+// sum = 5, diff = 1
 ```
 
 #### Structs
-- 
cgit v1.2.3