What happens if you attempt to access an array index that is outside of the length of an array?

When we declare a variable, we specify its type and then the variable name. To make a variable into an array, we put square brackets after the data type. For example, int[] scores means we have an array called scores that contains int values.

// Declaration for a single int variable int score; // Declaration for an array of ints int[] scores;

The declarations do not create the array. Arrays are objects in Java, so any variable that declares an array holds a reference to an object. If the array hasn’t been created yet and you try to print the value of the variable, it will print null (meaning it doesn’t reference any object yet).

There are two ways to create an array. You can use the keyword new to get new memory or use an initializer list to set up the values in the array.

Watch the following video which shows the two ways of creating an array with a physical model of Java memory.

To create an empty array after declaring the variable, use the new keyword with the type and the size of the array (the number of elements it can hold). This will actually create the array in memory. You can do the declaration and the creation all in one step, see the String array names below. The size of an array is set at the time of creation and cannot be changed after that.

//declare an array variable int[] highScores; // create the array highScores = new int[5]; // declare and create array in 1 step! String[] names = new String[5];

6-1-4: Which of the following creates an array of 10 doubles called prices?

• int[] prices = new int[10];
• We need double for money amounts in prices.
• double[] prices = new double[10];
• Yes correct!
• double[] prices;
• This declares the array but does not create it with new.
• double[10] prices = new double[];
• This is not the correct syntax.

In the following code, add another array declaration that creates an array of 5 doubles called prices and another array of 5 Strings called names and corresponding System.out.println commands.

Note

Array elements are initialized to default values like the following.

• 0 for elements of type int

• 0.0 for elements of type double

• false for elements of type boolean

• null for elements of type String

Figure 3: Two 5 element arrays with their values set to the default values for integer and object arrays.¶

Another way to create an array is to use an initializer list. You can initialize (set) the values in the array to a list of values in curly brackets { } when you create it, like below. In this case you don’t specify the size of the array, it will be determined from the number of values that you specify.

int[ ] highScores = {99,98,98,88,68}; String[ ] names = {"Jamal", "Emily", "Destiny", "Mateo", "Sofia"};

When you create an array of a primitive type (like int) with initial values specified, space is allocated for the specified number of items of that type and the values in the array are set to the specified values. When you create an array of an object type (like String) with initial values, space is set aside for that number of object references. The objects are created and the object references set so that the objects can be found.

Figure 4: A primitive array and an object array¶

Watch the following video which shows an array of String objects with a physical model of Java memory.

Arrays know their length (how many elements they can store). It is a public read-only instance variable so you can use dot-notation to access the instance variable (arrayName.length). Dot-notation is using variable name followed by a . and then the instance variable (property) name or a method name. Try the following.

Try running the code below to see the length. Try adding another value to the highScores initializer list and run again to see the length value change.

Note

Note that length is an instance variable and not a method, unlike the String length() method, so you don’t add parentheses after length. However, if you use parentheses after length during the exam, you won’t lose any points. The length instance variable is declared as a public final int. public means you can access it and final means the value can’t change.

6-1-8: Which index is for the last element of an array called highScores?

• highScores.length
• Remember that the first element in an array starts at index 0. If the length (the number of elements) of the array is 5, at what index would you find the last element?
• highScores.length - 1
• Since the first element in an array is at index 0 the last element is the length minus 1.

To access the items in an array, we use an indexed array variable which is the array name and the index inside of square bracket [ ]. Remember that an index is a number that indicates the position of an item in a list, starting at 0. Here’s a comparison of App Inventor, AP CSP Pseudocode, and Java array access.

Figure 5: Comparing Access to App Inventor lists and Java arrays¶

An indexed variable like arrayname[index] can be used anywhere a regular variable can be used, for example to assign a new value or to get a value from the array like below.

// assign a new value 99 to the first element in the array highScores[0] = 99; // print the first element of the array System.out.println( highScores[0] );

Note

The first value in an array is stored at index 0 and the index of the last value is the length of the array minus one (since the first index is 0). Use arrayname[index] to access or modify array items.

Watch the following video which shows a physical model of Java memory setting array values.

6-1-10: Fill in the blank with code to access the cars array.

String[] cars = {“Honda”, “Volvo”, “BMW”};

// Access cars array to get Volvo

String v = ;

6-1-11: Fill in the blank with code to access the cars array. NOTE: The semicolon is provided for you after the box.

String[] cars = {“Honda”, “Volvo”, “BMW”};

// Set the first item of the cars array to be Toyota

= “Toyota”;

If you want to keep track of the top 5 highest scores in a game and the names of the people with those scores, you could use two parallel arrays. One array could keep track of the scores and the other the names. You have to make sure you keep them in the same order so that the same index can be used to get correponding names and scores.

Try out the following code which has two parallel arrays, highScores and names. Can you print out Mateo’s score? Can you change Sofia’s score to 97 using an assignment statement in the code? Can you change the arrays so that they have 6 elements and add your name and score and print them out?

What happens if you try to access an element that is not there? Try to access a highScore or name at index 7 above to see what happens. The index must be between 0 and the length of the array - 1 or it will give an error message called ArrayIndexOutOfBoundsException.

Note

Using an index value outside of 0 - (length-1) will result in an ArrayIndexOutOfBoundsException being thrown.

One powerful feature in the array data abstraction is that we can use variables for the index! As long as the variable holds an integer, we can use it as an index.

// use a variable for the index int index = 3; System.out.println( highScores[index] );

Here’s a fun String array of image filenames. The following code displays an online image using an HTML tag. (Note that this just works in this Active Code window which interprets HTML. In other Java IDEs you would need to use Java Swing graphics instead). Run the code and see that it displays images[0] which is “cow.jpg”. The images array holds 5 images.

Can you change the index variable’s value so that it prints out the puppy image? Can you print out the reindeer? Try all of them! What indices did you need to use? Then try using a random number for the index instead. Remember that (int)(Math.random()*max) will return a number from 0 up to max. What’s the maximum number it can be for this array?

In this challenge, you will create a guide to different countries using arrays.

1. Use the Active Code window below to create 4 parallel arrays and initialize them using initialization lists that represent the data below. Remember that the order of these arrays has to match so that you can use the same index and get corresponding values out.

• Countries: China, Egypt, France, Germany, India, Japan, Kenya, Mexico, United Kingdom, United States

• Capitals: Beijing, Cairo, Paris, Berlin, New Delhi, Tokyo, Nairobi, Mexico City, London, Washington D.C.

• Languages: Chinese, Arabic, French, German, Hindi, Japanese, Swahili, Spanish, English, English

• Filenames for map images: China.jpg, Egypt.jpg, France.jpg, Germany.jpg, India.jpg, Japan.jpg, Kenya.jpg, Mexico.jpg, UK.jpg, US.jpg

1. You are encouraged to add additional country, capital, and language names that match in position in the parallel arrays to represent your family origins or places you would like to visit. Although we do not have image files for each country in the CSAwesome map images, we do have regional map images called south-america.png, central-america.png, north-america.png, asia-pacific.png, europe.png, africa.png, and middle-east.png which you can use. Note that these are png files and not jpg. If you create more maps for your project, you can have your teacher share it in the teaching-csawesome google group to contribute to this map image collection.

2. Choose a random number using Math.random() and the length of one of the arrays and save it in a variable called index.

3. Print out the country name, its capital, and its language, and the map image for that country using the random index to access the corresponding item in each parallel array. For the images, the printHTMLimage method has been given to get the image URL online and print it out as an HTML image.

4. Optional Extra Challenge: If you have more time for this project, you can combine what you learned in the last unit to refactor your code (which means restructure without changing the functionality) to make it object-oriented. Create a Country class that stores the country name, capital, language, and image file. In the main method, create an array of 10 Country objects with the data for each country passed to its constructor, and use a random number to choose a country object from the array and display its attributes. See the array of turtles in the next section below for help on how to create an array of objects.

public class Countries { public static void main(String[] args) { // 1. Declare 4 arrays and initialize them to the given values. // Countries: China, Egypt, France, Germany, India, Japan, Kenya, Mexico, United Kingdom, United States // Capitals: Beijing, Cairo, Paris, Berlin, New Delhi, Tokyo, Nairobi, Mexico City, London, Washington D.C. // Languages: Chinese, Arabic, French, German, Hindi, Japanese, Swahili, Spanish, English, English // Filenames for map images: China.jpg, Egypt.jpg, France.jpg, Germany.jpg, India.jpg, Japan.jpg, Kenya.jpg, Mexico.jpg, UK.jpg, US.jpg // 2. Pick a random number up to the length of one of the arrays and save in the variable index // 3. Print out the info in each array using the random index // Example of showing image files using an array called images (your array name above may be different) // (this will only work in Active Code) // Countries obj = new Countries(); // obj.printHTMLimage( images[index] ); } // This method will just work in Active Code which interprets html public void printHTMLimage(String filename) { String baseURL = "https://raw.githubusercontent.com/bhoffman0/CSAwesome/master/_sources/Unit6-Arrays/6-1-images/"; System.out.print("<img src=" + baseURL + filename + " width="500px">"); } } ==== // Test for Lesson 6.1 - challenge import static org.junit.Assert.*; import org.junit.*;; import java.io.*; public class RunestoneTests extends CodeTestHelper { public RunestoneTests() { super("Countries"); } @Test public void test1() throws IOException { String output = getMethodOutput("main"); String expect = "Country Capital Language Image"; int len = expect.split(" ").length; boolean passed = len == 4 && output.contains(".jpg"); passed = getResults(expect, expect, "Did you print all the info?", passed); assertTrue(passed); } @Test public void test2() throws IOException { String output = getMethodOutput("main"); String expect = "<img> 3; passed = getResults("> 3 Countries", difft + " countries", "Can pick a random different country > 3 times?", passed); assertTrue(passed); } @Test public void testArrays() throws IOException { //System.out.println(program); String code = getCode(); int arrays = countOccurences(code, "String[]"); boolean passed = getResults("5 x String[]", arrays + " x String[]", "Did you declare 4 String arrays?"); assertTrue(passed); } }

So far, we have seen arrays of ints and Strings, but we can create an array of any type. For example, the following program creates an array of Turtle objects. Notice that for an array of objects, we must call the constructor of each object to initialize the array elements, for example array[index] = new ClassName();. And we can use array[index].method() to call a method of an object in the array.

// Declaring an array of objects type ClassName ClassName[] array = new ClassName[size]; // initialize array element by calling ClassName constructor array[index] = new ClassName(); // call a method of the object in the array at index array[index].method();

Run the code below to see the 2 turtles in the array. Can you change the array size to 3 and create and add 1 more Turtle object to the array? Make this new turtle turnRight and go forward using its indexed array variable.

In Unit 5, you came up with a class of your own choice relevant to you or your community. In this unit, you will create an array to hold objects of your class.

1. Copy your class from lesson 5.6 below.

2. In the main method, create an array of 3 objects of your class.

3. Initialize array elements indexed 0 to 2 to new objects of your class using its constructor.

4. Call the print method of each object in the array using the array index.

Community Challenge: Copy your class from lesson 5.6 below. Create an array of 3 objects of your class, initialize them to new objects and call their print methods.

• Arrays represent collections of related data all of the same data type.

• The size of an array is established at the time of creation and cannot be changed.

• Arrays can store either primitive data or object reference data.

• When an array is created using the keyword new, all of its elements are initialized with a specific value based on the type of elements:

  • Elements of type int are initialized to 0

  • Elements of type double are initialized to 0.0

  • Elements of type boolean are initialized to false

  • Elements of a reference type are initialized to the reference value null. No objects are automatically created.

• Initializer lists can be used to create and initialize arrays.

• Square brackets ([ ]) are used to access and modify an element in an array using an index. The indexed array variable, for example array[index], can be used anywhere a regular variable can be used, for example to get or assign values.

• The valid index values for an array are 0 through one less than the number of elements in the array, inclusive. Using an index value outside of this range will result in an ArrayIndexOutOfBoundsException being thrown.

We will see in the next lesson that the index of an array is often a variable named i that is used in loops to traverse an array. In challenging AP problems, you will see mathematical expressions inside the array brackets []. For example, array[i-1] refers to the previous element right before the ith element in array, and array[i+1] refers to the next element after the ith element. In the problems below, note that arrays can be passed in as arguments to methods and returned as values, just like any variable.

6-1-17: Consider the following method. Given an array initialized to {4, 10, 15}, which of the following represents the contents of the array after a call to mystery(array, 2)?

public void mystery(int[] a, int i) { a[i] = a[i-1] * 2; }

• [8, 20, 30]
• This would only be true if all elements were doubled by the method.
• [4, 8, 15]
• This would only be true if the call was ``mystery(array, 1)``. Remember that array indexing starts at 0.
• [8, 10, 15]
• This would only be true if the method body had ``a[i-1] = a[i-1] * 2;``
• [4, 10, 20]
• Correct. array[2] = array[1] * 2 = 10 * 2 = 20.
• [4, 8, 30]
• Note that only 1 array element is changed.

6-1-18: Consider the following method. Which of the following code segments, appearing in the same class as the mystery method, will result in array2 having the contents {5, 10, 20}?

public int[] mystery(int[] a, int i, int value) { a[i + 1] = a[i] + value; return a; }

• int[] array1 = {5, 10, 15}; int[] array2 = mystery(array1, 0, 10);

• This would result in {5, 15, 15}.

• int[] array1 = {5, 15, 20}; int[] array2 = mystery(array1, 0, 0);

• This would result in {5, 5, 20}.

• int[] array1 = {5, 10, 15}; int[] array2 = mystery(array1, 1, 10);

• Correct! a[i+1] = a[2] = a[i] + value = a[1] + 10 = 10 + 10 = 20.

• int[] array1 = {5, 15, 20}; int[] array2 = mystery(array1, 2, 0);

• This would result in an ArrayIndexOutOfBoundsException.

• int[] array1 = {5, 10, 15}; int[] array2 = mystery(array1, 1, 20);

• This would result in {5, 10, 30}.

Try the game below to practice arrays. Click on Arrays and click on the element of the * array that would be printed out by the given code. If you’re stuck, check on Labels to see the indices. We encourage you to work in pairs and see how high a score you can get.