7.3. Enhanced For-Loop (For-Each) for Arrays¶

There is a special kind of loop that can be used with arrays called an enhanced for loop or a for each loop. This loop is much easier to write because it does not involve an index variable or the use of the []. It just sets up a variable that is set to each value in the array successively.

To set up a for-each loop, use for (type variable : arrayname) where the type is the type for elements in the array, and read it as “for each variable value in arrayname”.

for (type item: array)
{
     //statements using item;
}

See the examples below in Java that loop through an int and a String array. Notice the type of the loop variable is the type of the array.

int[] highScores = { 10, 9, 8, 8};
String[] names = {"Jamal", "Emily", "Destiny", "Mateo"};
// for each loop: for each value in highScores
// for (type variable : arrayname)
for (int value : highScores)
{
    // Notice no index or [ ], just the variable value!
    System.out.println( value );
}
// for each loop with a String array to print each name
// the type for variable name is String!
for (String name : names)
{
    System.out.println(name);
}

Use the enhanced for each loop with arrays whenever you can, because it cuts down on errors. You can use it whenever you need to loop through all the elements of an array and don’t need to know their index and don’t need to change their values. It starts with the first item in the array (the one at index 0) and continues through in order to the last item in the array. This type of loop can only be used with arrays and some other collections of items like ArrayLists which we will see in the next unit.

Coding Exercise

Try the following code. Notice the for each loop with an int array and a String array. Add another high score and another name to the arrays and run again.

public class ForEachDemo
{
   public static void main(String[] args)
   {
     int[] highScores = { 10, 9, 8, 8};
     String[] names = {"Jamal", "Emily", "Destiny", "Mateo"};
     // for each loop with an int array
     for (int value : highScores)
     {
         System.out.println( value );
     }
     // for each loop with a String array
     for (String value : names)
     {
         System.out.println(value); // this time it's a name!
     }
   }
 }
 ====
 import static org.junit.Assert.*;
 import org.junit.*;;
 import java.io.*;

public class RunestoneTests extends CodeTestHelper
 {
     public RunestoneTests() {
         super("ForEachDemo");
     }

@Test
     public void test1()
     {
         String output = getMethodOutput("main");
         String expect1 = "10\n9\n8\n8";
         String expect2 = "Jamal\nEmily\nDestiny\nMateo";

boolean passed = output.contains(expect1) && output.contains(expect2);

passed = getResults(expect1 + " " + expect2, output, "Original main()", passed);
         assertTrue(passed);
     }

@Test
     public void test2()
     {
         String output = getMethodOutput("main");
         String expect = "10 9 8 8 Jamal Emily Destiny Mateo".replaceAll(" ", "\n");

boolean passed = !output.equals(expect) && output.length() > expect.length();

passed = getResults(expect, output, "Added another high score and name", passed);
         assertTrue(passed);
     }
 }

Coding Exercise

Rewrite the following for loop which prints out the even numbers in the array as an enhanced for-each loop. Make sure it works!

7.3.1. Foreach Loop Limitations¶

What if we had a loop that incremented all the elements in the array. Would that work with an enhanced for-each loop? Unfortunately not! Because only the variable in the loop changes, not the real array values. We would need an indexed loop to modify array elements. Try it in the Active Code below or in the Java visualizer by clicking the CodeLens button and step through the code to see why it doesn’t work.

Coding Exercise

The for-each loop below cannot change the values in the array because only the loop variable value will change. Run it with the CodeLens button to see why this is. Then, change the loop to an indexed for loop to make it change the array values.

public class IncrementLoop
{
   public static void main(String[] args)
   {
     int[ ] values = {6, 2, 1, 7, 12, 5};
     // Can this loop increment the values?
     for (int val : values)
     {
       val++;
       System.out.println("New val: " + val);
     }
     // Print out array to see if they really changed
     System.out.println("Array after the loop: ");
     for (int v : values)
     {
       System.out.print(v + " ");
     }
   }
}
====
// Test for Lesson 6.3.3 - IncrementLoop

import static org.junit.Assert.*;
 import org.junit.*;;
 import java.io.*;

public class RunestoneTests extends CodeTestHelper
 {
     public RunestoneTests() {
         super("IncrementLoop");
     }

@Test
     public void test1()
     {
         String output = getMethodOutput("main");
         String expect = "New val: 7\nNew val: 3\nNew val: 2\nNew val: 8\nNew val: 13\nNew val: 6\nArray after the loop:\n7 3 2 8 13 6";

boolean passed = getResults(expect, output, "main()");
         assertTrue(passed);
     }

@Test
     public void test2()
     {
         String target = "for (int * = #; * ? *.length; *~)";
         boolean passed = checkCodeContains("for loop", target);
         assertTrue(passed);

}
 }

Note

Enhanced for each loops cannot be used in all situations. Only use for-each loops when you want to loop through all the values in an array without changing their values.

Do not use for each loops if you need the index.
Do not use for each loops if you need to change the values in the array.
Do not use for each loops if you want to loop through only part of an array or in a different order.

Check Your Understanding

7-3-4: What are some of the reasons you would use an enhanced for-each loop instead of a for loop?

I: If you wish to access every element of an array.
II: If you wish to modify elements of the array.
III: If you wish to refer to elements through a variable name instead of an array index.

Only I.
This style of loop does access every element of the array, but using a for-each loop also means the user can access elements through the variable name.
I and III only.
Correct! For-each loops access all elements and enable users to use a variable name to refer to array elements, but do not allow users to modify elements directly.
II and III only.
For-each loops, as well as allowing users to refer to array elements, run through every element. For-each loops also do not allow users to modify elements directly.
All of the Above.
For-each loops access all of an array's elements and allow users to refer to elements through a variable, but do not allow users to modify elements directly.

7-3-5: What is the output of the following code segment?

int[ ] numbers = {44, 33, 22, 11};
for (int num : numbers)
{
    num *= 2;
}
for (int num : numbers)
{
    System.out.print(num + " ");
}

44 33 22 11
The array is unchanged because the foreach loop cannot modify the array elements.
46 35 24 13
Remember that the foreach loop cannot modify the array elements, but it also uses multiplication, not addition.
88 66 44 22
Remember that the foreach loop cannot modify the array elements. Only the variable num will be doubled, not the original array values.
The code will not compile.
This code will compile.

7.3.2. Foreach Loop Algorithms¶

Here is an object-oriented example that has the array as a private instance variable in the class and provides a public method average that uses a for-each loop. You can use the Java visualizer or the Code Lens button to step through this code.

Try the code below.

Check Your Understanding

The following method has the correct code to return the largest value in an integer array called vals (an instance variable of the current object), but the code is mixed up. Drag the blocks from the left into the correct order on the right and indent them correctly as well. You will be told if any of the blocks are in the wrong order or not indented correctly.</p>

        public int getLargest()
{
---
  int largest = vals[0];
---
  for (int item : vals)
  {
---
    if (item > largest)
    {
---
      largest = item;
---
    }  // end if
---
  } // end for
  return largest;
---
} // end method

If you want to step through the correct code to see what it does in the Java Visualizer click on the following Java visualizer link.

Check Your Understanding

7-3-8: Given that array is an array of integers and target is an integer value, which of the following best describes the conditions under which the following code segment will return true?

boolean temp = false;
for (int val : array)
{
  temp = ( target == val );
}
return temp;

Whenever the first element in array is equal to target.
This would be true if the loop started at the end of the array and moved toward the beginning. But, it will loop from the first element to the last.
Whenever array contains any element which equals target.
This would be true if temp was only set to the result of checking if the current element in the array is equal to target when it is false. But, it is reset each time through the loop.
Whenever the last element in array is equal to target.
The variable temp is assigned to the result of checking if the current element in the array is equal to target. The last time through the loop it will check if the last element is equal to val.
Whenever only 1 element in array is equal to target.
There is no count of the number of times the array element is equal to target.

7.3.3. Programming Challenge : SpellChecker 2¶

Copy the spellcheck method that you used in the Spell Checker Challenge in the last lesson. Re-write the method to use an enhanced for-each loop instead of an indexed for-loop. If you did the optional printStartsWith(firstLetters) method, re-write that one too.

Write a spellcheck() method using an enhanced for-each loop that takes a word as a parameter and returns true if it is in the dictionary array. Return false if it is not found.

public class SpellChecker
{
   // Re-write the spellcheck(word, dictionary) (and optionally the printStartsWith(firstLetters, dictionary)) methods to use enhanced for-each loops.

public static void main(String[] args)
   {
     String[] dictionary = {"the","of","and","a","to","in","is","you","that","it","he","was","for","on","are","as","with","his","they","I","at","be","this","have","from","or","one","had","by","word","but","not","what","all","were","we","when","your","can","said","there","use","an","each","which","she","do","how","their","if","will","up","other","about","out","many","then","them","these","so","some","her","would","make","like","him","into","time","has","look","two","more","write","go","see","number","no","way","could","people","my","than","first","water","been","call","who","oil","its","now","find","long","down","day","did","get","come","made","may","cat","dog","cats","dogs"};

/* Uncomment to test your method
     String word = "catz";
     if (checker.spellcheck(word, dictionary) == true)
         System.out.println(word + " is spelled correctly!");
     else
         System.out.println(word + " is misspelled!");
     */

// Optional (not autograded)
    // checker.printStartsWith("a", dictionary);
   }
}
====
// Test for Lesson 6.2.5 - challenge-6-2-spell-checker

import static org.junit.Assert.*;
 import org.junit.*;;
 import java.io.*;

public class RunestoneTests extends CodeTestHelper
 {
     public RunestoneTests() {
         super("SpellChecker");
     }

@Test
     public void testMain()
     {
         String output = getMethodOutput("main");
         String expect = "catz is misspelled!";

boolean passed = output.contains(expect);

passed = getResults(expect, output, "Did you uncomment the main method?", passed);
         assertTrue(passed);
     }

@Test
     public void test3()
     {
         Object[] args = {"dogz"};
         String output = getMethodOutput("spellcheck", args);
         String expect = "false";

boolean passed = getResults(expect, output, "spellcheck(\"dogz\")");
         assertTrue(passed);
     }

@Test
     public void test4()
     {
         Object[] args = {"dog"};
         String output = getMethodOutput("spellcheck", args);
         String expect = "true";

boolean passed = getResults(expect, output, "spellcheck(\"dog\")");
         assertTrue(passed);
     }

@Test
     public void testFor() throws IOException
     {
         String target = "for (int * = #; * ? #; *~)";
         boolean passed = checkCodeNotContains("for loop", target);
         assertTrue(passed);
     }

@Test
     public void testForEach()
     {
         boolean passed = checkCodeContains("for each loop", "for(String * : dictionary)");
         assertTrue(passed);
     }
 }

7.3.4. Summary¶

An enhanced for loop, also called a for each loop, can be used to loop through an array without using an index variable.
An enhanced for loop header includes a variable, referred to as the enhanced for loop variable, that holds each value in the array.
For each iteration of the enhanced for loop, the enhanced for loop variable is assigned a copy of an element without using its index.
Assigning a new value to the enhanced for loop variable does not change the value stored in the array.
Program code written using an enhanced for loop to traverse and access elements in an array can be rewritten using an indexed for loop or a while loop.

You have attempted of activities on this page

Before you keep reading...

Before you keep reading...

7.3. Enhanced For-Loop (For-Each) for Arrays¶

7.3.1. Foreach Loop Limitations¶

7.3.2. Foreach Loop Algorithms¶

7.3.3. Programming Challenge : SpellChecker 2¶

7.3.4. Summary¶