Alrighty. Welcome back to yet another fun-filled exciting day of CS106a. So a couple quick announcements before we start -- first announcement, there are two handouts in the back. Hopefully, you already got them. If you didnft already get them, you can get them later. Second announcement, just a little reminder, microphones, if you go ahead and pick up those microphones right now and keep them in your lap. Theyfre warm. Theyfre cozy. Theyfre fun. Use them to ask questions. Just because, looking at the videos, got a, kind of, general reminder that the questions arenft actually coming through. Whoa, or I can just breath real heavily into my microphone. All right. So one real quick point before we dive into the main meat of the lecture, itfs just a clarification on something we did last time called The Cast. So remember last time where we had a cast, which was this thing that allowed us to say treat this one data point, or this one data item, this one variable as a different type for one particular operation. And so last time I told you you could actually do something like int X equals -- letfs say we had some double up here, like YY, and maybe Y got some value like 3.5, and I said you could do a cast like this, and we put Y here, right? And so thatfll take Y. Itfll truncate it, right? It drops everything out of the decimal point and assigns it to an int. And I, sort of, said, misspeaking, actually, that you could drop this part. It turns out that in Java, any time you do a cast of something, that loses information. Like, when you go from a double to an integer because it truncates, it drops everything after the decimal point, you have to put in the cast, so you have to make this explicit. If you go the other way around where youfre not losing information, like, if you were to have Y equals X at some point where you know that X is an int and Y is a double, youfre not gonna lose information by assigning an int to a double. So there youfre okay. You can do the explicit cast if you want, and actually I would encourage you, actually, to use the explicit cast, but in this case, you donft need it. In this case over here you actually do. So when you lose information, you need to make an explicit cast. For most of you, it probably wonft affect your day-to-day life, but thatfs just something you should know. Alrighty. So any questions about anything wefve done up to now? Wefre just gonna, kind of, press ahead with something that wefve talked about last time. Remember last time wefre talking about our friend the while loop? And the while loop was something that you used when you donft know how many times youfre gonna do something. This is what we refer to as an indefinite loop -- not an infinite loop, right? Itfs important that you have gdeh in there. Infinite loop keeps going forever, but an indefinite loop is one that when it starts out, you donft know how many times youfre gonna do something. Youfre just gonna do it some number of times. Well, it turns out therefs times in life where youfre gonna do something some number of times. You donft know how many, but you figure you probably want to do it at least once, okay? This was, kind of, the case of my brother going to college. Like, he figured, gIfm gonna go to college.h But when he got there, he didnft know how many degrees he was gonna get, and he just keep going and going, and five degrees later, he was, kind of, like, gOkay. I think Ifm done now.h So that was his while loop, right? He didnft know how many times, but he knew he wanted to do it at least once. Now, the interesting thing is that in programming, this actually happens fairly commonly. So Ifll show you a quick example of this. If we go over to the computer, therefs something we call the loop and a half because in some sense, you want to half of the loop at least once, okay? Think about it this way. Letfs say we want to take some program that reads in a bunch of numbers from the user until the user enters zero to stop, and it, kind of, computes the sum of all those numbers, so it adds them all together. So we might have, basically, some sentinel value, right? Wefre gonna use our constant, our little friend last time that we talked about, the constant, to define what is that value that the user enters in which point they want to stop entering values. This, is in programming speak, is often referred to as a sentinel. Itfs, kind of, the last thing Ifm gonna give you that tells you Ifm done; Ifm not gonna enter any more values. But until I give you that sentinel, Ifm gonna give you a bunch of values that I want you to add together, for example. So that sentinel we might define as a constant, and so we could have some loop that says well, if Ifm gonna keep track of some total or some sum of all the values you enter, that homefs gonna start at zero. Ifm gonna ask you for some value, so Ifm gonna read in some integer and store it in the little box named Val, right? So I just declare it a variable, and then Ifm gonna have a loop, and what my loop says is if the value you gave me is not the sentinel, that means you donft want to stop yet, right? So I have a logical condition in here thatfs checking against the constant, and thatfs a perfectly fine thing to do. So wefre taking a lot of those concepts you saw last time and just, kind of, sticking them all together into one bigger program. If I havenft seen that sentinel yet, then take the value you just gave me, and add it to my total, and store it back in the total using the little plus equals shorthand you saw last time, okay? Then what I need to do is after Ifve done this, I need to ask you for a value again. So I say value equals read it. Notice I already declared the value up here, right? I already declared this variable up here, and this guyfs lifetime is until it gets to the closing brace at the level at which itfs declared. Itfs not declared inside the while loop, so this closing brace doesnft make it go away. This closing brace makes it go away, which means itfs actually alive the whole time in the while loop, and itfs perfectly fine. So val, I read in some other value from the user, and, again, I go back through this loop. Did they give me zero? No, add it in. Did they give me, zero? No, add it in. And when they give me zero, then I say, oh, the value is equal to the sentinel, so this test becomes false, and I come down here, and I write out the total as total, and you might say, oh, okay, Mehran, thatfs fine. Whatfs wrong with that? Well, in computer science or actually in computer programming, we really hate duplicated code. If we can avoid duplicating code, even if itfs one line, we generally try to do it, and you can see therefs a duplication here, right? Whatfs happening is therefs something we want it to do at least once, which was to ask the user for some value, but we need to keep doing that over and over in the loop, even after that first time. So we, kind of, run into this conundrum where we say are we gonna have to repeat code? And therefs a way around this. So the way around this is we pop out that piece of code, and wefre gonna pop in our friend the loop and a half, okay? And so what the loop and a half says, the first thing that looks funky about it is we say while true, and you see that and you go, gOh, my God.h Right? Any time you see ewhile truef youfre thinking bad times, right? gIfm never gonna break out of the loop. Every time I come here and evaluate the condition, itfs always true. Isnft this an infinite loop, Mehran?h And it would be except for one caveat, and herefs the caveat. Wefre gonna ask the user for a value, right? Notice we declared the int val inside here. We couldfve declared it outside if we wanted to, as long as we didnft do the read into outside. We couldfve just said int val and declared it out here, but wefre only gonna use it inside the loop, so wefre just gonna declare it here. We read an integer from the user. We ask if the value is the sentinel. If it is, we break. What a break statement does is it will break you out of your closest encompassing loop. What does that mean? It means it finds whatever loop is the loop youfre currently in and jumps you out of just that loop. So if you hit a break statement, it will jump out to, essentially, the place right after the closing brace for that loop and keep executing. So what it allows you to do, essentially, is to check the condition to break out of the loop in the middle of a loop, which is, kind of, a funky thing, rather than at the very beginning or every time you iterate through. So we get the value from the user. If the value is the sentinel, we break, which means we never execute this line or the rest of the loop. We jump down here. If it is not the sentinel, then we add it to the total. While is true, so we execute the loop again and go and read another value from the user, right? So notice that this read int line is no longer repeated. We only do it once, but because of the structure of this, wefre always guaranteed that this portion of the loop up here is always executed at least once because we had a while true, and wefre checking the condition to break out of the loop in the middle, okay? Now, one caveat with that is in terms of programming style, itfs generally a bad time to have multiple of these kind of breaks inside a loop because it makes it very difficult for a programmer to figure out what condition has to be true to break out of the loop. If therefs only place you see a break, then therefs only one condition you need to check to break out of the loop. If you have multiple statements, the multiple if, you know, blah-blah-blah break in your loop, that means the programmer has to keep track of multiple possible places you couldfve broken out of the loop in their head, and that gets pretty dicey. So you generally want to avoid that when youfre doing it, okay? So any questions about the loop and a half? Uh huh. [Student:]Is it okay to redeclare a variable in a loop like that over and over again? Yeah, itfs fine to actually declare that variable inside the loop. You donft need to worry about, like, efficiency issues or anything like that. So let me show this to you in action in a larger program, right? So herefs that loop and a half in the context of an actual run method. It prints something on the screen. It says total to be equal to zero, and then it comes here, while true will always execute, right, because the conditionfs true. So it asks the user for some value. We enter one; one is not equal to the sentinel. So we add that to the total, and you can see here itfs keep track of value and total. Herefs just my two declared variables and the little boxes for them, and they get updated as I go along. So while itfs still true, I read another value. Letfs say the user gives me two. I add it to the total, which is now three, and I come back up here. Ifll go through this a couple more times, okay? User gives me zero. Now, notice when the user gave me zero here, I hit the break because my value is zero, and thatfs equal to the sentinel. So it says, hey, the if part is true, so do the break, and it immediately jumps out to the end of a loop. It did not do -- even though it [inaudible]. So I feel a little like Roger Daltrey when Ifm doing this. Anyone know Roger Daltrey, lead singer of The Who? Go look it up on Wikipedia, and watch the video. Man, Ifm feeling old. All right. And then it says the total is, so this total plus equals value. The value just doesnft get added that last time, even though it wouldfve been a zero and wouldnft affect the things. It would be different, right, if we said the sentinel equaled a negative one. Then you would actually see that the total didnft get one subtracted from it, and we couldfve set the sentinel to whatever we wanted, but in this case, we used zero, okay? So thatfs our little funkiness, and it writes out the total of zero for actually doing the loop and a half. Now, in terms of doing all this stuff, okay, you might think, gWell, hey, Mehran, you showed me about the for loop last time. You showed me about the while loop. It turns out I can write the same loop in equivalent ways using both of them.h So you remember the for has the initialization, the test, and the step initialization happens once. Then the test happens every time through the loop, and then the step happens, kind of, every time at the end of the loop? That would be exactly equivalent if I wrote it like this. The int happens once before the loop. I have some while loop that checks the same test. I have the same set of statements that would be in the for loop body, and I do the equivalent of the step in the for loop at the very end of the loop. So these two forms are exactly equivalent to each other, and you might say, gHey, Mehran, if theyfre exactly equivalent to each other, why do I have these two loops, and when do I use one versus the other?h Well, for loops, you want to think about what we refer to as Definite Iteration. That means we generally know how many times we want to do something, and that number of times we want to do something is how we, sort of, count in our test. When we donft know how many times we actually want to do something, thatfs an indefinite loop, or indefinite iteration as I just talked about, thatfs when we use a while loop, when we generally donft know how many times wefre gonna do something, okay? So that, kind of, why we give you both forms, and most programming languages actually have both forms, but to a programmer, itfs more clear between seeing the difference between for and a while, itfs, kind of, the meaning of it, right? Are you counting up to something some number of times, or are you just gonna do something until some condition is true? Thatfs, kind of, the differentiator there. So any questions about loops? So letfs put this all together in the context of a bigger program, okay? So I will show you a bigger program here. So wefll come over here. Herefs a little program; let me just run it for you real quickly. Come on. So we run along, and what this programfs gonna do is draw a checkerboard, right? Just like youfre used to in the game of checkers or chess, a little checkerboard on the screen. So this is gonna be a graphics program. Itfs gonna draw a bunch of G rects, which are just rectangles -- in this case, theyfre gonna be squares, to draw a little checkerboard, and you should think, gHuh, this might have some similarities to, maybe, some of the stuff you were doing in your current assignment. Yeah, so letfs go through this code and see whatfs actually going on, and we can put a bunch of things we learned together like constants, and loops, and blah-blah-blah. So whatfs going on over here is, first of all, we start off with a couple constants, right? And the constants wefre gonna have tell us how many rows and columns are gonna be in our checkerboard. We want to draw a standard checkerboard, which is an 8x8 checkerboard. So we have private static final int, end rows is eight, and private static final int, end columns is also eight. Notice that these two constants are not defined inside a method. Theyfre defined inside the class but not inside a particular method, which is generally where your constants are gonna be defined, right, in a class but not inside a particular method, and then for the run part of the program, first thing we need to know is we need to figure out -- because we want this thing to be general, right? No matter how big our window is, we want to draw a nice little checkerboard. So we need to figure out how big do those squares on the checkerboard need to actually be so they appropriately fill up the screen. How do we do that? We get the height of the graphics window -- remember our little friend, the method Get Height, which tells us how many pixels high the graphics window is, and we divide that by the number of rows. Since we divide that by the number of rows, this is gonna give us integer division, right? This is gonna give us back an integer, and wefre gonna assign that to square size, which is an integer. So everythingfs perfectly fine because this is some number of pixels. This is an integer, and so this is an integer value divided by an integer value gives you an integer division. So that tells you basically how many squares can you fit in, sort of, the height of the screen, and thatfs gonna be the size of one of the sides of our squares, and, as you know, squares have the same size on both sides, same length on both sides, so wefre perfectly fine. Now, what wefre gonna do here is, right, we want to get the structure thatfs like a grid. In order to get a grid, wefre gonna have what we refer to as a pair of Nested Loops. All that means is one loop is inside the other loop, okay? So we have two for loops here, and you can see with the indenting, one is, kind of, nested inside the other one. So one is gonna count through the number of rows. So wefre gonna have one loop thatfs gonna go through the number of rows we want to display and another loop that, within each row, is going to, essentially, count the number of columns in that row because wefre gonna put one box for every little square grid on there, which means for every row, we need to do something for every column in that row. So wefre gonna have one for loop thatfs going to have I as what we refer to as its index variable. So remember when we talked about for loops, and we talked about counting, we said, gOh, yeah, you say something like int I equals zero I less the num rows.h And thatfll count it from zero up to num rows minus one, which that iterates num rows times or N rows times. Thatfs great. The only problem is this variable I, remember, is alive until it gets to the closing brace that matches this brace, which means that I is alive all the way to down here. Well, if that I is alive all the way to down here, if we have some other for loop in the middle, if itfs also using I, those Ifs are gonna clash with each other, and thatfs bad times. So what do we do? We just use a different variable name. What wefre gonna do is whatfs the next letter after I? J, right, so I, J, K youfll see are very popular names for loops, and those are the one place where descriptive names -- you donft need to have some big name like, gOh, this is the Counter Through Rows variable,h or something like that. I and J are perfectly fine because most programmers are used to I, J, K as the names for control variables, or index variables, and loops is how we refer to it because this is what the loop is using to count through, so we think of I as the loop index. So we have one here for J, and notice all the places I wouldfve had I are now just replaced by J. So J gets initialized to zero. We count up to N columns, and J plus plus is how we increment J. So a common error with nested loops is you have the same variable up here as you had down here, and thatfs generally bad times, okay? Now, once wefre counting through all the columns, the thing we need to figure out is where is this square that wefre gonna draw gonna go? Whatfs its XY location? Well, itfs XY location says, well, first of all, if you want to figure out its X, thatfs, sort of, going horizontally across the screen, right? Going horizontally across the screen depends on which column youfre currently in. So I take J, which is the index variable for this loop over the number of columns here, and I multiply it by my square size. What Ifm essentially saying is move over in the X direction J many squares. That will tell you where the X location is for the next square of the tracks youfre gonna write out. Similarly, Y, which is the vertical direction, I need to figure out which row Ifm in. Well, I is whatfs indexing my rows, right? So Ifm just gonna take I and multiply it by the square size. That tells me how far down the screen I need to go to get the Y location for this square. So now I have the X and Y location. Any questions about how I computed the X and Y location? Donft be shy. All right. Are you feeling good about X and Y? If you are, nod your head. All right. Ifm seeing some nods in there, some blank stares. If you have no idea what Ifm talking about, nod your head. All right. Thatfs better. Therefs always this indefinite ground where itfs, sort of, like, no one nods, and they donft give you any feedback. So Ifm begging you for feedback, all right? [Student:][Off mic]. We couldfve put this outside of the J loop and just computed -- or we couldfve put the Y location outside of here and just computed it once because that Y location will remain the same for the whole row. So that wouldfve been an interesting little optimization we couldfve made, but we didnft make it here because I just wanted to compute X and Y together so you would see them computed together, and because our forms are pretty similar to each other, okay? So once I know the X and Y location for that square, I need to say, hey, get me a new square at that location. So I say new G rec. That gets me one of these new square objects. Where is the upper left-hand corner for that square? Itfs at the XY location I just computed. How big is the square? Square size width and square size height, right, because itfs a square; itfs got the same width and height. So that gives me a new square. Now, I gotta square at some location that I want to display that square out, right, because I computed the right X and Y. The only problem is at the checkerboard. Some of the squares are filled; some are not filled. How do I figure out which squares should be filled? This is where I do a little bit of math and a little bit of Boolean logic, and it just makes your life, kind of, beautiful. So rather than having a whole bunch of ifs in there and trying to figure out, oh, am I on an odd square, an even square, which row am I in, blah-blah-blah? You do a little bit of math, and you figure out your math, and you say, hey, you know what, that very first square that I draw in the upper-right-hand corner, okay, let me see if I can bring that little square back up again. So Ifll run this one more time. This guy up here, I can think of that square all the way up there as the 00 square. That guyfs not filled, but if I were to move one over that is filled, or if I were to move one down that is filled -- so if I think about the index location that Ifm currently at, and I take my X and Y coordinates, or I should say my I and J variables because thatfs what indexing my rows, and my columns and add them together, if that puppyfs even, then itfs not a filled square. If itfs odd, then it is a filled square because the very first one is 00. That onefs not filled, so evenfs not filled, but if I move one in either direction, I get something that should be filled. If I move two in either direction, I get something that should not be filled, et cetera. So the way that translates into logic for the code is I come over here, and it looks a little hairier than it actually is, but I say take the I and J, and add them together, and mod it by -- or I should say -- remainder it by two, right? If I remainder by two, if that remainder is zero, that means itfs even. If the remainder is one, that means it has to be odd. The remainder canft be anything other than zero or one when Ifm taking the remainder and dividing by two. So if that remainder is not equal to zero, that means itfs an odd square, right, because my remainder divided by two is not equal to zero; it means it was equal to one. What Ifm gonna do in that case is Ifm gonna set filled. So this looks very funky. You might be inclined to think, hey, shouldnft you have an if statement here, and say if this thing is true, then set filled? Well, think about, right, if this thing is true, set filled will become true, and Ifll get a filled square. If this thing is false, set filled will become false, and Ifll get an unfilled square. So it works for me the way I want it to work in both cases, so rather than worrying about all this controlled logic for an if statement or all this other stuff, I just take my condition here, which is this big honking Boolean expression that evaluates the true or false and just stick it in for the value for -- that set filled is actually expected, okay? And this will give me the alternating effect for squares, and when I finally do this, I need to say, hey, you know, I got that square. Itfs filled the way I want it to be filled. I know its location. Throw it up on the canvas for me, so I add it. And then I just keep doing this over and over, and I get all of my -- for every row, Ifll get a line of squares across and all the columns. Then Ifll come down to the next row, and Ifll just keep doing this until I get eight rows of squares. Uh huh? [Student:][Off mic]. Use a mic, please. Thatfd be great. Thanks. [Student:]How do you designate is as a Boolean expression? Does it just automatically assume that is going to be true or false, or -- Right. So thatfs a good question. The key thatfs going on here is this little operator right here, the not equal operator, right? The not equal operator is a logical operator, which means itfs gonna have two arguments that it works on, and what itfs gonna give you back is true or false. So the way it knows that itfs Boolean is that this particular operator, the not equal operator, always gives you back a Boolean value, right? Just like greater than or less than, all those operators are Boolean operators; they give you back a Boolean value. Whereas, the stuff Ifm doing over here, right, is just math. This is giving me back an integer, and Ifm comparing that integer with another integer using a Boolean operation. Thatfs why I get a Boolean. Uh huh? [Student:][Off mic]. Does this only -- well, this will work in any case as long as the window is wider than it is tall because the way we compute the squares is based on the height as opposed to the width. Uh huh? [Student:][Off mic]. No, thatfs different, and wefll get into that now. Well, the private partfs the same, but Ifll show you what all of those things mean in just a second. So wefre gonna do methods in just a second, and then itfll become clear. Uh huh? [Student:][Off mic]. Because everythingfs in terms of pixels, and the pixels are always integers. So we just want to compute in terms of integers because all of our values mean our integer values. So let me push on just a little bit. Uh huh, question right there? [Student:]Why are we doing it this way if wefre supposed to be doing top-down programming; is it the opposite? Well, in this case, top-down programming is how you break things up into smaller functions, right? Here we only have one function. So we could actually think about, gOh, should I do one row at a time?h And that would actually be an interesting decomposition is to have a function or some method that does one row for you, and I iterate that some number of times, and the reason why we didnft do it that way is we havenft done methods in Java yet, which is the next topic wefre gonna get into. So thank you for the segue. So the next topic wefre actually gonna deal with is our friend the method, but in the Java world. So hopefully youfve already seen in Carroll, right? You saw how to break things down in Carroll, and we did decomposition in Carroll, and now itfs time to bring that into the Java world, okay? So when we think about methods in Java -- you already saw a couple of these things, right? Like, read ints, for example, is some method that youfve seen, and so we might say, you know, int X equals read int, or print lin is some other method youfve seen, right, that just prints out a line. Now, one way we can take these notions and make them a little bit more familiar is, first of all, we can say the idea of a method is just like in Carroll. You want to use methods to be able to break down programs into smaller pieces that you can reuse; thatfs critical. But, in Java, they get a little bit more complicated, and herefs where the complexity comes in, and itfs easiest to draw the notion of how they differ in the Java world by thinking about mathematical functions, right? So somewhere, someday, which youfre never gonna have to worry about again as long this class is concerned, is you learned about this thing called the sign function. Youfre like, gOh, Mehran, you told me there was gonna be, like, no, like, calculus in here.h Yeah, donft worry. This is just for this example, and then the sign function goes away. You never have to worry about it again, at least for this class, right? But the way the sign function worked is it took some value that you computed the sign of, right? So there was something here like X that you took the sign of, and what you got back from the sign function was some value that was essentially the sign of X. So you not only had something that we called a parameter that was what that function was expecting in terms of information going in, you also got some information coming out, which is what the value of that function returned to you or gave back to you, okay? Thatfs the one bit of additional complexity that comes up with methods in the Java world as opposed to the Carroll world, and the Carroll world, you didnft have any parameters that went in, and no values came out. In Javafs world, you do, okay? So, first of all, just to wrap up on the little math example, a couple people asked last time about some mathy functions, and it turns out that therefs this thing you import called Java.lang.math. Theyfre a bunch of mathematical functions you get in the Java world for free, and some of those are, for example, oh, a function you might be using on this next assignment like square root. So if we have double, letfs say Y -- or Ifll say XX, XX equals 9.5, and then I might have some other YY here, and I want Y to be the square root of 9.5. I would say math.sqrt, which is the name of the method for square root, and then I give it the value, or I give it a variable whose value I want to compute the square root of. So this guy takes in something of type double, computes the square root, and gives you back that value that you can now just assign to some other double, for example, okay? And there are some other ones in there. Therefs a power function. Someone asked about power last time. Thatfs where you also get the function; itfs also in there, but power gives you a nice example of you can have multiple parameters. So power you actually give it an X and a Y, and what it does is computes X to the Y power. So itfs essentially computing something that would look like that if we were to write it out in math-ese, and it gives you back that as a double. So we could assign that somewhere else. But notice we have two parameters here, and theyfre separated by a comma, okay? And thatfs, generally, what wefre gonna use to separate parameters is commas, just like you saw when we created, for example, objects over here, right? We created a new G rect, and we had to give it four parameters. They were just separated by commas, same kind of idea going on over here. Now, the question comes up, whatfs the whole point of having these kind of functions exist in the Java world or methods in general? And the critical part about methods in Java, therefs the whole notion of decomposition and top-down design. Thatfs part of it. Thatfs not the most critical part. The most critical part has to do with a notion we think of as information hiding, okay? So what is information hiding all about? The real idea -- the way you can think about this is that everything in the world is a function or some method. So, for example, anyone know what this is? [Student:]CD player. CD player, youfre like, gMehran, a CD player, come on. Youfve gotta be kidding. Like, what, were you, like, on some 1990s archeological dig or something?h Itfs like, oh, okay. I think Ifve found the CD player. This is a CD player, right? Itfs also a method. What does that mean that itfs a method? Well, guess what? It takes something in, and the thing it takes in happens to be CDs, and we have a little CD, Alice in Chains, always a good call, Apocalyptica. Any Apocalyptica fans in here? Yeah, a few, itfs Metallica done on the cello, and Tracy Chapman just to date myself. But what do you do? You take a CD. You put inside here. You hit close, and you hit play, and out comes music, and the music that comes out of this thing depends on which CD you put in, but the interesting thing about it, if you think about it, is all of the electronics in here are completely reusable, right? I can use this CD player on, virtually, any CD, right? Someday we might get to the day where you go to the store, and you buy a CD, and all the electronics to actually play the CD are inside the box, and you just plug your headphones into this, and you just listen to your CDs, and then we toss away those electronics when we get rid of that CD, and we get a copy of all the electronics again. That would be a huge waste, right, if you kind of think about landfill space and all that stuff. So why donft they do that? Why donft all the electronics to listen to a CD come with the CD? Because I can create them once and generalize them in a way so that if I pass in the right parameter, which is the CD, I can use the same thing over and over for all different kinds of values that go in, and, as a result, produce all kinds of values coming out, okay? So thatfs the thing you want to think about in terms of methods is you want to think about methods and defining whatfs gonna go into them and whatfs gonna come out of them in a way thatfs general enough that they can be used over and over again, and thatfs what the whole beauty of software engineering about is thinking about that generality, okay? So with that said, how do we actually define a method, okay? So we need a little bit of terminology to think about how we define methods. Yeah, itfs time for that dreaded terminology again in the object-oriented world, okay? So when we actually call a method, right, youfve seen this a little bit, just like we did over there. We have what we refer to as the receiver, the name of the method, and then some arguments, which are the parameters, right? So here the receiver happens to be math. The method name is power, and then therefs some arguments X and Y that get passed in, okay? The way we think about this thing is we say that we are calling or invoking a particular method; here is the name of that method. So a lot of times youfll hear me say, gCall the method.h Thatfs what wefre referring to is invoking that method. What we passed in terms of these arguments is the parameters, what that function is actually or that method is actually expecting, and youfll hear me sometimes use the terms function and method interchangeably, and they basically mean the same thing. And this guy can, potentially, give me back some value, just like square root and power did over there. Now, sometimes we also refer to this, and you may have heard me say this in the Carroll world, right, as sending a message to an object, right? So if we have our friend the G label, and I declare, letfs say, Ifll just call this lab to make it short, which is short for label, and I ask for a new G label, and that G label, Ifm just gonna give it the words high at location 10, 10 just to keep it short and fit it on the board, and then I set its color by saying label -- or in this case just lab.set color is color.red, okay? So when Ifve done that, lab is the receiver. The method name is called Set Color, and, alternatively, I would say that Ifm sending the set color message to lab, okay? Thatfs just the terminology that we use. You should just be aware of it. So set color is the message that wefre sending, okay? Thatfs the receiver of the message, same kind of thing as the name of the method and the receiver of that method, or making a method called or a method invocation; those names just get used interchangeably. So how do I actually create a method in Java, okay? Let me show you the syntax for creating a method. Itfs a little bit different, just slightly different than Carroll, but actually very similar, and so the way this looks is I first specify the visibility. Youfre like, gHuh? What is that?h Youfll see in just a second. So we have the visibility, the type that the method may potentially return, what value it may return, the name of the method, all these have squiggly lines under them because these are things that you will fill in momentarily, and some parameters that get sent to that method, and inside here is the body, which is just a set of statements that would get executed as part of that method. Now, what do all these things mean? First of all, letfs start with the visibility, which Ifll just abbreviate as vis. The visibility, at least as far as you need to know right now, is either private or public, and youfre like, gHey, yeah, I remember those from the Carroll world.h Yeah, and theyfre exactly the same. The way you want to think about it is right now all you need to worry about is your run method is public, and, pretty much, all the other methods you write, as long as that method is only used in a single class, which is generally the class that you are writing that method in, they will be private. So, for all intensive purposes right now, all the methods that youfre gonna write, except for run, are all gonna be private, and run has to be public. Uh huh? [Student:][Off mic]. The way things are set up, you just need to make run public because it needs to have a larger visibility the way wefve, kind of, defined the CS106 stuff right now. At the very end of class, like, when we get to the end of the quarter, Ifll, sort of, lift the covers on everything, and youfll see why, okay? So thatfs the visibility, private or public. Run is public, most other things are private. All private means in terms of visibility is the only people who get to see this method are other methods inside the class that youfre defining, okay? So thatfs why itfs visibility. Itfs who else can see it, okay? The other thing you want to think about is the type. Whatfs the type? The type here is specifying what gets returned by this method. So remember we talked about some methods, for example, that give you back something, okay? It is the type of the return value. What does that mean? If I have some function thatfs going to compute the sign of something, and you give me a double, and itfs gonna give you back a double, itfs return type is double, and you might say, gHey, but, Mehran, when I was doing methods with Carroll, none of my Carroll methods actually returned any values.h Right? Yeah, that was perfectly fine, and guess what word you used when they didnft return a value? [Student:]Void. Void, yeah, thatfs a social. Good times all around, right? So void is a special type, which basically just means Ifm not gonna return anything, right? So its return type is void. Itfs like youfre sinking into the void. Youfre getting nothing from me. You know, itfs, kind of, standoffish, but thatfs what it means is Ifm not giving you back a value. You need to know that Ifm not gonna give you back a value, so I still specify a return type as void. Then the name, you know about the name, right? That can be any valid name for a method just like we talked about in Carroll, and therefs some parameters. The parameters are information we pass into this method that it may potentially do some computation on. So Ifll show you an example of that in just a second, and what parameters actually are, and how we set them up, okay? Some functions may actually have no parameters, like the functions you wrote in Carroll, right? There was no information that got passed into those functions, in which case, the parameter list was empty, and all you had was open parens, close parens, which means therefs no parameters for this function. When you call it, you just say the name of the function and open paren, close paren, okay? So, with that said, let me show you one more thing and then some examples. So youfve seen a whole bunch of syntax so far of while loops, for loops, variables, declarations, all this happy stuff, and now I tell you, gHey, there are these methods, and this is, kind of, how you write a method.h And youfre like, gYeah, that has a lot of similarities to Carroll.h But therefs this value that youfre returning. How do I return the value? Well, surprisingly enough, you use something called the return statement, which just says return, and then after return whatfs over here is some expression which just could be some mathematical logical expression, and when you get to a return statement somewhere inside a method, that method stops immediately. It does not complete the end of the method, and immediately returns whatever the value of expression is. A lot of times, the return will come at the end of a method, but it need not come at the end. Your method, at the point that itfs currently executing, will stop and return with that value that is expression as soon as you hit it, okay? So thatfs, kind of, a whole mouthful of stuff. What does this actually mean? Let me just show you a bunch of examples, and hopefully this will make it a little more clear. We want some methods; give me methods. So herefs an example of a simple method. This is a method that converts feet to inches, right? Itfs, kind of, like, gOh, Mehran, yeah, this is, you know, yet again, an entirely useless thing for you $2,000.00 computer to do.h But it shows you a simple example of all the pieces you need to know to write a method. Whatfs the visibility of this method? Itfs private. Itfs only gonna be used inside this class. What type is this feet to inches thing gonna give back to me? Itfs gonna give me back something that is of type double. The name of the function is Feet to Inches. What parameters does this function take? It takes in one parameter. The type of that parameter is a double, so what Ifm expecting from you is something to double. It could actually be an explicit value thatfs a double. It could be a variable that holds a double U inside it, but thatfs what Ifm expecting is a double, and the way Ifm going to refer to the double that you give me in this function is with the name Feet. So all parameters have a type and a name, and the name is the name youfre gonna use inside this method to refer to that parameter. So what do I do? You give me some number of feet as a double; I multiply it by 12, and thatfs what Ifm gonna return to you. So when I get to this return statement, the method is immediately done, and it returns the value over here in the expression. Often times, youfre not required to, but I like to parenthesize my expressions to make sure itfs clear whatfs actually being returned. So let me show you another example. Wefll just go through a bunch of them. Uh huh? [Student:]Is it common to not put a comma as a separator for the type and then the name of the [inaudible] -- Well, the type and the name come together, so there is no comma there. Let me show you another example that actually has more than one parameter, okay? Wefll get to that right now. So here is a function thatfs the maximum function, right? Again, itfs private. Itfs gonna return an integer because youfre gonna give it two integers, and itfs gonna return to you whichever one has the larger value. So itfs name is Max. Itfs going to return an integer, and what itfs gonna take is two arguments here, two parameters. Well, the first parameter, val one is an integer, and val two is also an integer. So the way I specify them is always they come in pairs, type and the name that I used to specify -- type and the name I used to specify it, right? So val one and val two are both integers. What do I do inside here? I just have an if-val statement. If val one is greater than val two, then val one is the max. So right here Ifm gonna return val one. As soon as I hit that return, Ifm done with the method. I donft go do anything else, even though there was only an else that I wouldnft have done anyway, I return val one. If val one is not greater than val two, then I return val two because val two needs to be at least greater than or equal to val one, so itfs the maximal value, okay? So, again, if you have multiple -- you can have as many parameters as you want, sort of, within reason, right? And within reason I mean, like, sort of, a few thousand. You can have as many parameters as you want, and thatfs a lot of typing. They get separated by commas and they come in pairs, value and the name that you use to refer to it. Uh huh? [Student:][Off mic]. No, it will not print anything on the screen. All this will do is return that value to whichever place invoked this method. So if you think about something like read ints, right? Read ints gives you back a value, but it doesnft actually, I mean, that value happens to show up because these are typed it on the screen, but it wouldnft have printed it out otherwise, right? This doesnft print anything out; it just returns it back to where you, sort of, invoked this method from. Uh huh? [Student:][Off mic]. There is, and wefll get to it in about three weeks. [Student:][Off mic]. Yeah. So herefs another one. This is something we refer to as a predicate method, and a predicate method is just our fancy, computer sciency term for a method that returns a Boolean, right? A method can return any type you want. This one happens to return a Boolean. Private Boolean is odd. What does this do? You give it an integer; it tells you back true or false. Is it odd, right? The name is pretty self-explanatory. So it takes that variable, computes the remainder after we divide by two, and if that remainder is equal equal to one, this whole thing is gonna be true, and itfll return true. If itfs not equal equal to one, that means itfs equal equal to zero. In that case, this is false, and itfll return false. So this whole expression here again because we have an equal equal, which is a logical operation, right, thatfs gonna give us something back thatfs true or false, and thatfs what wefre gonna directly return to the person who called this function, okay? So any questions about that? Alrighty. So letfs look at something in a slightly larger context, right? Letfs put this all together in a full program so you can get a notion of defining the class, and defining the methods in it, and you can, sort of, see the whole thing as we build it up. So here is something called the Factorial Example Program, and it just extends the console program, and all this puppyfs gonna do is basically compute some factorials from zero up to max num. So we have some constant here, which is the maximum number we want to compute factorials up to, and if you remember -- letfs take a slight, little digression to talk about factorials. So if you remember in your math class in the days of yore, there was this thing that looked like this, all right? And you saw it and you went, gOh, Itfs n!, right?h I hopefully caught your attention. This was actually n factorial, right? Yeah, the explanation point -- totally different now because a couple people were, like, sleeping, and gWhat? What was he talking about?h N factorial, and all n factorial is is multiplying all the numbers from one up to n!, okay? So five factorials, strangely enough, is just 1 x 2 x 3 x 4 x 5, and one factorial is just one, and here is the bonus question; whatfs zero factorial? [Student:]One. Oh, I love it. It just warms the [inaudible] of my heart. Yeah, itfs one, and there are some people who ask, gBut zero, you know, like, I, uh -- h and they get all wound up tight, and theyfre like, gNo, man, mathematicians just said it was.h Because if you think about it, itfs multiplying -- itfs starting with one and multiplying zero additional terms, right? So Ifm left with one. Itfs a good time. So how do I actually compute that? Well, in my program Ifm gonna have some run method thatfs going to count from zero up to max num and write out all the factorials. Itfll say zero factorials this, one factorials this, two factorials this, by calling a method called Factorial passing in the value of the thing I want to compute the factorial of. How do I compute the factorial? Well, I just add some method. This probably is gonna return an int. Itfs name is factorial. Itfs gonna take an n! of the thing I want to compute the factorial of, and how do I do that? Well, I start off with some result thatfs value is one, and Ifm gonna have a for loop thatfs gonna count -- herefs one of the few times as computer scientists we donft count starting from zero; we actually count starting from one because it makes a difference. Wefre gonna count from one up to and including n!. Thatfs why this is less than or equal rather than just less than. So from one up to and including n!, so therefs still n! terms Ifm gonna count through. What am I gonna do? Ifm gonna take my results as Ifm going along and times equals it by I, which means the first time I multiply by one, store it back to result, then by two, then three, then four, all the way up whatever this n! value was, and when Ifm done doing this loop, I return to my result, which is my factorial, okay? Any questions about the factorial method by itself? Now, one thing that comes up, freaks people out a little bit, donft get freaked out; itfs okay. You see an I here, and you see an I there, and youfre like, gOh, we just did that thing with nested loops, Mehran, where you told me that if one thing is inside another loop, like, I shouldnft use the same name. So why are you using the same name here?h And the reason why Ifm using the same name is to make a little bit of an example, which is that the I here and the I here are different Ifs, okay? When you think about a particular method, a method can declare its own variable. So this result, its lifetime or its scope, is until we reach the end of the method down here. This guy lives inside this method. This I is an I that only lives inside the factorial method. It doesnft interact at all with the I outside here. So every method, and the interesting thing here is run is just another method. It just happens to be the special method that we always start executing from, but every method can have itfs own declared variables, and this I here is just its own declarative version of I. It has nothing to do with the I up there, okay? Question? [Student:]Okay, so is it possible to, like, give a variable from one method to the other method? Wefll talk about that in just a bit. So someone was wondering is there a way I can, sort of, give some variable from over here down to over here? And Ifll show you how you have to, kind of, think about that in just a little bit, okay? But any questions about this notion of the same I, that this I is actually a different I than that I. When you declare a variable in the method, you are getting your own version of that variable in the method. It has nothing to do with the same named variable in any other method, okay? Kind of, a funky thing. Uh huh? [Student:][Off mic]. Thatfs just starting off the factorial, right? So if someone gives this five, we need to start off by saying we have some initial result, and then wefre gonna multiply that by one, and then wefre gonna multiply that by two. If we didnft have some initial thing we started multiplying, there wouldfve been some unknown value there, and actually Java wouldfve given us an error because it doesnft allow you to use uninitialized variables, okay? So this is, kind of, a funky thing, but important to, sort of, think about. There is a method in the context of a larger program. Variables within methods are not the same as the same named variable in another method. Thatfs the key take home thing, like, know it, learn it, love it, tattoo it backward on your forehead so every day when you look in the mirror when you take a shower, you see it, and you just know because thatfs one thing that trips people up. Uh huh? Was there a question up here? [Student:]So when you return result, does it get mapped into I? Is that why [inaudible] -- Ah, good question, so when I return here, whatfs actually going on? When I actually could say Ifm gonna compute the factorial of five, okay? This guy comes here -- letfs make it easy. Letfs have him computing a factorial of two. So it multiplies one by one, then it multiplies it by two. I get two. It returns this two. What happens to the two? That two goes back to the place at which this function was called. Where was that? That was up here. So this place up here where I said, hey, two plus your explanation point equals is what I would print on the screen. If I was equal to two here, right, two exclamation equals, and then whatfs the value that I get back when I call factorial of two? Well, it computes factorial of two. It happens to be the value of two. It just sticks in a two for whatever you had as the calling method, okay? So you can think of when you call a particular method, the name of that method, think of it as getting replaced by the result that gets returned from that method, okay? So if I run this program, just to make it clear, let me show it to you in its full glory over here. Herefs a factorial example. Ifll go ahead and run it, and you can see what its output is. Factorial example, wefll run it, and there it is, right? So it says -- if you can see up there, a zero factorial equals one because it writes out zero factorial, right, in the code over here. It would write out I has the value zero the first time through. So it writes out zero factorial equals, and then it calls factorial on zero, and what it gets back from factorial of zero is one. So that one is just what gets displayed in the place of factorial zero because that value I get back from factorial zero is whatfs actually used here, and it keeps doing that all the way through the loop, right? So down here it calls a factorial of nine, gets the value for factorial of nine, and returns that to the place where itfs actually gonna print it out, okay? So let me show you one more quick thing. Okay. Which is returning an object from a function, okay? So it turns out, interestingly enough, you can not only return, like, ints, and doubles, and Booleans from functions, you can also return whole objects. So here is a method called Filled Circle, and what Ifm gonna give to this method is some X and Y location for the center of the circle. Notice thatfs different than what G Oval Expecting to the upper left-hand corner. Ifm gonna specify an X, Y location which is the center of the circle, a radius for that circle, and a color, and what I want this method to give back to me is an actual object that is a circle whose center is that XY. It has the given radius R, and itfs filled in of that particular color. Well, how do I do that? Inside here, I say, hey, Ifm gonna create a new object thatfs of type G Oval, and Ifm gonna call it Circle, and Ifm going to get a new oval, right, and remember oval expecting the upper left-hand coordinate for the oval. I want the circle centered at XY, so what do I do? I take that XY, and I subtract the radius from the X direction and the Y direction, which gives me the upper left-hand corner for the bounding box for that circle, and then I say give me something that has a width of two times the radius and a height of two times the radius because thatfs what defines that circle, right? The diameter is two times the radius in both the height and the width direction. So I get that oval. Ifve now called this Circle because itfs my new object. I tell that circle to be filled because thatfs what I want to return is a filled circle. I tell that circle to set its color to be whatever color was passed in here. Notice the K sensitivity. Color with a capital gCh is a type. Color with a lowercase gch is actually the name of the parameter that Ifm gonna refer to, and thatfs what I use here is lower case gc.h So I set the color of the circle to be whatever color was passed in, and then I return this object. So that whole big box that contains this object that is some filled-in circle at that location, I say, hey, you, this is what you wanted because Ifm giving you back a G oval. Here you go, and I give you back the whole thing, which means when you invoke this method, you better take the result and assign it to someplace thatfs a G oval, otherwise -- or just add it to your canvas. You need to do something with it that you would normally do with a G oval, and you canft assign it to an int because an int and a G oval arenft compatible. Uh huh, question? [Student:][Off mic]. Okay, yeah, you canft assign it to an int; you have to assign it to an object of the same type. Uh huh, question back there? [Student:]Why are X and Y set to doubles if the pixels are all whole numbers? Ah, good question, so I couldfve actually made this with int and I probably should have made it with int, so it was my bad. Uh huh? [Student:]In the red method, how would you add that oval? Like, whatfs this, like, syntax? So the way you could think of it -- let me just write it for you up here. So if I actually had the run method, so Ifll blank, void, run, and then letfs say I had this function filled circle, right? So I called the method Filled Circle, and letfs just say I want to put this at location 10, 10, and its radius is two and the color that I want to give it is red, okay? Now, the thing that this gives me back is a G oval object. Therefs a couple things I could do with it. I could declare a G oval out here, call this O, and assigned filled circle to it, and now I have the object O out here, which is actually that circle that this method gave back to me, and I can do whatever I want with it. Like, I could say add O, and it would add it to my canvas. Alternatively, if I really wanted to, I wouldnft even need to set filled circle to some object that I want to keep track of out here. Ifm just gonna say, hey, youfre gonna give me a circle, Ifm gonna add it directly to my canvas. So anything that I would be able to do in my run method with a regular G oval is the same thing I can do with this G oval thatfs coming back from a method because itfs just giving me back a G oval, and I can use it in the same way. Alrighty? I will see you on Wednesday then. Wefll talk a little bit more about functions and methods then.