Tutorials HQ

Let’s dive into the fundamental building blocks of Zig programming. These are the essential elements you need to understand to start writing your own code.

Variables and Constants

Variables are like containers where you can store information. They can hold numbers, words, and other types of data. Imagine them as labeled boxes in which you can keep your toys. Let’s see some examples:

const apples: i32 = 5; // Here, 'apples' is a variable storing the number 5.
var name: string = "Alice"; // 'name' is a variable storing the name "Alice".
var isRaining: bool = true; // 'isRaining' is a variable storing the value 'true'.

Think about a variable as a box. What kind of information would you put in the box, and what would you label it?

Constants are similar to variables, but their value doesn’t change once it’s set. It’s like having a box that’s permanently labeled with a specific toy inside. We’ll see how constants can be useful for storing information that should never change.

const pi: f64 = 3.14; // 'pi' is a constant storing the value of pi (approximately 3.14).
const greeting: string = "Hello!"; // 'greeting' is a constant with a fixed greeting message.

If you had a magic box that could only hold one thing forever, what would you put inside?

Comments and Documentation

Comments are notes you write in your code to explain what’s happening. They won’t affect how the program runs; they’re just there to help you and others understand the code. Think of them as little reminders or explanations you leave for yourself.

In another words Comments are like little notes we leave for ourselves and others in our code. They don’t affect how the program runs, but they’re incredibly helpful for understanding what’s happening.

// This is a single-line comment. It's like a sticky note for the programmer.
const numberOfApples: i32 = 10; // This comment tells us what 'numberOfApples' represents.

Multi-line comments let us write longer explanations or even temporarily hide sections of code.

/*
   This is a multi-line comment.
   It can span multiple lines.
   It's great for detailed explanations.
*/

Imagine you’re writing a treasure map for someone to follow. What kind of instructions would you give, and how would you make sure they understand every step?

Documentation is like a user manual for your code. It’s a way to explain how your code works, what it does, and how others can use it. We’ll learn how to write clear comments and helpful documentation to make our code more understandable.

In another words Documentation is like a guidebook for our code. It explains what our code does, how to use it, and any important details. This is super helpful for other programmers (and future-you) who might use our code.

//! This is a documentation comment. It provides information about the code below.

pub fn greet(name: string) string {
    return "Hello, " ++ name;
}

If you were writing a guidebook for a magical adventure, what important details would you include to help someone succeed in their quest?

Basic Operators

Operators are special symbols or words that allow us to perform actions on our data. For example, we can use + to add numbers or > to check if one number is greater than another. It’s like using math symbols to solve puzzles. We’ll explore different operators and how they work in Zig.

In another words operators are the tools we use to do things like math, comparisons, and more.

Arithmetic Operators let us do math in our code. For example:

const sum: i32 = 5 + 3; // 'sum' will be 8.
const difference: i32 = 10 - 7; // 'difference' will be 3.
const product: i32 = 4 * 2; // 'product' will be 8.
const quotient: f64 = 10.0 / 3.0; // 'quotient' will be approximately 3.33.

Imagine you have a magical calculator. What kind of calculations would you like to perform with it?

Comparison Operators help us compare things in our code. They tell us if something is greater, smaller, or equal to something else.

const isGreaterThan: bool = 10 > 5; // 'isGreaterThan' will be 'true'.
const isSmallerThan: bool = 7 < 3; // 'isSmallerThan' will be 'false'.
const isEqual: bool = 5 == 5; // 'isEqual' will be 'true'.
const isNotEqual: bool = 8 != 8; // 'isNotEqual' will be 'false'.

If you were a detective, how would you use these comparison operators to solve mysteries?

Logical Operators allow us to combine conditions in our code. They help us make decisions based on multiple factors.

const bothTrue: bool = true && true; // 'bothTrue' will be 'true'.
const eitherTrue: bool = true || false; // 'eitherTrue' will be 'true'.
const notTrue: bool = !true; // 'notTrue' will be 'false'.

Imagine you’re in charge of a super-secret mission. How would you use these logical operators to make sure everything goes according to plan?

Conditionals and Loops

Conditionals help our programs make decisions. It’s like telling the computer, “If this is true, do this; otherwise, do something else.” This is really handy for making our programs smart and responsive.

In another words Conditionals are like decision-making tools in our code. They help our programs choose different paths based on certain conditions.

If-Else Statements are one way to use conditionals. They work like this:

const apples: i32 = 5;
if apples > 3 {
    // This code will run because the condition is true.
    std.debug.print("You have many apples!\n", .{});
} else {
    // This code will not run because the condition is false.
    std.debug.print("You have a few apples.\n", .{});
}

Imagine you’re in a magical forest. How would you use if-else statements to decide which path to take?

Loops are like instructions that tell the computer to do something over and over again. They’re perfect for tasks that need to be repeated. Imagine a chef stirring a pot of soup. The chef doesn’t just stir once; they keep stirring until the soup is just right. Loops help us repeat actions in our programs.

In this section, we’ll learn how to use conditionals and loops to control the flow of our programs, making them more dynamic and capable of handling different situations.

For Loops are one type of loop. They look like this:

for (var i: i32 = 0; i < 5; i += 1) {
    std.debug.print("Counting: {},\n", .{i});
}

This loop will count from 0 to 4, printing the numbers.

Imagine you’re a musician. How would you use a loop to play a melody over and over until it’s just right?

While Loops are another type of loop. They keep running as long as a condition is true:

var num: i32 = 1;
while (num < 10) {
    std.debug.print("Number is: {},\n", .{num});
    num += 2;
}

This loop will print odd numbers from 1 to 9.

If you were in charge of a magical factory, how would you use a while loop to keep making toys until you had enough?

Congrats! Now you have enough knowledge on these to fire up a code editor or IDE and start coding.