All right. So welcome back to yet another fun filled exciting day of cs106a. A couple quick announcements before we start. First of which, there is one handout, which is kind of a quick reference for you on ArrayLists. It�fs sort of all the ArrayLists you need to know for the hangman assignment part three. If you haven�ft already done it, now you have a quickie reference for it. If you�fve already done it, you don�ft need the quickie reference, but presumably, you saw everything you needed already in the textbook or what we did last time in class. The midterms, it was just a rocking and rolling good time. If you weren�ft there [inaudible], but two things, if you took the exam, please don�ft talk to other people about the exam because there are still some people left to take the alternate exam; and if you�fre taking the alternate exam, you missed out. You�fll still take the alternate exam, so you�fll get the exam, you just won�ft get the full effect of the exam under earthquake conditions, but thanks for actually just -- it was amazing, it was just like how many people want to continue and everyone was, like, rock on. So thanks for continuing with taking the exam. I�fm glad you made it through just fine. Last thing, a little contest. I�fm glad to see there was other people besides us -- we were a little worried it was gonna be like me and 300 normally dressed people, this is not what I normally dress in around the house, just when I�fm in meetings on campus. So the real question is who am I? Anyone know? It�fs a very specific person. Not King Arthur. What? [Student:]Sir Lancelot.

Not Lancelot. [Student:][Inaudible]

I almost considered Karel. I almost went for Karel. I got the big box, but it�fs kind of hard to draw, sort of like, Karel cannot draw that much in the big box. No. Well, I�fll give you hints as we kind of go along, and at the very end I�fll show you if you can�ft figure it out. I almost considered giving whoever could figure it out a 100 on the midterm, but I figured that was kind of just a [inaudible] way of giving you a 100 on the midterm, so I�fll just give you lots of candy. So anyway, just think about it, and if you want to try to search the web or whatever, it is a one particular character, and it�fs not a wizard. I actually thought, �gOh, I could just make it easy for you and just come in and be, like, oh, ha, ha,�h because most people, without the hat, would see it and they�fd go, �gOh, you�fre a wizard, right?�h No. So I just brought the hat to kind of fool you. All right. So with that said, time to actually wrap up one of our last topics, which was arrays. We�fll look at a few more advanced things we can do with the arrays and then get into the details of our next great topic, which is our friend the ArrayList. So when we talked about arrays, a couple people last time said, �gHey, Miron, can I have multi--dimensional arrays, can I have arrays that have more than one index, and in fact, you can. We do refer to these things as multi-dimensional arrays. And so one way you might want to do it is let�fs say you wanted to have this dreaded thing called a matrix. How many people know what a matrix is? I�fm not talking about the bad movie. Actually, it was a good movie. The sequels, not so great.

It�fs basically just a grid of information. It�fs a grid mostly of numbers if you want to think about it in a mathematical sense, but really we think of this thing as a two-dimensional array. And so the way you can think about is if I have a matrix that�fs a [2] [3] matrix what that means is it�fs a grid that has two rows and three columns. Okay. And you might look at that and say, �gHey, that almost likes an array, it looks like two arrays stacked on top of each other,�h and in fact, you would be correct. If we have multi-dimensional arrays, what we�fre actually creating our arrays of arrays. So really what we want to do here, if we want to create this thing called a matrix, is we specify the type that we�fre gonna store in all of the boxes in that grid, and then we specify as many pairs of square brackets as we have dimensions of that thing. So if we have two dimensions here like we have rows and columns then we specify two open and closed brackets in a row, if we had three like we wanted to make a little thing that represented a cube we�fd have three sets of brackets. So here I�fm just having two because I�fm just gonna show you two arrays so you can think about the generalization from there. And then we give it a name so we might call this thing a matrix. And then we specify basically the creation of that matrix in the same way we created an array except now we have more than one dimension, so here we say new, we specify the type again, like, indices and then to give it the size rather than just having one size that we specify, we have a size for every dimension. So if this things gonna be [2] [3], we specify the first dimension as two and then the second dimension as three. And each one of these is its own pair of square brackets. We don�ft use comma notations, so if you�fve worked with some other language or you say 2, 3, nuh uh. It doesn�ft work in java. It�fs [2] [3] no spaces immediately after it. And so what this does when you create that is it sort of creates this thing that�fs this grid that�fs a [2] [3] grid. And now you can refer to the individual elements of that grid, so the way you can think about it is this is element [0] [0] or really you want to think of them in brackets, and then this becomes element [0] [1] and this is element [0] [2] and so forth, so this is element [1] [0] and this is [1] [1] and this is [1] [2]. So if you kind of think about assigning to elements of that you could say something like matrix [0] [1] = 5 and what that will do is it�fll say, �gOh, where is [0] [1], here is [0] [1].�h

Well, what I�fm gonna do is, in that particular cell in your grid, is just gonna stick in the value five. And you can use that like an integer anywhere else you could use it like an integer or a single element of an array. Okay. The other thing that�fs kind of funky about this is that this two-dimensional array is really -- the way you can think of it is it�fs an array of arrays, right? It�fs an array -- think of it this way as an array. It has two entries in it and what is each one of those entries of the array, well, really every entry of the array you can think of this as one cell, that whole thing, and this whole thing as another cell and each entry of that first dimension of the array is just another array with three elements in it. Okay? So what that allows you to do is say something like matrix subzero and matrix subzero, the type of this thing, is an integer array. A single dimensional array because what is matrix subzero, it�fs this full line here. It�fs the first row of the entire matrix, and then if I specify something else, like I specify a column, that�fs how I get [0] [1]. First I specify the row, and then I specify the column. If I don�ft specify a column this is referring to the whole row, which means it�fs just referring to a whole array.

[Student:]Can you refer to [inaudible]

You can�ft. You have to refer to things in order, so there�fs no way to just pull out a column, so if you�fre feeling sort of like, �gOh, but in my Math 53 class we do all this stuff with columns.�h Yeah. You just have to pick, in some sense, what�fs gonna be your major ordering for this thing and have that one be first. So you could kind of think of it in your head that, �gOh, well, my first index is really my columns and think of this thing as being the transposed and all that,�h but you just have to keep track of it in your head. Okay? Any questions about that? All right. So we can write a little code that makes use of this just so you see a quickie example. And we could, for example, go through all the elements of this grid and set our initial values to be one, so we could have something like I = 0. �gI�h is less than -- what you want �gI�h to be less than in the first index is 2. I ++ and then you�fre gonna have some other four loop. Let�fs say this is J = 0, J is less than 3 because that�fs the size of my second index, J++. And then inside here I could just say something like matrix I sub I, sub J = 1. And that would initialize all the cells in my grid to be one. Okay? Is there any questions about that? Hopefully fairly straightforward kind of stuff. You can have as many dimensions of arrays as you want sort of within reason, and within reason being how much memory your computer has right because if you imagine, �gHey, I don�ft only want a [2] [3] matrix, I want a [2] [3] bi-hundred matrix,�h so this becomes a three dimensional array. Right? So I basically have this grid repeated a hundred times going forward. Suddenly, you�fre using up a whole bunch of memory. Right? So you want to be careful doing that, but if you wanted to do that you would just add another pair of brackets here and you�fd add another pair of brackets over here with a hundred and now you would have a three dimensional array. So if you want to create, like, your friend the Rubik�fs Cube or something, with is [3] [3] [3], now you know how. Okay? And if you want to do real funky things with four and five dimensional objects or whatever, be my guest. Okay? But we�fre not gonna use them a whole bunch in this class, so I might show you some examples of two �gD�h stuff momentarily, but most of the arrays we�fre gonna deal with are just what we refer to as one dimensional arrays, right, which is just a list. All right? So any questions about multi-dimensional arrays? If you�fre feeling okay with multi-dimensional arrays nod your head. Good times. All right.

So moving on from the array we can now go back to our friend that I briefly introduced last time, and now we can go into excruciating detail, our friend the ArrayList. Okay? And the ArrayList -- the way you can think about is it�fs an array just kind of cooler. Okay? So the idea behind an ArrayList is an ArrayList first of all really is an object, and it�fs an object that�fs provided for you in the Java Util Package. We talked a little about this last time. I�fm just repeating it just for good measure. So you import the Java Util that�fs star packet to be able to get at the ArrayList class. Okay? And the way you can think about an ArrayList is it�fs really like an array, except it�fs an array that dynamically changes its size depending on how you add elements to it. So you can just say, �gHey, add another element to the end,�h and it will just go, �gHey, you know what, I�fll just create extra elements at the end for you and now your size is one greater.�h And so the way to think about it is in terms of effective and actual size, that we talked about last time, was with regular arrays you set up with the actual sizes that�fs declared, and then your effective size is how much of it that you�fre using. With an ArrayList, think of it as the effective size and the actual size, at least stylistically, are exactly the same thing. Whenever you want to add another element to the end, its effective and actual size both grow. Okay? Now underneath the hood, the implementation actually involves some stuff where the effective and actual size can be different, but that�fs all abstracted way for you. As far as you�fre concerned, effective and actual sizes are basically the same thing. Okay? And it provides some other functionality that is nice, and I will show you that in just a moment. But this particular ArrayList thing is called a template. I�fll give you a little history of templates. I mentioned this briefly last time, but I will mention it again. Starting in Java, the book refers to it as Java 5.0. A lot of programmers will say Java 5.0. Some programmers will say Java 1.5, and what you have installed on your computer is either Java 1.5 or Java 1.6, which some programmers would say is either Java 5 or Java 6, which you would look at and say, �gHey, man, that makes no sense at all, why is it like that?�h

So I�fll give you a little bit of history. Quick history lesson for the day. Many years ago, oh about 1995, there was this thing called Java 1.0. It came out, people were happy and went, �gOh, nice,�h and then Java 1.1 came out and people looked at that and said, �gYeah, nice,�h and then Java 1.2 came out and people said, �gNice!.�h So when they said, �gNice!,�h 1.2 in some people�fs mind was such a major change in the language Java that they started calling it 2.0, and at that point when 1.3 comes out you can�ft say, �gOh, well, that�fs 2.1,�h right, because then it gets really confusing so then when 1.3 came out people called that Java 3.0. And 1.4 was 4.0, 1.5 became 5.0, 1.6 became 6.0, but in fact, the confusion still exists so if you go and look in your system most of you on your system it will actually have this 1.X number. Most programmers will actually refer to it by just the X as opposed to the 1.X. Don�ft be confused. They�fre really referring to the same thing. Okay? So what we�fre dealing with here, in terms of ArrayLists as templates, is Java 5.0 or later so sometimes that�fs just written as 5.0 plus, which all of you should have because that�fs what you installed in the beginning of class. The book actually shows both the pre-5.0 and the post 5.0 version. We�fre just gonna deal with the post 5.0 because at this point, the older version is just not worth worrying about. Okay? So what is this thing called a template that exists in Java 5.0 and later versions? Okay. What a template is is it�fs basically a class that allows you to specialize it based on the type. What does that mean? Okay. So let me give you a few examples of what that actually means. What that means is when you see methods for this ArrayList class, and you�fll see them listed in the book, you�fll see something that looks like this. There�fs a method called Add and it returns a bullion and you�fre like, �gOh, that�fs all good and well,�h what kind of parameter does Add take and you�fll see the spunky thing that looks like this, [T] element, and you look at that and say, �gOh, Miron, you never told me about the [T] type, what type is that?�h And the way you can think about it is this is a parameterized type. When you create an ArrayList you say, �gI�fm gonna create an ArrayList of a particular type.�h So when you set up your ArrayList you create an ArrayList object. And when you create that object, as you saw last time very briefly, in angle brackets, which are actually less than and great than signs, you specify a type like string. So you say ArrayList string and we call this thing, for example, SList and we might create that to be a new ArrayList. Again, we specify the type string () because we�fre actually calling the constructor which takes no arguments. Okay? So you create this new ArrayList and this thing that you specify here, the type that you specify there, is what we refer to as the type or the template.

You can think of the template as having all these holes in it, and the way those holes get filled in is they get filled in with whatever type you give it here. And those holes are specified by this [T]. The way you can think of this T is it�fs the Type, that�fs why it�fs a T that this template is what we refer to instantiated as. You create one of these templates of this type. So I create an ArrayList of strings is the way programmers refer to it. Usually, you can think of this as meaning of and this as meaning nothing. So ArrayList of string is how we would actually say it. And when you create an ArrayList of string you get an Add method for this ArrayList of strings that�fs now [T] is replaced by string. So the method that it actually provides for you is an ad method that takes a string type. Okay? If I were to create an ArrayList of G ovals I would have an Add method for that class that�fs elements was a G oval. Okay? So it creates for you basically a whole class that has all the holes filled in with whatever type you specify here. Any questions about that? Kind of a critical concept, new in Java 5.0. It�fs new, it�fs dynamic, it�fs cool, it�fs funky. People like it, now you can, too. All right. So let me show you some of the methods that you get with this ArrayList kind of thing, and then we�fll actually go into the details of using it. And you�fll notice that when we talk about the methods, this [T] thing will show up all over the place. And the way you want to think about that is this is just getting replaced with whatever type you instantiate your ArrayList to be. So if we go to the computer real quick, drum roll please, it�fs the methods of the ArrayList. So what are the methods of the ArrayList? The first two methods are Add. What Add does is it takes in some element type of whatever type your ArrayList is instantiated to be, right, the [T] and it adds it to the end of the ArrayList. And you might say, �gHey, Miron, what does that return a bouillon,�h and it always returns true for the bouillon, so why does it return a bouillon at all? And about in a week it�fll be clear why it always returns a bouillon. Okay? And why, in this case, it�fs always true, but as far as you�fre concerned you don�ft really care about the return type. You�fre not gonna do anything with it because it�fs always true. You�fre just gonna say Add and even though it�fs returning something to you, you�fre not gonna [inaudible]. It just adds an element to the end of the ArrayList, which means the ArrayList dynamically grows by one. Right? It�fs an array with dynamic size, so it just creates the space for you and adds the new elements to the end. You can also add in a particular position just like you could add an array at a particular position, you can do that in an array list by specifying the index and the element that you want to enter at that index, and it will just put that element in at that index for you and it�fs just kind of all abstracted in terms of how it does that. Okay? It�fs just growing its size as needed. Besides adding things you can remove from the ArrayList, right, which is something that�fs funky. You didn�ft really think about removing from an array. Right? An array you could sort of say, �gYeah, read that value and maybe I don�ft care about the value anymore,�h but you couldn�ft actually say, �gYeah, just get rid of that value completely, like, get rid of the space associated with that value.�h Okay? So when you say remove at a particular index, it actually removes that element and returns it to you from the ArrayList.

And similarly, you can either remove or you give it an index and you say, �gGive me back that particular element,�h or you can remove a particular element if it appears. So this returns a bouillon. So let�fs say you have an ArrayList of strings and one of your strings may be cs106a, and you�fre like, �gOh, cs106a, it was so near and dear to my heart until I had to take a midterm in the middle of an earthquake,�h remove cs106a. And then you try to do this for everyone on campus. Well, some people have 106a and if it appears it�fll return true and remove it from the ArrayList, but some people don�ft. And it doesn�ft suddenly crash their program or whatever. When you come to that person and you call remove on cs106a, it just returns false to indicate, �gHey, cs106a wasn�ft in this ArrayList, I didn�ft make any changes to the ArrayList.�h Okay. And similarly, if you just get really angry or you decide, �gOh, I�fm gonna take some time off from Standard, I want to just clear my ArrayList of classes,�h you can call �gclear�h which just removes everything in the ArrayList. It just kind of resets it to be a blank ArrayList. Okay? You can ask an ArrayList for its size, not particularly exciting, but very important to actually be able to do. It just returns how many elements are currently in the ArrayList. Besides putting elements in an ArrayList and removing them it wouldn�ft be much fun if you couldn�ft actually get an element, so getting an element at a particular index returns the object at that specified index. It doesn�ft remove it from the ArrayList, it just gives it back to you. So if there was an object or some element at position one, okay, and you call �gGet�h it remains at position one. If you call �gremove�h it�fs actually removed from the ArrayList. Okay. And then there�fs set, and so set you can actually say, �gHey, at some particular location I don�ft care what�fs there, just slam this thing I�fm gonna give you.�h So what it does is you give it a particular index and you give it some particular value, and it puts that value at that index. So you can say, �gSet at position one, you know, this string 106b because now after you�fve taken 106a, maybe next quarter you�fre taking 106b, and it goes, �gThat�fs great,�h and what it gives you back is the old value at that index. So it would give you back 106a if that was the old value that was there. Just in case you want to do sort of the quickie slight of hand change, presto change, stick something new in, get the old value out. You can do that if you want. That�fs just the way it is. Last but not least, a couple of things real quickly. You can get index of. This is kind of funky. This essentially does a search for you on the ArrayList. So you give it some particular value, like, you could say, �gHey, is 106a actually in my ArrayList,�h so you would pass it to string 106a and it would return to you the index of the first occurrence of cs106a if it was in your ArrayList and minus one otherwise. It�fs just kind of like the index of operation that you did on strings before when you called it with like [inaudible] or substrings.

It�fs the same thing here except now you have a whole list of things, and that whole list of things can be any type that you want. Contains, the same kind of thing. It basically just returns a bouillon. You give it some value, and it says, �gTrue or false, this value actually appeared in the list and is empty.�h It just returns true or false to let you know if the ArrayList contains any elements at all. Okay? So fairly generic, basic functionality and it�fs all kind of good and well and we�fre happy. So let�fs use some of that and actually write a program that makes use of an ArrayList together so we can see how some of this functionality actually looks, and then we�fll try it out on the computer and try a few more advanced things with it. So here�fs our friend the Run Method. We got public, void, run; inside here we�fre gonna create a new ArrayList of strings. So I have ArrayList of string, ignore that part, although you need it for the syntax, but we just don�ft say it as programmers. We say ArrayList of strings. My string list, I�fm just calling it SList, is a new, very similar to what you saw there, ArrayList that holds strings and there�fs no parameters for the constructor, so I make sure to have the () even though it looks kind of funky. You have to have it. So I just create one of these, and now what I�fm gonna do is just repeatedly read strings from the user until the user enters a blank line to indicate, �gHey, there�fs no more lines that I want to give you,�h and then I�fm gonna write them all out. So I have some wild loop in here and I�fm gonna do my friend the wild true loop, right, the old loop and a half construct where I�fm gonna have some string line that I�fm gonna read in from the user. So I�fm just gonna use read line and to keep the prompt short, it�fll just be a question mark. And I�fll just assume the user knows to enter a line there. I want to check to see if that line actually contains anything so I check is the line dot equals to the empty string �g�h and if it is then I�fm gonna break, which means the user just gave me a blank line so there are no more lines that they want to enter. And if they gave me a line that is not equal to the empty string, then I actually got some valid line. I want to stick that string inside my ArrayList at the end and tell my ArrayList to just kind of grow in size. So I do that by just saying SList dot Add, and you�fll notice the parameter that Add�fs gonna take up there is something of whatever the type of the ArrayList is. So in this case, it�fs going to be a string so I can do an Add on line whose type is string and I�fm perfectly fine. And this will return to me true, but I don�ft care because I know it always returns true. So I�fm just not even gonna assign whatever turns to many variables. And this will keep reading strings from the user until the user gives me a blank line to indicate that they�fre done, and then I�fll write a little loop so this is just a continuation of the program to actually print all those strings on the screen so you can see what that looks like. Okay? So I have a little four loop over here for I = -- forgot the [inaudible] = 0. �gI�h is less than -- I need to know how many strings are actually entered into my ArrayList. Okay. Well, I can use my methods over there to figure that out with size. So I just say SList dot size I ++, and inside here I�fm just going to print line and the line that I�fm going to print is sequentially I want to go through my ArrayList and get strings one at a time at the given index. So how do I do that? I just say string list, and what�fs the method I use, -- [inaudible] the single syllable gets candy. And so did everyone else. Mostly the empty seats -- get �gI.�h

So that will get the �gI�h string. I got my parens lined up there and that will print everything out. So it just gets a bunch of lines and the user prints out those lines on the screen. Okay? But notice I don�ft need to declare an initial size for the ArrayList. I don�ft need to worry about is it big enough, did I over write the end of it, do I get the big mean evil exception going off the end of the ArrayList? No, it just keeps expanding space as long as I need space. That�fs why it�fs so versatile to use and when I�fm done, I can just go ahead and say, �gHey, what�fs your size now?�h And then I can add more if I want, so let me show you a generalization of this program that we just wrote. So if we come back to our friend -- all done with you power point. Thanks for playing, and don�ft save. All right. So we come over to our friend eclipse, and here�fs a simple ArrayList example oddly enough named simple ArrayList dot Java. So what this is gonna do is gonna pass around the ArrayList as a parameter doing the same functionality, but I just want to show you what it looks like when we de-compose the program a little bit and how we pass ArrayLists as parameters. So I create an ArrayList of strings here, the same syntax that I had before. I just called it List instead of SList, and I want to read in that list from the user so I�fm going to pass as a parameter the whole ArrayList.

The way I pass the whole Array is just by specifying the name of the parameter, which in this case, is list. So I�fm gonna read a list from the user. So what does read list do? Here�fs the whole read list function. Now here�fs the funky thing. If you can get to the computer that would be extremely useful. The read list function -- how do I pass an ArrayList as a parameter? I just say ArrayList and List and you might look at this and say, �gOh, but Miron, you�fre not specifying what kind of ArrayList it is. Is it an ArrayList of strings, an ArrayList of integers,�h the function or the method doesn�ft care. All it cares about is you�fre giving me an ArrayList, and I�fm gonna assume you�fre gonna do sort of the right thing with it in terms of putting stuff in and taking stuff out of the ArrayList. But you�fre just giving me an ArrayList, so you do not specify as a parameter the type that that ArrayList stores. It knows because the actual object you pass underneath the hood knows, �gHey, I�fm an ArrayList of strings.�h So if you try to stick something in it that isn�ft a string, it�fll get upset. But it just trusts you when you actually pass it as a parameter. So here we say, �gWhile true, string item =s read line,�h so here I�fm just calling it item instead of line. I read a line from the user. If that line happens to be equal to �g�h I�fm done and I break out of the loop. Otherwise, what I�fm going to do is add the item that was just read, which is the string, to the list. So it�fs exactly the same code that I had here, I just have decomposed it out into a function. Now notice I don�ft return anything from this method, and the reason why I don�ft return anything from the method is an ArrayList, at the end of the day, is an object.

When I pass an object what happens to changes I make to the object? They persist, right? It�fs an object. It�fs the like the Mona Lisa that�fs being shipped around in the truck. If I go and slice the truck in half, I slice the Mona Lisa in half because I really have the real object. And so I don�ft need to return anything because any changes I make to this ArrayList, because the ArrayList itself is an object, those changes actually persist. And so whether or not you think of an ArrayList as an object or as an array, in both cases if I pass an array to a method or I pass an object to a method, in both cases the changes persist, so it doesn�ft matter how you think of an ArrayList. If it�fs easier for you to think of it as just an array, think of it as an array and the changes persist, and if it�fs easier for you to think of an object, which is what it really is, then changes persist as well. And the truth underneath the hood is to be real quiet. Array is just a regular ray are objects too. Just so you know. But you don�ft need to worry about that. All right. Just think of them as this thing called an array. So that reads a list. And then after we read the list from the user, and all these changes that we made to list persist, I print out the ArrayList, and I�fll print out ArrayList. Okay. And I�fll print out an ArrayList again, it gets the ArrayList as a parameter and it just says the list contains list dot size elements, so it tells me how many elements are currently in the list and then it does the little four loop that I just drew up on the board going through all the elements from zero up to size, actually size minus one, and writing them all out on the screen. And I�fm gonna do this twice so I�fm gonna read the list, print it out and then I�fm gonna read to the same list just to show you that the list is gonna continue to grow when I do that, so let me run this. I already compiled it. So it�fs asking for lines, cs106a. That�fs over in the psych department. CS106a rocks. And that�fs the end. It says, �gList contains two elements, cs106a and rocks,�h and I�fm, like, �gOh, yeah, I forgot to add heavily. And now the list contains four elements because I continued to add stuff to that same list. It just continues to append onto the end. Okay? Are there any questions about that? It�fs not like you just add and after you add and you stop adding or it�fs just frozen, it�fs not frozen. You can just keep adding more stuff if you want. Okay? Any questions about that? Are we feeling okay about the ArrayList?

Now here�fs the funky thing. At this point, you should be going, �gHey, ArrayList, kind of cool. How come this time, Miron, you�fve been doing ArrayLists with strings? I thought the simple type was like ints. Why weren�ft we doing ArrayLists of ints? Any guesses? No guesses? No guesses. All right. I�fll give you a hint. It�fs a popular science fiction TV show from the 70s. Actually, 60s, I would imagine, 60s and 70s. I think it�fs actually 60s. Keep thinking. It�fll get you closer. Here�fs the funky things about ArrayLists. An ArrayList, as a template, can only be instantiated, which means its type can only be specified to be objects. So ArrayLists hold objects. As we talked about in the past [inaudible] double bouillon and are friend the little care always comes at the end, just kind of struggling along, are not objects. They�fre primitive types. So I cannot in fact have an ArrayList of ints. If I try to say ArrayList [ints] I get an error because an ints is not an object. So in order to get around that -- remember a few lecturers ago we talked about, �gHey, for everyone of the primitive types there�fs an equivalence class type, so these are the primitives and the equivalent class types, which are called wrapper classes because they kind of wrap around these. The wrapper classes are INTEGER, W, BOUILLON and then character all written out are the wrapper classes. So if I actually want to have an ArrayList that holds integers, it can�ft hold ints. I need to create an ArrayList that holds integers. It actually has to hold objects so it has to hold instances of some class. Okay. Now, in the bad old days it was Java, you know, pre-Java 5.0 this made ArrayLists really cumbersome to use because every time you had some integer somewhere you said, �gHey, you know what, I have this thing called int X and maybe it�fs value I said it originally to be five, and now I want to stick this inside some ArrayList of integers that I created somewhere and I can�ft do that. So I need to actually go and create a new integer object and assign the value for that integer object to be what X is and it just became a huge pain. So you actually need to do something like this. You need to say, �gInteger Y = new integer,�h and then give it the value X because what you need to do is create a new instance of the integer class and its initial value you gave it as an int, and then it created this nice little box for you which was the integer object and inside the box there is this little space for the actual value and it held the five in there. And that was a pain to have to do this every time you wanted to put some object into an ArrayList of integers. And similarly, if you wanted to get something out you had to do something equally cumbersome, which if I wanted to get the value out. So if I wanted to have some integer Z here and I want to say, �gHey, get the value of that integer, I can�ft just say Z = Y, at least I couldn�ft in the bad old days.�h I needed to actually say Y dot ints value and call a method on it. And then what this gave me back from that object Y was its actual value of an integer, so it would give me back the five as an integer. Okay. All that changed in Java 5.0. So the process of essentially creating an object around a particular primitive, right, so we had our little primitive int five over here, and what this was basically doing was creating Y to be an object around the five.

This process is still called �gboxing�h because basically what you were doing was drawing another box around your value. And this process over here of going from the box that you had to getting the value out of the box, interestingly enough, was called unboxing because basically when you wanted to get the value out, you cared about the value inside and essentially you wanted to erase the box that was around it. Okay. This whole boxing and unboxing happens for you automatically in Java 5.0 and later, which means if I create an ArrayList of integers I can just add an int to it directly. So if I were to have an ArrayList it still needs to hold object of the integer class, so I still can�ft say an ArrayList of ints, and I�fll call this IList = new ArrayList integer, so I create one of these things. Now I can say IList dot add and give it X directly where here I might have int X = five, and you would say, �gBut Miron, you told me this ArrayList can only store integer objects and you�fre passing an ints. You told me that doesn�ft work.�h Well, this is what Java 5.0 is doing for you automatically. It says, �gHey, this things expecting an integer and you�fre giving me an int,�h which means you really need to box it up. It�fs kind of like you finished your eating and you still have some food left and you want to store that food somewhere, what do you need to do? It�fs got to go in a box. And before you used to have to ask like the waiter or the waitress to bring you a box and they would create it in the backroom somewhere, probably out of other food that wasn�ft eaten, and then you would get the box and you�fd put your value in, you could finally go and store it at home. And now Java just says, �gHey, you know what, people were asking for the box so often, yeah, if you need that food stored in a box, I�fll just put the box on it for you, and then when you want to get it out over here,�h like you want to say, �gint is Z = IList dot [inaudible], the zeros elements.�h Before you would just get the box, right, because that�fs all this thing is storing are boxes that hold integers. Now I�fll actually take the box out for you and let you eat the food automatically. Okay. So it does that for you automatically, which makes these things a lot more useful. And the thing to keep in mind is that all these wrappers classes are still immutable objects. They�fre immutable in the same sense that strings are immutable. When you create one of these guys, like this guy Y has the value five, its value is five. You can�ft go back and say, �gHey, set its value now to be six,�h because it does not have a method to set its value. It can get you its value by asking for its integer value, but there is no way to set its value. If you now want to create some new integer that�fs value is six, then you need to create a new integer and actually say what�fs its value, its Y + 1. Okay. Just in the same with strings you couldn�ft change a string in place. If you wanted to actually change the string, what you really needed to do was create a new string that copied over all characters from the old string that you cared about and potentially made some other changes. Okay.

So the wrapper classes are immutable in the same way strings are immutable. Once you set their values, it does not change. If you want to make it look like its really changing what you do is you create a new one and you would assign it to overwrite the value of the old one. Okay. So let me show you an example with that. And we�fll use our same little code here and this is gonna be so much fun all we�fre gonna do is say, �gHey, you know what, rather than having an ArrayList of strings, I�fm gonna have an ArrayList of integers.�h And you�fre gonna say, �gBut Miron, this is gonna make your whole program blow up.�h Well, read list doesn�ft care what type of ArrayList is getting passed in here. It�fs just getting passed an ArrayList. I don�ft want to put strings in there so I�fm gonna change my item to be an int and I�fll read in ints from the user, and basically the way I�fm gonna stop is if that int is == to zero, and Add actually will just remain the same. And here�fs the coolest part of all. Prints ArrayList doesn�ft change at all even though I just went from strings to integers. Why does it not change at all? Because this ArrayList parameter here doesn�ft care what type you�fre passing in. The list contains the size method doesn�ft care what type is actually in the list, this list outside doesn�ft care what type is in the list. And when I get the element from the list, what I�fm getting is an integer object, and when I go to print it out, it automatically gets unboxed for me to get turned into an integer and printed out. So even though I changed from an ArrayList of strings to an ArrayList of integers because I never specify the type here and that�fs just the way life is. That function will just work on change. Okay. So let me run this program again. Yes, go ahead and save and do all the happy things you need to do. One, two, three -- [inaudible] numeric format, right, it wasn�ft in line and it wanted a zero. Now the list contains three elements and then I�fll add four and five and then give it a zero and now the list contains five elements. Okay. Again, the beauty of object drawing and programming and the beauty of templates. Some things can just be reused even though you change the type, and you just need to be careful what you�fre actually storing and not storing. Okay. So any questions about that? All right. Another quick example. When we talked about arrays I told you, �gHey, you know what, you can have an array that contains objects in it too.�h You can have an array of G objects or an array of G ovals or whatever you want, and that�fs perfectly fine. And you can do the same thing with ArrayLists. As a matter of a fact, with an ArrayList you don�ft need to worry about all this boxing/unboxing stuff because if you have an ArrayList of let�fs say G ovals or G [inaudible] or whatever the case may be.

Those are already objects so there�fs no boxing or unboxing that needs to go on. Okay. So let�fs say I was gonna have an array of G labels, I could say G label -- actually, let me show you this first of all in just the case of regular arrays and then we�fll move on. So I can have an array of labels. So here is labels and I say something like new G label, it has four items in it and what I get here is four elements of my array that all start off no because none of them have been initialized. Okay. That�fs what I got in the array world. If in the ArrayList world I create an ArrayList of G labels I would say something like ArrayList that�fs going to store G label, and I�fll call this my G list or my GL = new ArrayList of (G label). This creates for me an empty list of G label objects. If I now want to add G labels I still need to create the actual underlying G label object and then add it to this ArrayList, much in the same way that with a regular list that when I created the array, all I got was just an array of no. So if I wanted to have the individual elements, I still needed to call a new on a G label for each one of the elements that I wanted to create. Same kind of idea going on with ArrayLists. All I get is an empty list and every time I want to add a new G label I should�fve created that G label object already. Okay. So let me show you an example of this with another funky program we call graphic numbers, or I call it graphic numbers. I just wrote it this morning, and all this thing is gonna do is listen for the mouse. Okay. All of the activities are going on when I click the mouse. So what�fs it gonna do? What it�fs gonna do when the moue is clicked -- well, before the mouse is clicked I have some instance variable in here. The instance variable I have in here is this thing that I just showed you. I have an ArrayList, it�fs gonna be private, so it�fs gonna be within my object, it�fs an ArrayList called labels that holds G labels. So what I get when this line executes, when the program starts running, is I get an empty ArrayList of G labels. There�fs no G labels in it. The way I�fm gonna add G labels is every time -- this is the whole program -- every time the user clicks the mouse I�fm gonna create a new G label and add it to the list. Okay. So what I do when the user clicks the mouse is I�fm gonna create a new G label called �glab�h and the label or the text that�fs actually associated with this label is just the pounds sign or the number sign and then however many labels are currently in my list, which means at first it�fs gonna be zero so it�fs gonna give me a zero and the labels gonna be number zero, and the next time it�fs gonna be number one, and the next time it�fs gonna number two, etcetera. But the first time it�fll be number zero.

I set the fonts on that label to be Courier 18 because as the years are passing my eyes are having problems so I need the font to be big. And then what happens -- here�fs the funky thing that I want to do. I want to say, �gYou know what, where am I gonna put this on the screen,�h I always want to put the brand new label, like, when it�fs born in the same place on the screen, but the problem is if I put number zero there and then when I�fm ready to put number one, if I put it right on top of number zero it�fs gonna get real ugly and it�fs gonna be a mess, it�fs like dogs and cats sleeping together, and the whole thing is just not gonna work out. So what am I gonna do? I�fm gonna say, �gHey, why don�ft I take all the other numbers I had before and move them down one line so the new guy will always show up on top, and then when there�fs gonna be a new one, everyone will move down and make room for that new one.�h It�fs kind of like a waterfall of numbers. It�fs just kind of like the movie the Matrix, right, it�fs kind of like the numbers all just move down, the next number will take its spot. So how do I do that? Star Trek, think Star Trek. All right. So I�fm gonna take all the existing labels that I�fve already put on the screen and move them down. How much am I gonna move them down? I�fm gonna move them down in the Y direction, the height of the label. So the reason why I first create the label without a location and set the font is because I want to know how big that label actually is and how much I need to move everyone else before I put this on there. So I say�h Label get your height, tell me how big you are so I can move everyone down that much space to put you in,�h and now I�fm just gonna have a four loop. And that four loop is gonna go through my label list, which means it�fs gonna go through all the existing label objects I have. I�fm gonna say, �gHey, in that label list get the [inaudible] label and move it down by the amount DY.�h Okay. So this four loop goes through all of the objects that are in my list of labels and tells them to all move down, so whatever place they were on the screen before, they all move down one step, and that step is DY pixels. And after they�fve all moved down they said, �gHey, hey, we made space for the new guy. New guy, come on, come on, come, and the new guy runs over and is, like, ah, I�fm part of the number group now.�h And so we add him to the canvas. We add the label; we added the start X and the start Y location, which is always the same. Start X and start Y are just some consistencies that are given here. So the new guy always goes to the same place, everyone else just moves down to make room for it. And I want to remember, �gHey, new guy, we�fre not just adding to the screen, we have to add you to the ArrayList, too.�h If we don�ft add you to the ArrayList, we�fre not gonna move you next time we need to move you when you�fre no longer the new guy. So this add is adding to the canvas, this add is being called on the labels ArrayList, so it�fs adding this label object to the ArrayList.

So there�fs two adds we do. One puts it on the screen; one puts it in the Array List that we keep track of. Any questions about this code? Let me just run this code so I can show you what�fs actually going on and how everyone just moved down for the little guy. Okay. Which I realize is vaguely what happens to your life when you have a child. Basically, everything else in your life that you thought was important moves down and the little guy really takes over. So here�fs graphic numbers, and it�fs just the most wonderful thing in the world. All right. There is zero. I clicked once, and now I�fm gonna click again. One comes in. I�fm gonna click again. That means zero�fs got to move down by DY, ones got to move down by DY, and then two comes in. And if I keep clicking, everyone just keeps moving down and the new guy -- or new woman I should say -- or new it if we want to be gender neutral -- just shows up in the same place, and then you can play games with your friends, like, first to a 100. Yeah, because it�fs, like, 4:00 A.M. and you�fre, like, �gNo, no, first to a 1,000.�h And number zero is still there. It�fs just way off the screen, but it�fs still down going, �gYeah, new guy, come on. I�fm just moving for you, right, and it doesn�ft know it�fs not being displayed anymore.�h Okay. So any questions about that? All right. So you can have an ArrayList that contains any kind of object. Now there�fs one last thing I just want to show you that�fs just fun and cool. Okay. And here�fs the thing that�fs fun and cool. And the thing that�fs fun and cool is that now that you�fve learned about all this stuff with arrays and we�fre, like, �gOh, you can have an array of numbers or you can have a matrix of numbers,�h and you kind of look at that and you�fre, like, �gYeah, Miron, yeah, that�fs kind of fun, kind of, sort of, but you know what I really like, I like pictures. Can I do stuff with pictures in arrays?�h And you think for a while and you say, �gYeah, because if you couldn�ft, I wouldn�ft be asking you that question and setting you up for the fall.�h Sometimes I might, but not right now.

Think about a picture, right -- and by a picture I mean a G image. What is a G image, really? A G image is basically made up of a bunch of pixels and those pixels live in an array basically, actually, it�fs a grid. They live in a two-dimensional array. Right. So if I have some G image that looks like a smiley face then maybe I have some pixels that look like that, and I just have some G image, and those are the individual pixels. And you look at that and you say, �gHey, that�fs kind of cool. Could I actually manipulate that grid of pixels?�h Yes, in fact you can. And the value that�fs stored in each one of these elements of the G image -- there are some pixel arrays, which are actually a two-dimensional array, and I�fll show you how to manipulate it in just a second. There�fs an int that�fs stored in each one of these cells. You might look at that and say, �gAn int? Why an int? I thought I could have all these colors. Well, it turns out in fact you can encode a whole bunch of different colors in a single int using something called RGB Values, which stands for red, green and blue. And if you ever look real, real closely on your TV screen, every little dot on your TV screen, unless you have an LCD TV screen, if you look at the old school TV screens they�fre really made up of a little green dot, a little blue dot and a little red dot, and the way you get different colors depends on how intense each one of those three things is. So this single integer actually encodes all three of these values using an encoding scheme that�fs actually described in the book. It�fs not worth going into all the details. You don�ft need to worry about it. But all you need to know is that you can get that red, green and blue value out of this single integer. Okay. So if you can do that, what kind of stuff can you actually do with your program? You can take an image, let�fs say a color image, and turn it black and white. And you say, �gHow do you do that, Miron?�h So let me show you. We�fre gonna read a G image from a file, so this is just the standard G image stuff that you�fve seen before.

We�fre gonna create a new image that�fs gonna read this file called �gmilkmaid.gif,�h which is basically just the little picture that you�fll see in just a second of a little milk made. And then we�fre gonna create a grayscale image of it, and then we�fre gonna display both the regular image and the grayscale image at sort of twice their size, we�fre gonna scale them by two because it�fs actually a small image to begin with. So we�fll scale them just so you can see it more closely. And we�fll show them side-by-side to each other so I just put in some parameters to make them side-by-side. How do I create the grayscale version? What I do is I�fm gonna pass that G image, there�fs a parameter called �gimage�h to a method called �gcreate grayscale image,�h which we�fre just gonna write together or I�fm just gonna show you here. What I can do from a G image is ask it for its pixel array, that thing over there, it�fs a grid; it�fs a two-dimensional array of integers. So what I get back in this value that I�fm gonna call an array is it�fs basically just a two-dimensional array of integers, and I�fm getting a copy of all of the pixel values of that image. How do I figure out how high the image is? I can ask that array for its length because remember a two-dimensional array is an array of an arrays, which means that the array itself, or this thing called image, is basically an array that contains one row per element. So what�fs the height? It�fs the number of rows I have. So if you ask the main array itself how many elements do you have, it tells you how many rows it has. That�fs the height of the image. So I get that from array dot length. How wide is the image? It�fs how many columns are in one row, so if I say, �gHey, I can pick any row I want,�h but I�fm just gonna pick the first row because I don�ft know how many rows there are and I don�ft want to pick some row that doesn�ft exist so I say, �gHey, first row, you�fre array sub zero, what�fs your length?�h And it says, �gHey, I�fm 40 pixels across.�h And then you know what the width of the image is, too. Now once I have that here�fs the funky thing. I�fm gonna have this double four loop that you saw before when I was going through a grid, right, so I have some index [inaudible], I�fm gonna set my individual pixel value to be the element that of the array I sub J, so I�fm gonna pull out each one of these individual pixels and integers one at a time. And there are these three methods in the G that are provided for you, static methods of the G image class called get red, get blue, and get green, and they get the corresponding red, green and blue values that are encoded inside this single integer and they return them to you as integers.

So what you get are these little intensity values for the red, green and blue. And based on red, green and blue, there�fs these wonderful folks, the National TV Standards Consortium, something like that, NCSC, who said, �gHey, in order to go from a color to a black and white, you want to consider how luminous the image is,�h and luminosity depends on the color. So it�fs about .3 times the red, the greens a lot brighter so it�fs almost .6 times the green, and blue we consider really dark so it�fs about .1 times the blue. And these are just numbers that got pulled out of the air by this consortium, but that�fs how they determine what the luminosity or how bright something is relative to its color. Funky, but someone does it. And then we just round that value to an integer because we�fre returning an integer and that�fs what we return, and we say, �gHey, that�fs great. You gave me that luminosity, I�fm gonna set that same luminosity value for the RG and B images.�h If you set the RG and B values to all have the same value what you get is a grayscale because all the color blends out. And essentially you get something that varies from completely white to completely black depending on how intense you�fve given those RGB values, and I store that back in this array, and at the very end I�fm gonna create a new G image out of that array and return it. So let me just run this for you in our last minus two minutes together so you can actually see it. Anyone want to take a final guess as to what I am?

[Student:]Spock.

Very close. I�fm almost Spock. [Student:][Inaudible]

I�fm Mirror Spock. Yeah. Also known as evil Spock. And it�fs because the whole costume is all around the goatee because when my wife saw the goatee she�fs, like, �gYou�fre evil Spock,�h and so our son is actually Spock. So when we sit next to each other he�fs small Spock, he�fs about this big, and I�fm evil Spock. Yeah. It�fs so cute if you�fre kind of geeky like me. All right. So here�fs the original milkmaid image, and here�fs that same image when you created the grayscale of it. So just one last thing. If you shut the camera -- because now we�fre gonna get something to do if you actually want to see it --