Conditionals

Conditionals are used when you want to execute a block of code only if a certain condition is met.

1. if statement

The if statement is used to execute a block of code only if a certain condition is met.

Syntax of an if statement

if (condition)
{
    // code to execute if condition is true
}

1.1. Example

Example of an if statement

void main(void)
{
    // Set the seed of the random number generator.
    aiRandSetSeed(-1);

    // Generate a random number between 0 and 9
    int randomNumber = aiRandInt(10);

    // Say hello only if the random number is less than 7
    if (randomNumber < 7)
    {
        aiEcho("Hello!");
    }
}

You can keep restarting the scenario to see the different outcomes.

If the AI Debug Output does not print anything, it means that the random number was greater than or equal to 7. Otherwise you should see the following output:

00:00:00 (0): P#1 (Player 1) Hello!

2. if-else statement

The if-else statement is used to execute a block of code if a condition is met, and another block of code if the condition is not met.

Syntax of an if-else statement

if (condition)
{
    // code to execute if condition is true
}
else
{
    // code to execute if condition is false
}

2.1. Example

Example of an if-else statement

void main(void)
{
    // Set the seed of the random number generator.
    aiRandSetSeed(-1);

    // Generate a random number between 0 and 9
    int randomNumber = aiRandInt(10);

    if (randomNumber < 5)
    {
        aiEcho("The random number is less than 5 (it is " + randomNumber + ")");
    }
    else
    {
        aiEcho("The random number is greater than or equal to 5 (it is " + randomNumber + ")");
    }
}

3. if-else if-else statement

It is possible to chain multiple if-else statements together to execute different blocks of code depending on the value of a variable.

Syntax of an if-else if-else statement

if (condition1)
{
    // code to execute if condition1 is true
}
else if (condition2)
{
    // code to execute if condition1 is false and condition2 is true
}
// (you can add as many "else if" statements as you want)
else
{
    // code to execute if all conditions are false
}