DRY Out with Loops

If learning to code with foo, bar, and math examples are your kryptonite, keep reading. This series uses relatable examples.

Jump To:

• For Loops
  • Real-life For Loops
• While Loops
  • Real-life While Loops
• Practice Challenges

A loop is a set of instructions that gets continually repeated a certain amount of times or until a condition is met. A condition could be waiting for something to be true or false. A condition could also refer to waiting on the loop to run enough times. Lets go through a pseudocode example of doing introductions in a new group of people. After that, well talk about different types of loops.

# repeat these steps for every person in the group# say hi# give your name and pronouns# say what you like to do when youre bored# mention something you could talk about for hours

For Loops

Sometimes we do know exactly how many times we want to repeat our steps or run a loop. When this is the case, we should use a for loop. This doesnt mean you need to know the exact number of times to repeat the code. I know that sounds contradictory, but I promise its not. Knowing the exact number of times to repeat the code can mean that you used some code to explain how many times. We often use len() and range() to get the exact number of repetitions. Well go over how range() works then jump into some examples.

From the Python documentation, range() gives a sequence of numbers and is commonly used for looping a specific number of times in for loops.

• range(startNum=0, stopNum, step=1)
  • startNum is the beginning of your range. Its not required. The default is 0.
  • stopNum is the end of your range.
  • Give only the stopNum and you will get that many numbers, though it will not include the stopNum. This is because computers start counting at 0 and not 1.
  • Give startNum and stopNum and youll get numbers from startNum to stopNum, but not including stopNum.
  • step is like counting by 2s (2, 4, 6, 8). If you give it 5 it will give you every 5th number.

Syntax

# get numbers up to, but not including 100for i in range(0, 100, 20):    print(i)

Did you notice how there is space in front of all the lines underneath the for line? These are just like the if blocks. The tab before the line is how Python knows this line is a step that belongs to the loop. The next line(s) that are not tabbed in are not part of a loop and therefore will not be repeated. They will run after the loop is done because computers read code top to bottom.

I would read this example as: for each number from (or in the range of) 0 up to but not including 100 while skipping 20, print the number. The example code would run 5 times. Do you know why? range() is giving us our exact number of times to run the loop. The range starts at 0, ends at but doesnt include 100, and counts by or steps over 20. In this case, we get 0, 20, 40, 60, and 80.

What is i?

Youll find outside of giving the syntax above, I will never use i. I find it easier to understand my code when I use a descriptive name. A name is great, but we still need to know what the elusive i is. In a for loop, i is a variable that only gets used within the loop.

This variable is called an iterator variable. It is created in the for line, then it can be used in the block of loop code. With each repetition/iteration of the loop, any uses of the variable in the loop block will change. If the first repetition, the iterator variable was 0, then in the second repetition the iterator variable was 1, and so on.

To make things easier to understand, we could just have easily used num or digit instead of i. Read the syntax to yourself, substituting one of these for the i. Does it make a bit more sense now? Diving into some real-life examples should help explain this better.

Do know that if youre working with books, tutorials, videos, or even other programmers, they may choose to use i. Know that when youre reading it, you can substitute what makes sense to you.

What can we do with for loops?

Again, for loops should be used when we want to repeat code and we know how many times to repeat it.

Real-life examples

Have you ever washed dishes before? I have and I really dont enjoy it. Lets try setting up some code for a dishwashing robot.

# assume we have a list or sink full of 37 dirty dishes called dirty_dishes_list# for every dish on the counter, wash itfor dish in dirty_dishes_list:    add_soap()    scrub_dish()    rinse_dish()    dry_dish()    print(dish + "has been cleaned")

This DishBot 3000 code wont work because none of these functions have been made. Instead, they are placeholders in an example. If you want to see it work, you could swap each line for a line like: print("DishBot 3000 has added soap"). We are also missing a dirty_dishes_list. Once you learn about lists, come back to this example, make a dirty_dishes_list, and try out the code.

Since DishBot 3000 is done washing dishes, I think its time to make some more dirty dishes while making dinner. Shall we read our recipe and write up some pseudocode?

# recipe pseudocode# put all ingredients in a bowl# mix for two minutes# heat stove and dump mixed ingredients in pot on stove# mix for five minutes

With our pseudocode recipe done, we can figure out what our code should be. How many of those steps include some sort of repetition? For each step with repetition, we will need another separate loop.

# recipe loops# put all ingredients in a bowlfor ingredient in ingredients_list:    print(ingredient, "measured")    print(ingredient, "added to bowl")# mix for two minutesbowl_mix_minutes = 2for minute in range(bowl_mix_minutes):    print("mixed ingredients for 1 minute")# heat stove and dump mixed ingredients in pot on stoveprint("Stove is turned on")print("Mixture has been added to the pot")# mix for two more minutesstove_mix_minutes = 5for minute in range(stove_mix_minutes):    print("mixed ingredients over heat for 1 minute")

These loop examples wont work as expected because we are using lists, but havent made any lists. Well talk about lists soon and you can come back to see how these work out.

Do you recall why the stove heating print statements are not part of any of these loops? If not, hop back to the for loop syntax for a refresher.

Code Behind the .upper() method

Earlier, we talked about the .upper() method. This method takes a string and makes all of the characters uppercase. You now know enough things to write the magic behind .upper(). Lets pseudocode it first.

# pseudocoding .upper()# save a string into a variable# for every character in the string# if the character is lowercase# make the character uppercase and print# if the character is a space, print the space# if none of that (meaning the character is already uppercase), print the character

Now that you have this written out in pseudocode, use the steps to guide you in writing some code. Dont forget, you can turn your pseudocode into comments to explain each line. Another hint, programmers tend to use char because its short for character.

If you dont recall the ASCII codes for all of the letters, thats cool, I dont either. Flip back to String Built-in Functions or lookup ASCII letter chart.

Did you notice our pseudocode used the words for and if? We can mix and match our spoken language with the programming language. This helps us start to form an idea of what we should be coding.

I bet youll recall that we use tabs and code blocks in both for loops and if blocks. If you use them together, youll use combine the tabs to show Python you intend for one to be a part of another. For example, if you have an if block as part of your for loop, the if line will have one tab to show it is part of the for loop. Then, the lines that are part of the if block have two tabs to show it is part of the if block that is inside a for loop.

# coding .upper()words = "I smelled a goat at the store because I'm a snowman!"for char in words:  # for every character in the string    if ord(char) >= 97 and ord(char) <= 122:  # if the character is lowercase        new_char_code = ord(char) - 32  # get the uppercase character code        new_char = chr(new_char_code)  # use new_char_code to get uppercase letter        print(new_char, end="")  # print new_char with no space at end    elif char == " ":  # if char is a space        print(" ", end='')    else:  # if none of the above (probably: char already uppercase or not a letter)        print(char, end='')

By the way, you can combine functions together. Taking existing code and modifying it to be easier to read and more efficient is called refactoring. With the above example, we could refactor a few lines.

# original linesnew_char_code = ord(char) - 32  # get the uppercase character codenew_char = chr(new_char_code)  # use new_char_code to get uppercase letter# possible replacementnew_char = chr(ord(char) - 32)  # get uppercase character code then get letter

Why for loops and when to use them?

Without loops, we would have to write a lot more code. That would be a hassle for you, the programmer, and your computer would have bigger files to hold on to. Remember, we use for loops when we can discern exactly how many times we need to repeat the code.

While Loops

Sometimes we really dont know how many times we want to repeat our steps. When this is the case, we should use a while loop. This means no programmer knows the exact number of times to repeat the code.

Have you ever hit "repeat" on a song? That is a while loop. It's going to repeat until you tell it to stop or until there is no power left for the device. If we were coding, we could say "while there is power, play the song on repeat".

Syntax

counter = 0while something_true:    print(counter)    counter = counter + 1

There are several steps to a while loop. If you skip one of them, your while loop is likely to mess up. Remember, the computer will do what you tell it to, not what you want it to do.

1. Create the counter - a variable to help know when the loop should end
2. Give a condition - comparison or logical operator, similar to an if statement
3. Increment or Decrement the counter - add/subtract every time the loop runs

Avoid Infinite Loops

An infinite loop means code repeats forever until your computer senses it and stops the code. This will often look like your computer or a single program is crashing and not responding. If this is the case, you may need to close the tab or program. Then, go back to your code and make sure you have incremented the counter.

What can we do with while loops?

Again, while loops should be used when we want to repeat code and we dont know how many times to repeat it. Instead, we give a comparison(s) or logical operator(s) to make a condition.

Real-life examples

Have you ever pet a cat before? Most cats are a perfect example of a while loop. Before we start, lets ask the cat how many times theyd like to be pet. We arent going to tell the human doing the petting. Were just going to use the cats answer to define our condition. To ask the cat for this, we will use input(). Sadly, we need a number, and input() gives us strings. So, we have to force the it into a number using int(). This forcing from string to integer is called casting a string to an integer. All together, we can save the cats response into a variable using the first line in this example.

# first ask the cat how many times theyd like to be pet, but dont tell the humanpreferred_pets_num = int(input("How many times would you like to be pet"))pet_attempts = 0  # start with 0while preferred_pets_num > pet_attempts:    print("You have consent to pet again")    print("purrrr, that pet was accepted")    pet_attempts = pet_attempts + 1  # add 1 every time you petprint("That was 1 too many times. I'm leaving now")

The three tabbed in lines run once for each repetition of the loop. The loop ends when we have gone over the accepted amount of pets. Now that the loop is over, we can print that the cat has decided to leave.

Now that the cat is upset and has left us, lets check the weather and see if our dog is ready to play. In this example, well combine a bunch of the things weve covered like if-then statements, logical operators, casting strings, and a while loop. Its longer than some of the other examples. Well look at the different parts to make it make sense.

dog_wants_to_play = True  # dog always wants to playsunny_outside = bool(input("Sunny? True/False"))rainy_outside = bool(input("Raining? True/False"))warm_outside = bool(input("Warm outside? True/False"))cold_outside = bool(input("Cold outside? True/False"))dog_energy = 100  # starting with 100%outside_spent_energy = 3  # % energy spent fetching one timeinside_spent_energy = 2  # % energy spent fetching one timewhile dog_energy > 50:  # gotta leave pup some energy    if sunny_outside and warm_outside:    go_outside()  # sets outside to True    if outside:        throw_ball()        print("Go get it!")        print("Drop it")        dog_energy = dog_energy - outside_spent_energy    elif rainy_outside or cold_outside:        throw_ball()  # throw carefully, you're inside        print("Go get it!")        dog_energy = dog_energy - inside_spent_energy

• At the top, first chunk of lines, we have some inputs that will later help us decide when and where to play. I would read the second line as: getting user input string of True or False, cast or force into a boolean, then saved into variable sunny_outside.
• After the inputs, we have three lines that set up our dogs energy. Id read these as dog starts with 100% energy, 3% energy is spent outside, and 2% energy is spent inside. Now we can get into our while loop. Our first line of the loop could read as while the dog has more than 50% energy, then we do the stuff below.
• Looks like weve run into an if-elif statement. Depending on the inputs, youll only do one or the other. There are two options: If its sunny and warm, then do the code in this block or If its rainy or cold, then do the code in this block.
• At the end of each of the if and elif blocks, we made sure to account for spent energy and subtract from dogs energy. You could read that line as current dogs energy is now = the old dogs energy minus energy spent. Without this line, wed have an infinite loop and our poor dog would be so tired they may get hurt.

Do know, this code wont work as is because none of these functions have been made. Instead, they are placeholders in an example. If you want to see it work, you could swap each fake function (go_outside() and throw_ball()) for a line like: print("We are outside now."). You would also have to change if outside: to if True:.

We talked about infinite loops earlier, but theyre generally a computer or human problem. There are infinite loops in real life. Do you know about the water cycle? The basic concept doesnt have a good starting point because it is always happening. So, lets start with rain, snow, and any other precipitation. Water, in some form, falls from the sky. Then, this water collects somewhere (eg bucket, ocean, lake etc). Once the water collects, it can evaporate. As it evaporates, clouds form and the cycle continues until the end of Earth.

If you run try writing this code, expect it to crash. If you dont remember why thats fine. You can jump back to the section on infinite loops.

earth_exists = True# while the earth_exists# water falls back to earth - precipitate# water collects# water evaporates# clouds form - condensation

Behind the Scenes: Winning and Losing

Using while loops and if-else statements we can build scoring for your favorite game. No matter the complexity of the scoring, you can write it with while loops and if-else statements. First, well use a coin-flipping game.

Our first step wont be in a while loop. Well add the loop when we adjust the game to have 3 rounds and whoever gets two out of 3 will win. Coins have two sides. Well call one side heads and the other tails. Player one, the computer, flips the coin while player two, you, say which side they think will land facing up. If player twos choice has landed facing up, they win.

your_choice = input("Heads or Tails?").lower()coin_landed = "heads"if coin_landed == your_choice:    print("You win")else:    print("You lost")

For now, we have hard coded which side of the coin landed facing up. Hard coding means that we did not use any programming magic to come up with this. Instead, we told it the answer. Later when we talk about Python lists, we will add a couple of things to make the computers coin flipping random.

For now, we know who won this game but we should make this fair and try for the best two out of three rounds.

rounds_won = 0  # start with 0rounds_lost = 0  # start with 0total_rounds = 0  # start with 0while total_rounds < 3:    your_choice = input("Heads or Tails?").lower()    coin_landed = "heads"  # you can change this    if coin_landed == your_choice:        print("You win this round")        rounds_won = rounds_won + 1    else:        print("You lost this round")        rounds_lost = rounds_lost + 1total_rounds = total_rounds + 1# calculate who wonif total_rounds == 3 and rounds_won >= 2:    print("You win! You got best 2 out of 3")else:    print("You lose! Computer got best 2 out of 3")

• At the top, the first chunk of lines, we added in some counters to help run the code.
• After the counters, we added a while loop and tabbed in the if-else statements and their blocks.
• With the input().lower() we are acknowledging that a player may input something with different capitalization and we are making sure it will match out coin_landed exactly.
• Looks like weve run into an if-else statement. Depending on the outcome of the round, youll only do one or the other. There are two options: the coin side facing up is the same as your choice, then do the code in this block or the coin side facing up is not the same as your choice, then do the code in this block.
• At the end of each of the if and else blocks, we made sure to account for the results of the round. Depending on the block, you could read that line as current rounds won = the old rounds won plus one or current rounds lost = the old rounds lost plus one.
• After the else block, but still part of the while loop, we add one to our total rounds. Without this line, wed have an infinite loop and our game would never end.
• At the very end, after the loop ends, we use another if-else statement to decide who won the whole game.

Did you notice how we coded the important guts of the game first, then we added the extra features? This is a typical approach to coding. First, we build a functional project. Once it works, we can add features to it. This helps us keep from getting overwhelmed and allows us to see working parts sooner.

Why while loops and when to use them?

Remember, we use while loops when we cannot know exactly how many times we need to repeat the code.

Do you remember?

Here's some practice challenges. Lets practice what weve learned so far. Go ahead and comment on this post with your answers. Do you remember? If not, you can always go back to read sections again.

Give a real-life example of a for loop and a while loop

You can use print statements or fake functions (like jump() or turn_wheel()) to fill in the if-elif-else then blocks

# coding a for loop

# coding a while loop

Whats Wrong with These? Can You Fix them?

There may be multiple ways to fix these. Have fun and do it whatever way you think makes sense.

# pets are a mix of birds, fish, cats, dogs, and reptiles    for pet in the range of 1 to 10feed_pet()brush_pet()give_water()    take_outside()play()

            while dog_awake:        if dog_energy is more than 50;    dog_awake = True    dog_energy = 100    chase_cat()    chew_toy()    beg_for_pets()    dog_energy = dog_energy - 5        else:  # dog_energy low    nap_time()  # changes dog_awake to False    print("Its doggy nap time!")

Go Ahead! You can build it! .lower()

# coding .lower()

and maybe even .title()

# coding .title()

You got this! Build Scoring for a game

You can use print statements or fake functions (like throw() or move_left()) to fill in the if-elif-else then blocks.

# scoring for any game

Thank you to @yechielk for reviewing. If you like learning about how ethics and programming go together, check out their book and newsletter.