Time estimate: 90 min.

7.1. Array Creation and Access

To keep track of 10 exam scores, we could declare 10 separate variables: int score1, score2, score3, … , score10; But what if we had 100 exam scores? That would be a lot of variables! Most programming languages have a simple data structure for a collection of related data that makes this easier. In many block-based programming languages like App Inventor and Scratch, this is called a list. In Java and many programming languages, this is called an array.

An array is a block of memory that stores a collection of data items (elements) of the same type under one name. Arrays are useful whenever you have many elements of data of the same type that you want to keep track of, but you don’t need to name each one. Instead you use the array name and a number (called an index) for the position of an item in the array. You can make arrays of ints, doubles, Strings, and even classes that you have written like Students.

Here’s a fun video that introduces the concept of an array and gives an example.

An array is like a row of small lockers, except that you can’t cram lots of stuff into it. You can only store one value at each locker.

../_images/rowLockers.jpg

Figure 1: A row of lockers

You can store a value in an array using an index (location in the array). An array index is like a locker number. It helps you find a particular place to store your stuff and retrieve stuff. You can get or store a value from or to an array using an index.

Arrays and lists in most programming languages start counting elements from the number 0, so the first element in an array is at index 0. This is similar to how Strings are indexed in Java – the first character is at index 0. If you used App Inventor in the past, you might remember that list elements there start at 1 instead of 0, so make sure you remember that in Java, arrays start the index at 0!

../_images/appinvListComparison.png

Figure 2: Comparing App Inventor lists and Java arrays

6-1-2: Can you think of another example of something that is like an array (like a row of lockers)?

7.1.1. Declaring and Creating 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.

7.1.2. Using new to Create Arrays

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];

exercise Check Your Understanding

coding exercise Coding Exercise

In the following code, add another two more array declarations, one that creates an array of 5 doubles called prices and another of 5 Strings called names. Then add System.out.println calls to print their lengths.

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

../_images/arrayIndicies.png

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

7.1.3. Initializer Lists to Create 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 braces ({}) 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.

../_images/intAndStringArrays.png

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.

7.1.4. Array length

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.

coding exercise Coding Exercise

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.

exercise Check your understanding

7.1.5. Access and Modify Array Values

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.

../_images/appinvSelectComparison.png

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.

exercise Check your understanding

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.

coding exercise Coding Exercise

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] );
../_images/cow.jpg

coding exercise Coding Exercise

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?

7.1.6. groupwork Programming Challenge : Countries Array

../_images/US.jpg

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.

7.1.7. groupwork Design an Array of Objects for your Community

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.

7.1.8. Summary

  • 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.

7.1.9. AP Practice

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 square 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.

7.1.10. Arrays Game

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.

You have attempted of activities on this page