root 8 роки тому
джерело
коміт
2bf907924d
3 змінених файлів з 587 додано та 587 видалено
  1. 286
    0
      README-en.md
  2. 299
    0
      README-es.md
  3. 2
    587
      README.md

+ 286
- 0
README-en.md Переглянути файл

@@ -0,0 +1,286 @@
1
+
2
+# Using functions in C++ - DVD Info
3
+
4
+
5
+![main1.png](images/main1.png)
6
+![main2.png](images/main2.png)
7
+![main3.png](images/main3.png)
8
+
9
+
10
+A good way to organize and structure computer programs is dividing them into smaller parts using functions. Each function carries out a specific task of the problem that we are solving.
11
+
12
+You've seen that all programs written in C++ must contain the `main` function where the program begins. You've probably already used functions such as `pow`, `sin`, `cos`, or `sqrt` from the `cmath` library. Since in almost all of the upcoming lab activities you will continue using pre-defined functions, you need to understand how to work with them. In future exercises  you will learn how to design and validate functions. In this laboratory experience you will search and display information contained in a DVD data base to practice declaring simple functions and invoking pre-defined functions.
13
+
14
+
15
+##Objectives:
16
+
17
+1. Identify the parts of a function: return type, name, list of parameters, and body. 
18
+2. Invoke pre-defined functions by passing arguments by value ("pass by value"), and by reference ("pass by reference"). 
19
+3. Implement a simple function that utilizes parameters by reference.
20
+
21
+
22
+##Pre-Lab:
23
+
24
+Before you get to the laboratory you should have:
25
+
26
+1. Reviewed the following concepts:
27
+
28
+    a. the basic elements of a function definition in C++
29
+
30
+    b. how to invoke functions in C++
31
+
32
+    c. the difference between parameters that are passed by value and by reference
33
+
34
+    d. how to return the result of a function.
35
+
36
+2. Studied the concepts and instructions for the laboratory session.
37
+
38
+3. Taken the Pre-Lab quiz that can be found in Moodle.
39
+
40
+---
41
+
42
+---
43
+
44
+##Functions
45
+
46
+In mathematics, a function $$f$$ is a rule that is used to assign to each element $$x$$ from a set called *domain*, one (and only one) element $$y$$ from a set called *range*. This rule is commonly represented with an equation, $$y=f(x)$$. The variable $$x$$ is the parameter of the function and the variable $$y$$ will contain the result of the function. A function can have more than one parameter, but only one result. For example, a function can have the form $$y=f(x_1,x_2)$$ where there are two parameters, and for each pair $$(a,b)$$ that is used as an argument in the function, the function has only one value of $$y=f(a,b)$$. The domain of the function tells us the type of value that the parameter should have and the range tells us the value that the returned result will have.
47
+
48
+Functions in programming languages are similar. A function has a series of instructions that take the assigned values as parameters and performs a certain task. In C++ and other programming languages, functions return only one result, as it happens in mathematics. The only difference is that a *programming* function could possibly not return any value (in this case the function is declared as `void`). If the function will return a value, we use the instruction `return`. As in math, you need to specify the types of values that the function's parameters and result will have; this is done when declaring the function.
49
+
50
+###Function header:
51
+
52
+The first sentence of a function is called the *header* and its structure is as follows:
53
+
54
+`type name(type parameter01, ..., type parameter0n)`
55
+
56
+For example,
57
+
58
+`int example(int var1, float var2, char &var3)`
59
+
60
+would be the header of the function called `example`, which returns an integer value. The function receives as arguments an integer value (and will store a copy in `var1`), a value of type `float` (and will store a copy in `var2`) and the reference to a variable of type `char` that will be stored in the reference variable `var3`. Note that `var3` has a & symbol before the name of the variable. This indicates that `var3` will contain the reference to a character.
61
+
62
+###Invoking
63
+
64
+If we want to store the value of the `example` function's result in a variable `result` (that would be of type integer), we invoke the function by passing arguments as follows:
65
+
66
+`result=example(2, 3.5, unCar);`
67
+
68
+Note that as the function is invoked, you don't include the type of the variables in the arguments. As in the definition for the function `example`, the third parameter `&var3` is a reference variable; what is being sent to the third argument when invoking the function is a *reference* to the variable `unCar`. Any changes that are made on the variable `var3` will change the contents of the variable `unCar`.
69
+
70
+You can also use the function's result without having to store it in a variable. For example you could print it:
71
+
72
+`cout << "The result of the function example is:" << example(2, 3.5, unCar);`
73
+
74
+or use it in an arithmetic expression:
75
+
76
+`y=3 + example(2, 3.5, unCar);`
77
+
78
+
79
+
80
+###Overloaded functions
81
+
82
+Overloaded functions are functions that have the same name, but a different *signature*.
83
+
84
+The signature of a function is composed of the name of the function, and the types of parameters it receives, but does not include the return type.
85
+
86
+The following function prototypes have the same signature:
87
+
88
+```
89
+int example(int, int) ;
90
+void example(int, int) ; 
91
+string example(int, int) ;
92
+```
93
+
94
+Note that each has the same name, `example`, and receives the same amount of parameters of the same type `(int, int)`.
95
+
96
+The following function prototypes have different signatures:
97
+
98
+```
99
+int example(int) ;
100
+int elpmaxe(int) ;
101
+```
102
+
103
+Note that even though the functions have the same amount of parameters with the same type `int`, the name of the functions is different.
104
+
105
+The following function prototypes are overloaded versions of the function `example`:
106
+
107
+```
108
+int example(int) ;
109
+void example(char) ;
110
+int example(int, int) ;
111
+int example(char, int) ;
112
+int example(int, char) ;
113
+```
114
+
115
+All of the above functions have the same name, `example`, but different parameters. The first and second functions have the same amount of parameters, but their arguments are of different types. The fourth and fifth functions have arguments of type `char` and `int`, but in each case are in different order.
116
+
117
+In that last example, the function `example` is overloaded since there are 5 functions with different signatures but with the same name.
118
+
119
+
120
+###Values by default
121
+
122
+Values by default can be assigned to the parameters of the functions starting from the first parameter to the right. It is not necessary to initialize all of the parameters, but the ones that are initialized should be consecutive: parameters in between two parameters cannot be left uninitialized. This allows calling the function without having to send values in the positions that correspond to the initialized parameters.
123
+
124
+**Examples of function headers and valid invocations:**
125
+
126
+1. **Headers:** `int example(int var1, float var2, int var3 = 10)` Here `var3` is initialized to 10.
127
+
128
+    **Invocations:**
129
+
130
+    a. `example(5, 3.3, 12)` This function call assigns the value 5 to `var1`, the value 3.3 to `var2`, and the value of 12 to `var3`.
131
+
132
+    b. `example(5, 3.3)` This function call sends the values for the first two parameters and the value for the last parameter will be the value assigned by default in the header. That is, the values in the variables in the function will be as follows: `var1` will be 5, `var2` will be 3.3, and `var3` will be 10.
133
+
134
+2. **Header:** `int example(int var1, float var2=5.0, int var3 = 10)`
135
+Here `var2` is initialized to 5 and `var3` to 10.
136
+
137
+    **Invocations:**
138
+
139
+    a. `example(5, 3.3, 12)` This function call assigns the value 5 to `var1`, the value 3.3 to `var2`, and the value 12 to `var3`.
140
+
141
+    b. `example(5, 3.3)` In this function call only the first two parameters are given values, and the value for the last parameter is the value by default. That is, the value for `var1` within the function will be 5, that of `var2` will be 3.3, and `var3` will be 10.
142
+
143
+    c. `example(5)` In this function call only the first parameter is given a value, and the last two parameters will be assigned  values by default. That is, `var1` will be 5, `var2` will be 5.0, and `var3` will be 10.
144
+
145
+
146
+**Example of a valid function header with invalid invocations:**
147
+
148
+1. **Header:** `int example(int var1, float var2=5.0, int var3 = 10)` 
149
+
150
+    **Invocation:**
151
+
152
+    a. `example(5, , 10)` This function call is **invalid** because it leaves an empty space in the middle argument.
153
+
154
+    b. `example()` This function call is **invalid** because `var1` was not assigned a default value. A valid invocation to the function `example` needs at least one argument (the first). 
155
+
156
+**Examples of invalid function headers:**
157
+
158
+1. `int example(int var1=1, float var2, int var3)` This header is invalid because  the  default values can only be assigned starting from the rightmost parameter.
159
+
160
+2. `int example(int var1=1, float var2, int var3=10)` This header is invalid because you can't place parameters without values between other parameters with default values. In this case, `var2` doesn't have a default value but `var1` and `var3` do.
161
+
162
+---
163
+
164
+---
165
+
166
+##DVD movies and the DVD data base
167
+
168
+DVD stands for "digital versatile disk" or "digital video disk", which is an optical disc format for storing digital information invented by Philips, Sony, Toshiba, and Panasonic in 1995. The DVD offers larger storage capacity than compact disks (CD), but have the same dimensions. DVDs can be used to store any kind of digital data, but are famous for their use in the distribution of movies.
169
+
170
+
171
+---
172
+
173
+---
174
+
175
+
176
+!INCLUDE "../../eip-diagnostic/DVD/en/diag-dvd-01.html"
177
+
178
+!INCLUDE "../../eip-diagnostic/DVD/en/diag-dvd-03.html"
179
+
180
+!INCLUDE "../../eip-diagnostic/DVD/en/diag-dvd-11.html"
181
+
182
+!INCLUDE "../../eip-diagnostic/DVD/en/diag-dvd-12.html"
183
+---
184
+
185
+---
186
+
187
+
188
+
189
+## Laboratory session
190
+
191
+In this laboratory session we will be using a data base of DVD movies maintained by http://www.hometheaterinfo.com/dvdlist.htm. This database contains 44MB of information for movies that have been distributed in DVD. Some of the stored information in the database for each DVD is: DVD title, publishing studio, date of publication, type of sound, versions, price, rating, year and genre. The fields of information for each movie are stored in text with the following format:
192
+
193
+`DVD_Title|Studio|Released|Status|Sound|Versions|Price|Rating|Year|Genre|Aspect|UPC|DVD_ReleaseDate|ID|Timestamp`
194
+
195
+For example, 
196
+
197
+```
198
+Airplane! (Paramount/ Blu-ray/ Checkpoint)|Paramount||Discontinued|5.1 DTS-HD|LBX, 16:9, BLU-RAY|21.99|PG|1980|Comedy|1.85:1|097361423524|2012-09-11 00:00:00|230375|2013-01-01 00:00:00
199
+```
200
+
201
+
202
+###Exercise 1
203
+
204
+The first step in this lab experience is to familiarize yourself with the functions that are already defined in the code. Your tasks require that you imitate what the functions do, so it is important that you understand how to invoke, declare and define the functions. 
205
+
206
+**Instructions**
207
+
208
+1. Open the project `DVDInfo` in Qt by double clicking the file `DVDInfo.pro` in the folder `Documents/eip/Functions-DVDInfo` on your computer. You may also access `http://bitbucket.org/eip-uprrp/functions-dvdinfo` to download the folder `Functions-DVDInfo` to your computer.
209
+
210
+2. Configure the project. The file `main.cpp` has the function invocations that you will use in the next exercises. The declarations and definitions of the functions that will be invoked can be found in the files `movie.h` and `movie.cpp`.
211
+
212
+3. Double click on the file `movie.h` that contains this project's function prototypes. Go to `movie.h` and identify which functions are overloaded and describe why.
213
+    
214
+    Study the function prototypes and documentation in `movie.h` so that you understand the task they carry out and the data types they receive and return. For each of the following functions, identify the data types they receive and return:
215
+
216
+    ```
217
+    showMovie
218
+    showMovies (las dos)
219
+    getMovieName
220
+    getMovieByName
221
+    ```
222
+
223
+4. You can find the function definitions in the file `movie.cpp`. Note that some versions of the function `showMovie` use the object called`fields` of the `QStringList` class. The purpose of this object is to provide easy access to information fields of each movie, using an index between 0 and 14.  For example, you may use fields[0] to access a movie’s title, fields[1] to access a movie’s studio, fields[8] to access its year, and so forth.
224
+
225
+---
226
+
227
+!INCLUDE "../../eip-diagnostic/DVD/en/diag-dvd-06.html"
228
+
229
+
230
+###Exercise 2
231
+
232
+In this exercise you will modify the `main` function and some of the pre-defined functions so that they display only certain movies from the database, display only part of the information, or display the information in a specific format.
233
+
234
+**Instructions**
235
+
236
+1. In the file `main.cpp`, modify the `main` function so that the program displays the movies that have positions from 80 to 100.
237
+
238
+2. Now modify the `main` function so that the program  displays only the movies that have “forrest gump” in the title.
239
+
240
+3. Once again, modify the `main` function so that the program displays only the movie in position 75125 using function composition and the function `showMovie`.
241
+
242
+4. For the movie in part 3 of this exercise, add the necessary code to the `main` function so that the program displays the name and the rating of the movie.
243
+
244
+5. Modify the `getMovieInfo` function in the file `movie.cpp` so that it receives an additional parameter by reference to which the name of the movie will be assigned. Remember that you must also modify the function's prototype in `movie.h`.
245
+
246
+6. For the movie in part 3, add the necessary code to the `main` function so that, using `getMovieInfo`, it displays the name, rating, year and the genre of the movie in one line. Hint: note that the function `getMovieInfo` has parameters that are passed by reference. 
247
+
248
+###Exercise 3
249
+
250
+The functions whose prototypes are in `movie.h` are implemented in the file `movie.cpp`. In this exercise you will use the files `movie.h`, `movie.cpp`, and `main.cpp` to define and implement additional functions. As you implement these functions, remember to use good programming techniques and document your program.
251
+
252
+**Instructions**
253
+
254
+1. Study the functions that are already implemented in `movie.cpp` so that they may be used as examples for the functions you will create.
255
+
256
+2. Implement a function `getMovieStudio` that receives a string with the information of a movie and returns the name of the film's **studio**. Remember to add the function's prototype in the file `movie.h`. Invoke the function `getMovieStudio` in `main()` to display the name and studio of the movie in the position 75125 and demonstrate its functionality. 
257
+
258
+3. Implement an overloaded function `getMovieInfo` that returns the name of the studio as well as the name, rating, year and genre. Invoke the function `getMovieInfo` in `main()` to display the name, studio, rating, year and genre of the movie in the position 75125 and demonstrate its functionality.
259
+
260
+4. Implement a function `showMovieInLine` that **displays** the information the information displayed by `showMovie`, but in a single line. The function should have a parameter to receive a string of information of the movie. Invoke the function `showMovieInLine` in `main()` to display the information for the movie in position 75125 to demonstrate its functionality. 
261
+
262
+5. Implement a function `showMoviesInLine` that **displays** the same information displayed by `showMovies` (all of the movies within a range of positions) but in a single line per movie. For example, a function call would be: `showMoviesInLine(file, 148995, 149000);`. Invoke the function `showMoviesInLine` in `main()` to display the information and demonstrate its functionality.
263
+
264
+---
265
+
266
+---
267
+
268
+##Deliverables
269
+
270
+Use "Deliverables" in Moodle to hand in the files `main.cpp`, `movie.cpp`, and `movie.h` with the function calls, changes, implementations and declarations that you made in Exercises 2 and 3. Remember to use good programming techniques, include the names of the programmers involved, and to document your program.
271
+
272
+
273
+
274
+---
275
+
276
+---
277
+
278
+##References
279
+
280
+[1] http://mathbits.com/MathBits/CompSci/functions/UserDef.htm
281
+
282
+[2] http://www.digimad.es/autoria-dvd-duplicado-cd-video.html
283
+
284
+[3] http://www.soft32.com/blog/platforms/windows/keep-your-dvd-collection-up-to-date-with-emdb-erics-movie-database/
285
+
286
+[4] http://www.hometheaterinfo.com/dvdlist.htm

+ 299
- 0
README-es.md Переглянути файл

@@ -0,0 +1,299 @@
1
+
2
+# Utilizando funciones en C++ - Información de DVDs
3
+
4
+![main1.png](images/main1.png)
5
+![main2.png](images/main2.png)
6
+![main3.png](images/main3.png)
7
+
8
+
9
+Una buena manera de organizar y estructurar los programas de computadoras es dividiéndolos en partes más pequeñas utilizando funciones. Cada función realiza una tarea específica del problema que estamos resolviendo.
10
+
11
+Haz visto que todos los programas en C++ deben contener la función `main` que es donde comienza el programa. Probablemente ya haz utilizado funciones como `pow`, `sin`, `cos`  o `sqrt` de la biblioteca de matemática `cmath`. Dado que en casi todas las experiencias de laboratorio futuras estarás utilizando funciones pre-definidas, necesitas aprender cómo trabajar con ellas. Más adelante aprenderás cómo diseñarlas y validarlas. En esta experiencia de laboratorio harás búsquedas y desplegarás información contenida en una base de datos de DVDs para practicar la creación de funciones simples y la invocación de funciones pre-definidas. 
12
+
13
+
14
+##Objetivos:
15
+
16
+1. Identificar las partes de una función: tipo, nombre, lista de parámetros y cuerpo. 
17
+2. Invocar funciones pre-definidas pasando argumentos por valor ("pass by value") y por referencia ("pass by reference").
18
+3. Implementar una función simple que utilice parámetros por referencia.
19
+
20
+
21
+
22
+##Pre-Lab:
23
+
24
+Antes de llegar al laboratorio  debes:
25
+
26
+1. Haber repasado los siguientes conceptos:
27
+
28
+    a. los elementos básicos de la definición de una función en C++
29
+
30
+    b. la manera de invocar funciones en C++
31
+
32
+    c. la diferencia entre  parámetros pasados por valor y por referencia
33
+
34
+    d. cómo devolver el resultado de una función.
35
+
36
+2. Haber estudiado los conceptos e instrucciones para la sesión de laboratorio.
37
+
38
+3. Haber tomado el quiz Pre-Lab que se encuentra en Moodle.
39
+
40
+
41
+---
42
+
43
+---
44
+
45
+
46
+
47
+##Funciones
48
+
49
+
50
+En matemática, una función $$f$$ es una regla que se usa para asignar a cada elemento $$x$$ de un conjunto que se llama *dominio*, uno (y solo un) elemento $$y$$ de un conjunto que se llama *campo de valores*. Por lo general, esa regla se representa como una ecuación, $$y=f(x)$$. La variable $$x$$ es el parámetro de la función y la variable $$y$$ contendrá el resultado de la función. Una función puede tener más de un parámetro pero solo un resultado. Por ejemplo, una función puede tener la forma $$y=f(x_1,x_2)$$ en donde hay dos parámetros y para cada par $$(a,b)$$ que se use como argumento de la función, la función tiene un solo valor de $$y=f(a,b)$$. El dominio de la función te dice el tipo de valor que debe tener el parámetro y el campo de valores el tipo de valor que tendrá el resultado que devuelve la función.
51
+
52
+Las funciones en lenguajes de programación de computadoras son similares. Una función 
53
+tiene una serie de instrucciones que toman los valores asignados a los parámetros y realiza alguna tarea. En C++ y en algunos otros lenguajes de programación, las funciones solo pueden devolver un resultado, tal y como sucede en matemáticas. La única diferencia es que una función en programación puede que no devuelva valor (en este caso la función se declara `void`). Si la función va a devolver algún valor, se hace con la instrucción `return`. Al igual que en matemática tienes que especificar el dominio y el campo de valores, en programación tienes que especificar los tipos de valores que tienen los parámetros y el resultado que devuelve la función; esto lo haces al declarar la función.
54
+
55
+###Encabezado de una función:
56
+
57
+La primera oración de una función se llama el *encabezado* y su estructura es como sigue:
58
+
59
+`tipo nombre(tipo parámetro01, ..., tipo parámetro0n)`
60
+
61
+Por ejemplo,
62
+
63
+`int ejemplo(int var1, float var2, char &var3)`
64
+
65
+sería el encabezado de la función llamada `ejemplo`, que devuelve un valor entero. La función recibe como argumentos un valor entero (y guardará una copia en `var1`), un valor de tipo `float` (y guardará una copia en `var2`) y la referencia a una variable de tipo  `char` que se guardará en la variable de referencia `var3`. Nota que `var3` tiene el signo `&` antes del nombre de la variable. Esto indica que `var3` contendrá la referencia a un caracter.
66
+
67
+###Invocación
68
+
69
+Si queremos guardar el valor del resultado de la función `ejemplo` en la variable `resultado` (que deberá ser de tipo entero), invocamos la función pasando argumentos de manera similar a:
70
+
71
+`resultado=ejemplo(2, 3.5, unCar);`
72
+
73
+Nota que al invocar funciones no incluyes el tipo de las variables en los argumentos. Como en la definición de la función `ejemplo` el tercer parámetro `&var3` es una variable de referencia, lo que se está enviando en el tercer argumento de la invocación es una *referencia* a la variable `unCar`. Los cambios que se hagan en la variable `var3` están cambiando el contenido de la variable `unCar`.
74
+
75
+También puedes usar el resultado de la función sin tener que guardarlo en una variable. Por ejemplo puedes imprimirlo:
76
+
77
+`cout << "El resultado de la función ejemplo es:" << ejemplo(2, 3.5, unCar);`
78
+
79
+o utilizarlo en una expresión aritmética:
80
+
81
+`y=3 + ejemplo(2, 3.5, unCar);`
82
+
83
+
84
+
85
+###Funciones sobrecargadas (‘overloaded’)
86
+
87
+Las funciones sobrecargadas son funciones que poseen el mismo nombre, pero *firma* diferente.
88
+
89
+La firma de una función se compone del nombre de la función, y los tipos de parámetros que recibe, pero no incluye el tipo que devuelve.
90
+
91
+Los siguientes prototipos de funciones tienen la misma firma:
92
+
93
+```
94
+int ejemplo(int, int) ;
95
+void ejemplo(int, int) ; 
96
+string ejemplo(int, int) ;
97
+```
98
+
99
+Nota que todas tienen el mismo nombre, `ejemplo`, y reciben la misma cantidad de parámetros del mismo tipo `(int, int)`.
100
+
101
+Los siguientes prototipos de  funciones tienen firmas diferentes:
102
+
103
+```
104
+int ejemplo(int) ;
105
+int olpmeje(int) ;
106
+```
107
+Nota que a pesar de que las funciones tienen la misma cantidad de parámetros con mismo tipo `int`, el nombre de las funciones es distinto.
108
+
109
+Los siguientes prototipos de funciones son versiones sobrecargadas de la función `ejemplo`:
110
+
111
+```
112
+int ejemplo(int) ;
113
+void ejemplo(char) ;
114
+int ejemplo(int, int) ;
115
+int ejemplo(char, int) ;
116
+int ejemplo(int, char) ;
117
+```
118
+
119
+Todas las funciones de arriba tienen el mismo nombre, `ejemplo`, pero distintos parámetros.  La primera y segunda función tienen la misma cantidad de parámetros, pero los argumentos son de distintos tipos.  La cuarta y quinta función tienen argumentos de tipo `char` e `int`, pero en cada caso están en distinto orden.
120
+
121
+En este último ejemplo la función ejemplo es sobrecargada ya que hay 5 funciones con firma distinta pero con el mismo nombre.
122
+
123
+
124
+###Valores por defecto
125
+
126
+Se pueden asignar valores por defecto ("default") a los parámetros de las funciones comenzando desde el parámetro más a la derecha. No hay que inicializar todos los parámetros pero los que se inicializan deben ser consecutivos: no se puede dejar parámetros sin inicializar entre dos parámetros que estén inicializados. Esto permite la invocación de la función sin tener que enviar los valores en las posiciones que corresponden a parámetros inicializados.
127
+
128
+**Ejemplos de encabezados de funciones e invocaciones válidas:**
129
+
130
+1. **Encabezado:** `int ejemplo(int var1, float var2, int var3 = 10)` Aquí se inicializa `var3` a 10.
131
+
132
+     **Invocaciones:** 
133
+
134
+    a. `ejemplo(5, 3.3, 12)` Esta invocación asigna el valor 5 a `var1`, el valor 3.3 a `var2`, y el valor 12 a `var3`. 
135
+
136
+    b. `ejemplo(5, 3.3)`  Esta invocación envía valores para los primeros dos parámetros y el valor del último parámetro será el valor por defecto asignado en el encabezado. Esto es, los valores de las variables en la función serán: `var1` tendrá 5, `var2` tendrá 3.3, y `var3` tendrá 10.
137
+
138
+2. **Encabezado:** `int ejemplo(int var1, float var2=5.0, int var3 = 10)`  Aquí se  inicializa `var2` a 5 y `var3` a 10.
139
+    
140
+    **Invocaciones:** 
141
+
142
+    a. `ejemplo(5, 3.3, 12)` Esta invocación asigna el valor 5 a `var1`, el valor 3.3 a `var2`, y el valor 12 a  `var3`. 
143
+
144
+    b. `ejemplo(5, 3.3)` En esta invocación solo se envían valores para los primeros dos parámetros, y el valor del último parámetro es el valor por defecto.  Esto es, el valor de `var1` dentro de la función será 5, el de `var2` será 3.3 y el de `var3` será 10.
145
+
146
+    c. `ejemplo(5)` En esta invocación solo se envía valor para el primer parámetro, y los últimos dos parámetros tienen valores por defecto.  Esto es,  el valor de `var1` dentro de la función será 5, el de `var2` será 5.0 y el de `var3` será 10.
147
+
148
+    
149
+
150
+
151
+**Ejemplo de un encabezado de funciones válido con invocaciones inválidas:**
152
+
153
+1. **Encabezado:** `int ejemplo(int var1, float var2=5.0, int var3 = 10)`  
154
+
155
+    **Invocación:** 
156
+
157
+    a. `ejemplo(5, ,10)` Esta invocación  es **inválida** porque   deja espacio vacío en el argumento del medio. 
158
+
159
+    b. `ejemplo()` Esta invocación es **inválida** ya que `var1` no estaba inicializada y no recibe ningún valor en la invocación.
160
+
161
+**Ejemplos de encabezados de funciones inválidos:**
162
+
163
+1. `int ejemplo(int var1=1, float var2, int var3)` Este encabezado es inválido porque los valores por defecto solo se pueden asignar comenzando por el parámetro más a la derecha.
164
+
165
+2. `int ejemplo(int var1=1, float var2, int var3=10)` Este encabezado es inválido porque no se pueden poner parámetros sin valores en medio de parámetros con valores por defecto. En este caso  `var2` no tiene valor pero `var1` y `var3` si.
166
+
167
+---
168
+
169
+---
170
+
171
+##Películas DVD y base de datos DVD
172
+
173
+DVD son las siglas para “digital versatile disk” o “digital video disk” que en español significa disco versátil digital o disco de video digital. Este  es un formato de disco óptico para almacenamiento digital  inventado por Philips, Sony, Toshiba, y Panasonic en 1995.  Los DVD ofrecen capacidad de almacenamiento mayor que los discos compactos (CD), pero tienen las mismas dimensiones.  Los DVD pueden ser utilizados para almacenar cualquier dato digital, pero son famosos por su uso en la distribución de películas en los hogares.
174
+
175
+
176
+---
177
+
178
+---
179
+
180
+
181
+!INCLUDE "../../eip-diagnostic/DVD/es/diag-dvd-01.html"
182
+
183
+!INCLUDE "../../eip-diagnostic/DVD/es/diag-dvd-03.html"
184
+
185
+!INCLUDE "../../eip-diagnostic/DVD/es/diag-dvd-11.html"
186
+
187
+!INCLUDE "../../eip-diagnostic/DVD/es/diag-dvd-12.html"
188
+
189
+---
190
+
191
+---
192
+
193
+## Sesión de laboratorio
194
+
195
+En esta sesión de  laboratorio vamos a utilizar una base de datos de películas DVD mantenida por http://www.hometheaterinfo.com/dvdlist.htm. Esta base de datos contiene 44MB de información de películas que han sido distribuidas en DVD. Alguna de la información almacenada en esta base de datos es: título del DVD, estudio de publicación, fecha de publicación, tipo de sonido, versiones, precio, clasificación, año y  género.  Los campos de la información de cada película son almacenados en texto con el siguiente formato:
196
+
197
+
198
+`DVD_Title|Studio|Released|Status|Sound|Versions|Price|Rating|Year|Genre|Aspect|UPC|DVD_ReleaseDate|ID|Timestamp`
199
+
200
+Por ejemplo, 
201
+
202
+```
203
+Airplane! (Paramount/ Blu-ray/ Checkpoint)|Paramount||Discontinued|5.1 DTS-HD|LBX, 16:9, BLU-RAY|21.99|PG|1980|Comedy|1.85:1|097361423524|2012-09-11 00:00:00|230375|2013-01-01 00:00:00
204
+```
205
+
206
+
207
+###Ejercicio 1
208
+
209
+El primer paso en esta experiencia de laboratorio es familiarizarte con las funciones que ya están definidas en el código. Tus tareas requerirán que imites lo que hacen estas funciones, así que es importante que entiendas como se invocan, declaran y definen.
210
+
211
+**Instrucciones**
212
+
213
+1.  Carga a Qt el proyecto `DVDInfo`  haciendo doble "click" en el archivo `DVDInfo.pro` que se encuentra en la carpeta `Documents/eip/Functions-DVDInfo` de tu computadora. También puedes ir a `http://bitbucket.org/eip-uprrp/functions-dvdinfo` para descargar la carpeta `Functions-DVDInfo` a tu computadora.
214
+
215
+2. Configura el proyecto. El archivo `main.cpp` tiene la invocación de las funciones que usarás en los siguientes ejercicios.  En los archivos `movie.h` y `movie.cpp` se encuentra la declaración y definición de las funciones que vas a invocar.
216
+ 
217
+3. Haz doble "click" en el archivo `movie.h` que contiene los prototipos de las funciones de este proyecto. Ve a `movie.h` e identifica cuál o cuáles funciones son sobrecargadas y describe por qué.
218
+
219
+    Estudia los prototipos de funciones contenidas en `movie.h` de modo que sepas la tarea que realizan y los tipos de datos que reciben y devuelven. Identifica los tipos de datos que recibe y devuelve cada una de las siguientes funciones:
220
+
221
+    ```
222
+    showMovie
223
+    showMovies (las dos)
224
+    getMovieName
225
+    getMovieByName
226
+    ```
227
+
228
+4. En el archivo `movie.cpp` encontrarás las definiciones de las funciones. Nota que algunas versiones de la función `showMovie` usan el objeto llamado `fields` de clase `QStringList`. El propósito de ese objeto es poder acceder cada uno de los campos de información de la película usando un índice entre 0 y 14.  Por ejemplo, fields[0] accede al título de la película, fields[1] accede el estudio, fields[8] al año, etc.  
229
+
230
+----
231
+
232
+!INCLUDE "../../eip-diagnostic/DVD/es/diag-dvd-06.html"
233
+
234
+
235
+###Ejercicio 2
236
+
237
+En este ejercicio modificarás la función `main` y algunas de las funciones pre-definidas para que desplieguen solo algunas de las películas en la base de datos, desplieguen solo parte de la información contenida, o que desplieguen la información en un formato específico.
238
+
239
+**Instrucciones**
240
+
241
+1. Abre el archivo `main.cpp` y modifica la función `main` para que despliegue en la pantalla las películas en las posiciones 80 hasta la 100.
242
+
243
+2. Ahora modifica  la función `main` para que despliegue en la pantalla solo las películas que contengan “forrest gump” en el título.
244
+
245
+3. Modifica nuevamente la función `main` para que despliegue en la pantalla solo la película en la posición  75125 usando composición de funciones y la función `showMovie`.
246
+
247
+4. Para la película en la parte  3 de este ejercicio, modifica la función `main` para que solo despliegue el nombre y el rating de la película.
248
+
249
+5. Modifica la función `getMovieInfo` que se encuentra en el archivo `movie.cpp` para que también reciba por referencia el nombre de la película y le asigne un valor. Recuerda que también debes modificar el prototipo de esta función que se encuentra en `movie.h`.
250
+
251
+6. Para la película en la parte 3, modifica la función `main` para que, utilizando `getMovieInfo`,  despliegue el nombre, el rating, el año y el género de la película en una sola línea. Ayuda: nota que la función `getMovieInfo` tiene parámetros por referencia.
252
+
253
+###Ejercicio 3
254
+
255
+Las funciones cuyos prototipos están en `movie.h` están implementadas en el archivo `movie.cpp`. En este ejercicio  vas a utilizar los archivos `movie.h`, `movie.cpp`, y `main.cpp` para definir e implementar funciones adicionales. Al implementar las funciones, recuerda utilizar buenas prácticas de programación y documentar tu programa.
256
+
257
+**Instrucciones**
258
+
259
+1. Estudia las funciones que ya están implementadas en `movie.cpp` para que te sirvan de ejemplo para las funciones que vas a crear. 
260
+
261
+2. Implementa una función `getMovieStudio` que reciba una cadena de caracteres ("string") con la info de una película y devuelva el nombre del estudio de la película. Recuerda añadir el prototipo de la función en el archivo `movie.h`. Invoca la función `getMovieStudio` desde `main()` para desplegar el nombre y el estudio de la película en la posición 75125 y así demostrar su funcionamiento.
262
+
263
+3. Implementa una función sobrecargada `getMovieInfo` que devuelva el nombre del estudio además del nombre, rating, año y género. Invoca la función `getMovieInfo` desde `main()` para desplegar el nombre,  estudio, rating, año y género de la película en la posición 75125 y así demostrar su funcionamiento.
264
+
265
+4. Implementa una función `showMovieInLine` que **despliegue** la información de una película que despliega `showMovie` pero en una sola línea. La función debe tener un parámetro de modo que reciba el "string" de información de la película. Invoca la función `showMovieInLine` desde `main()` para desplegar la información de la película en la posición 75125 y así demostrar su funcionamiento.
266
+
267
+5. Implementa una función `showMoviesInLine` que **despliegue** la misma información que despliega `showMovies`  (todas las películas en un rango de posiciones) pero en una sola línea por película. Por ejemplo, una invocación a la función sería
268
+`showMoviesInLine(file, 148995, 149000);`. Invoca la función `showMoviesInLine` desde `main()` para desplegar la información y así demostrar su funcionamiento.
269
+
270
+---
271
+
272
+---
273
+
274
+##Entregas
275
+
276
+Utiliza "Entrega" en Moodle para entregar los archivos `main.cpp`, `movie.cpp` y `movie.h` con las invocaciones, cambios, implementaciones y declaraciones que hiciste en los ejercicios 2 y 3. Recuerda utilizar buenas prácticas de programación, incluir el nombre de los programadores y documentar tu programa.
277
+
278
+
279
+
280
+---
281
+
282
+---
283
+
284
+##Referencias
285
+
286
+[1] http://mathbits.com/MathBits/CompSci/functions/UserDef.htm
287
+
288
+[2] http://www.digimad.es/autoria-dvd-duplicado-cd-video.html
289
+
290
+[3] http://www.soft32.com/blog/platforms/windows/keep-your-dvd-collection-up-to-date-with-emdb-erics-movie-database/
291
+
292
+[4] http://www.hometheaterinfo.com/dvdlist.htm
293
+
294
+---
295
+
296
+---
297
+
298
+---
299
+

+ 2
- 587
README.md Переглянути файл

@@ -1,587 +1,2 @@
1
-[English](#markdown-header-using-functions-in-c-dvd-info) | [Español](#markdown-header-utilizando-funciones-en-c-informacion-de-dvds)
2
-
3
-# Utilizando funciones en C++ - Información de DVDs
4
-
5
-![main1.png](images/main1.png)
6
-![main2.png](images/main2.png)
7
-![main3.png](images/main3.png)
8
-
9
-
10
-Una buena manera de organizar y estructurar los programas de computadoras es dividiéndolos en partes más pequeñas utilizando funciones. Cada función realiza una tarea específica del problema que estamos resolviendo.
11
-
12
-Haz visto que todos los programas en C++ deben contener la función `main` que es donde comienza el programa. Probablemente ya haz utilizado funciones como `pow`, `sin`, `cos`  o `sqrt` de la biblioteca de matemática `cmath`. Dado que en casi todas las experiencias de laboratorio futuras estarás utilizando funciones pre-definidas, necesitas aprender cómo trabajar con ellas. Más adelante aprenderás cómo diseñarlas y validarlas. En esta experiencia de laboratorio harás búsquedas y desplegarás información contenida en una base de datos de DVDs para practicar la creación de funciones simples y la invocación de funciones pre-definidas. 
13
-
14
-
15
-##Objetivos:
16
-
17
-1. Identificar las partes de una función: tipo, nombre, lista de parámetros y cuerpo. 
18
-2. Invocar funciones pre-definidas pasando argumentos por valor ("pass by value") y por referencia ("pass by reference").
19
-3. Implementar una función simple que utilice parámetros por referencia.
20
-
21
-
22
-
23
-##Pre-Lab:
24
-
25
-Antes de llegar al laboratorio  debes:
26
-
27
-1. Haber repasado los siguientes conceptos:
28
-
29
-    a. los elementos básicos de la definición de una función en C++
30
-
31
-    b. la manera de invocar funciones en C++
32
-
33
-    c. la diferencia entre  parámetros pasados por valor y por referencia
34
-
35
-    d. cómo devolver el resultado de una función.
36
-
37
-2. Haber estudiado los conceptos e instrucciones para la sesión de laboratorio.
38
-
39
-3. Haber tomado el quiz Pre-Lab que se encuentra en Moodle.
40
-
41
-
42
----
43
-
44
----
45
-
46
-
47
-
48
-##Funciones
49
-
50
-
51
-En matemática, una función $$f$$ es una regla que se usa para asignar a cada elemento $$x$$ de un conjunto que se llama *dominio*, uno (y solo un) elemento $$y$$ de un conjunto que se llama *campo de valores*. Por lo general, esa regla se representa como una ecuación, $$y=f(x)$$. La variable $$x$$ es el parámetro de la función y la variable $$y$$ contendrá el resultado de la función. Una función puede tener más de un parámetro pero solo un resultado. Por ejemplo, una función puede tener la forma $$y=f(x_1,x_2)$$ en donde hay dos parámetros y para cada par $$(a,b)$$ que se use como argumento de la función, la función tiene un solo valor de $$y=f(a,b)$$. El dominio de la función te dice el tipo de valor que debe tener el parámetro y el campo de valores el tipo de valor que tendrá el resultado que devuelve la función.
52
-
53
-Las funciones en lenguajes de programación de computadoras son similares. Una función 
54
-tiene una serie de instrucciones que toman los valores asignados a los parámetros y realiza alguna tarea. En C++ y en algunos otros lenguajes de programación, las funciones solo pueden devolver un resultado, tal y como sucede en matemáticas. La única diferencia es que una función en programación puede que no devuelva valor (en este caso la función se declara `void`). Si la función va a devolver algún valor, se hace con la instrucción `return`. Al igual que en matemática tienes que especificar el dominio y el campo de valores, en programación tienes que especificar los tipos de valores que tienen los parámetros y el resultado que devuelve la función; esto lo haces al declarar la función.
55
-
56
-###Encabezado de una función:
57
-
58
-La primera oración de una función se llama el *encabezado* y su estructura es como sigue:
59
-
60
-`tipo nombre(tipo parámetro01, ..., tipo parámetro0n)`
61
-
62
-Por ejemplo,
63
-
64
-`int ejemplo(int var1, float var2, char &var3)`
65
-
66
-sería el encabezado de la función llamada `ejemplo`, que devuelve un valor entero. La función recibe como argumentos un valor entero (y guardará una copia en `var1`), un valor de tipo `float` (y guardará una copia en `var2`) y la referencia a una variable de tipo  `char` que se guardará en la variable de referencia `var3`. Nota que `var3` tiene el signo `&` antes del nombre de la variable. Esto indica que `var3` contendrá la referencia a un caracter.
67
-
68
-###Invocación
69
-
70
-Si queremos guardar el valor del resultado de la función `ejemplo` en la variable `resultado` (que deberá ser de tipo entero), invocamos la función pasando argumentos de manera similar a:
71
-
72
-`resultado=ejemplo(2, 3.5, unCar);`
73
-
74
-Nota que al invocar funciones no incluyes el tipo de las variables en los argumentos. Como en la definición de la función `ejemplo` el tercer parámetro `&var3` es una variable de referencia, lo que se está enviando en el tercer argumento de la invocación es una *referencia* a la variable `unCar`. Los cambios que se hagan en la variable `var3` están cambiando el contenido de la variable `unCar`.
75
-
76
-También puedes usar el resultado de la función sin tener que guardarlo en una variable. Por ejemplo puedes imprimirlo:
77
-
78
-`cout << "El resultado de la función ejemplo es:" << ejemplo(2, 3.5, unCar);`
79
-
80
-o utilizarlo en una expresión aritmética:
81
-
82
-`y=3 + ejemplo(2, 3.5, unCar);`
83
-
84
-
85
-
86
-###Funciones sobrecargadas (‘overloaded’)
87
-
88
-Las funciones sobrecargadas son funciones que poseen el mismo nombre, pero *firma* diferente.
89
-
90
-La firma de una función se compone del nombre de la función, y los tipos de parámetros que recibe, pero no incluye el tipo que devuelve.
91
-
92
-Los siguientes prototipos de funciones tienen la misma firma:
93
-
94
-```
95
-int ejemplo(int, int) ;
96
-void ejemplo(int, int) ; 
97
-string ejemplo(int, int) ;
98
-```
99
-
100
-Nota que todas tienen el mismo nombre, `ejemplo`, y reciben la misma cantidad de parámetros del mismo tipo `(int, int)`.
101
-
102
-Los siguientes prototipos de  funciones tienen firmas diferentes:
103
-
104
-```
105
-int ejemplo(int) ;
106
-int olpmeje(int) ;
107
-```
108
-Nota que a pesar de que las funciones tienen la misma cantidad de parámetros con mismo tipo `int`, el nombre de las funciones es distinto.
109
-
110
-Los siguientes prototipos de funciones son versiones sobrecargadas de la función `ejemplo`:
111
-
112
-```
113
-int ejemplo(int) ;
114
-void ejemplo(char) ;
115
-int ejemplo(int, int) ;
116
-int ejemplo(char, int) ;
117
-int ejemplo(int, char) ;
118
-```
119
-
120
-Todas las funciones de arriba tienen el mismo nombre, `ejemplo`, pero distintos parámetros.  La primera y segunda función tienen la misma cantidad de parámetros, pero los argumentos son de distintos tipos.  La cuarta y quinta función tienen argumentos de tipo `char` e `int`, pero en cada caso están en distinto orden.
121
-
122
-En este último ejemplo la función ejemplo es sobrecargada ya que hay 5 funciones con firma distinta pero con el mismo nombre.
123
-
124
-
125
-###Valores por defecto
126
-
127
-Se pueden asignar valores por defecto ("default") a los parámetros de las funciones comenzando desde el parámetro más a la derecha. No hay que inicializar todos los parámetros pero los que se inicializan deben ser consecutivos: no se puede dejar parámetros sin inicializar entre dos parámetros que estén inicializados. Esto permite la invocación de la función sin tener que enviar los valores en las posiciones que corresponden a parámetros inicializados.
128
-
129
-**Ejemplos de encabezados de funciones e invocaciones válidas:**
130
-
131
-1. **Encabezado:** `int ejemplo(int var1, float var2, int var3 = 10)` Aquí se inicializa `var3` a 10.
132
-
133
-     **Invocaciones:** 
134
-
135
-    a. `ejemplo(5, 3.3, 12)` Esta invocación asigna el valor 5 a `var1`, el valor 3.3 a `var2`, y el valor 12 a `var3`. 
136
-
137
-    b. `ejemplo(5, 3.3)`  Esta invocación envía valores para los primeros dos parámetros y el valor del último parámetro será el valor por defecto asignado en el encabezado. Esto es, los valores de las variables en la función serán: `var1` tendrá 5, `var2` tendrá 3.3, y `var3` tendrá 10.
138
-
139
-2. **Encabezado:** `int ejemplo(int var1, float var2=5.0, int var3 = 10)`  Aquí se  inicializa `var2` a 5 y `var3` a 10.
140
-    
141
-    **Invocaciones:** 
142
-
143
-    a. `ejemplo(5, 3.3, 12)` Esta invocación asigna el valor 5 a `var1`, el valor 3.3 a `var2`, y el valor 12 a  `var3`. 
144
-
145
-    b. `ejemplo(5, 3.3)` En esta invocación solo se envían valores para los primeros dos parámetros, y el valor del último parámetro es el valor por defecto.  Esto es, el valor de `var1` dentro de la función será 5, el de `var2` será 3.3 y el de `var3` será 10.
146
-
147
-    c. `ejemplo(5)` En esta invocación solo se envía valor para el primer parámetro, y los últimos dos parámetros tienen valores por defecto.  Esto es,  el valor de `var1` dentro de la función será 5, el de `var2` será 5.0 y el de `var3` será 10.
148
-
149
-    
150
-
151
-
152
-**Ejemplo de un encabezado de funciones válido con invocaciones inválidas:**
153
-
154
-1. **Encabezado:** `int ejemplo(int var1, float var2=5.0, int var3 = 10)`  
155
-
156
-    **Invocación:** 
157
-
158
-    a. `ejemplo(5, ,10)` Esta invocación  es **inválida** porque   deja espacio vacío en el argumento del medio. 
159
-
160
-    b. `ejemplo()` Esta invocación es **inválida** ya que `var1` no estaba inicializada y no recibe ningún valor en la invocación.
161
-
162
-**Ejemplos de encabezados de funciones inválidos:**
163
-
164
-1. `int ejemplo(int var1=1, float var2, int var3)` Este encabezado es inválido porque los valores por defecto solo se pueden asignar comenzando por el parámetro más a la derecha.
165
-
166
-2. `int ejemplo(int var1=1, float var2, int var3=10)` Este encabezado es inválido porque no se pueden poner parámetros sin valores en medio de parámetros con valores por defecto. En este caso  `var2` no tiene valor pero `var1` y `var3` si.
167
-
168
----
169
-
170
----
171
-
172
-##Películas DVD y base de datos DVD
173
-
174
-DVD son las siglas para “digital versatile disk” o “digital video disk” que en español significa disco versátil digital o disco de video digital. Este  es un formato de disco óptico para almacenamiento digital  inventado por Philips, Sony, Toshiba, y Panasonic en 1995.  Los DVD ofrecen capacidad de almacenamiento mayor que los discos compactos (CD), pero tienen las mismas dimensiones.  Los DVD pueden ser utilizados para almacenar cualquier dato digital, pero son famosos por su uso en la distribución de películas en los hogares.
175
-
176
-
177
----
178
-
179
----
180
-
181
-
182
-!INCLUDE "../../eip-diagnostic/DVD/es/diag-dvd-01.html"
183
-
184
-!INCLUDE "../../eip-diagnostic/DVD/es/diag-dvd-03.html"
185
-
186
-!INCLUDE "../../eip-diagnostic/DVD/es/diag-dvd-11.html"
187
-
188
-!INCLUDE "../../eip-diagnostic/DVD/es/diag-dvd-12.html"
189
-
190
----
191
-
192
----
193
-
194
-## Sesión de laboratorio
195
-
196
-En esta sesión de  laboratorio vamos a utilizar una base de datos de películas DVD mantenida por http://www.hometheaterinfo.com/dvdlist.htm. Esta base de datos contiene 44MB de información de películas que han sido distribuidas en DVD. Alguna de la información almacenada en esta base de datos es: título del DVD, estudio de publicación, fecha de publicación, tipo de sonido, versiones, precio, clasificación, año y  género.  Los campos de la información de cada película son almacenados en texto con el siguiente formato:
197
-
198
-
199
-`DVD_Title|Studio|Released|Status|Sound|Versions|Price|Rating|Year|Genre|Aspect|UPC|DVD_ReleaseDate|ID|Timestamp`
200
-
201
-Por ejemplo, 
202
-
203
-```
204
-Airplane! (Paramount/ Blu-ray/ Checkpoint)|Paramount||Discontinued|5.1 DTS-HD|LBX, 16:9, BLU-RAY|21.99|PG|1980|Comedy|1.85:1|097361423524|2012-09-11 00:00:00|230375|2013-01-01 00:00:00
205
-```
206
-
207
-
208
-###Ejercicio 1
209
-
210
-El primer paso en esta experiencia de laboratorio es familiarizarte con las funciones que ya están definidas en el código. Tus tareas requerirán que imites lo que hacen estas funciones, así que es importante que entiendas como se invocan, declaran y definen.
211
-
212
-**Instrucciones**
213
-
214
-1.  Carga a Qt el proyecto `DVDInfo`  haciendo doble "click" en el archivo `DVDInfo.pro` que se encuentra en la carpeta `Documents/eip/Functions-DVDInfo` de tu computadora. También puedes ir a `http://bitbucket.org/eip-uprrp/functions-dvdinfo` para descargar la carpeta `Functions-DVDInfo` a tu computadora.
215
-
216
-2. Configura el proyecto. El archivo `main.cpp` tiene la invocación de las funciones que usarás en los siguientes ejercicios.  En los archivos `movie.h` y `movie.cpp` se encuentra la declaración y definición de las funciones que vas a invocar.
217
- 
218
-3. Haz doble "click" en el archivo `movie.h` que contiene los prototipos de las funciones de este proyecto. Ve a `movie.h` e identifica cuál o cuáles funciones son sobrecargadas y describe por qué.
219
-
220
-    Estudia los prototipos de funciones contenidas en `movie.h` de modo que sepas la tarea que realizan y los tipos de datos que reciben y devuelven. Identifica los tipos de datos que recibe y devuelve cada una de las siguientes funciones:
221
-
222
-    ```
223
-    showMovie
224
-    showMovies (las dos)
225
-    getMovieName
226
-    getMovieByName
227
-    ```
228
-
229
-4. En el archivo `movie.cpp` encontrarás las definiciones de las funciones. Nota que algunas versiones de la función `showMovie` usan el objeto llamado `fields` de clase `QStringList`. El propósito de ese objeto es poder acceder cada uno de los campos de información de la película usando un índice entre 0 y 14.  Por ejemplo, fields[0] accede al título de la película, fields[1] accede el estudio, fields[8] al año, etc.  
230
-
231
-----
232
-
233
-!INCLUDE "../../eip-diagnostic/DVD/es/diag-dvd-06.html"
234
-
235
-
236
-###Ejercicio 2
237
-
238
-En este ejercicio modificarás la función `main` y algunas de las funciones pre-definidas para que desplieguen solo algunas de las películas en la base de datos, desplieguen solo parte de la información contenida, o que desplieguen la información en un formato específico.
239
-
240
-**Instrucciones**
241
-
242
-1. Abre el archivo `main.cpp` y modifica la función `main` para que despliegue en la pantalla las películas en las posiciones 80 hasta la 100.
243
-
244
-2. Ahora modifica  la función `main` para que despliegue en la pantalla solo las películas que contengan “forrest gump” en el título.
245
-
246
-3. Modifica nuevamente la función `main` para que despliegue en la pantalla solo la película en la posición  75125 usando composición de funciones y la función `showMovie`.
247
-
248
-4. Para la película en la parte  3 de este ejercicio, modifica la función `main` para que solo despliegue el nombre y el rating de la película.
249
-
250
-5. Modifica la función `getMovieInfo` que se encuentra en el archivo `movie.cpp` para que también reciba por referencia el nombre de la película y le asigne un valor. Recuerda que también debes modificar el prototipo de esta función que se encuentra en `movie.h`.
251
-
252
-6. Para la película en la parte 3, modifica la función `main` para que, utilizando `getMovieInfo`,  despliegue el nombre, el rating, el año y el género de la película en una sola línea. Ayuda: nota que la función `getMovieInfo` tiene parámetros por referencia.
253
-
254
-###Ejercicio 3
255
-
256
-Las funciones cuyos prototipos están en `movie.h` están implementadas en el archivo `movie.cpp`. En este ejercicio  vas a utilizar los archivos `movie.h`, `movie.cpp`, y `main.cpp` para definir e implementar funciones adicionales. Al implementar las funciones, recuerda utilizar buenas prácticas de programación y documentar tu programa.
257
-
258
-**Instrucciones**
259
-
260
-1. Estudia las funciones que ya están implementadas en `movie.cpp` para que te sirvan de ejemplo para las funciones que vas a crear. 
261
-
262
-2. Implementa una función `getMovieStudio` que reciba una cadena de caracteres ("string") con la info de una película y devuelva el nombre del estudio de la película. Recuerda añadir el prototipo de la función en el archivo `movie.h`. Invoca la función `getMovieStudio` desde `main()` para desplegar el nombre y el estudio de la película en la posición 75125 y así demostrar su funcionamiento.
263
-
264
-3. Implementa una función sobrecargada `getMovieInfo` que devuelva el nombre del estudio además del nombre, rating, año y género. Invoca la función `getMovieInfo` desde `main()` para desplegar el nombre,  estudio, rating, año y género de la película en la posición 75125 y así demostrar su funcionamiento.
265
-
266
-4. Implementa una función `showMovieInLine` que **despliegue** la información de una película que despliega `showMovie` pero en una sola línea. La función debe tener un parámetro de modo que reciba el "string" de información de la película. Invoca la función `showMovieInLine` desde `main()` para desplegar la información de la película en la posición 75125 y así demostrar su funcionamiento.
267
-
268
-5. Implementa una función `showMoviesInLine` que **despliegue** la misma información que despliega `showMovies`  (todas las películas en un rango de posiciones) pero en una sola línea por película. Por ejemplo, una invocación a la función sería
269
-`showMoviesInLine(file, 148995, 149000);`. Invoca la función `showMoviesInLine` desde `main()` para desplegar la información y así demostrar su funcionamiento.
270
-
271
----
272
-
273
----
274
-
275
-##Entregas
276
-
277
-Utiliza "Entrega" en Moodle para entregar los archivos `main.cpp`, `movie.cpp` y `movie.h` con las invocaciones, cambios, implementaciones y declaraciones que hiciste en los ejercicios 2 y 3. Recuerda utilizar buenas prácticas de programación, incluir el nombre de los programadores y documentar tu programa.
278
-
279
-
280
-
281
----
282
-
283
----
284
-
285
-##Referencias
286
-
287
-[1] http://mathbits.com/MathBits/CompSci/functions/UserDef.htm
288
-
289
-[2] http://www.digimad.es/autoria-dvd-duplicado-cd-video.html
290
-
291
-[3] http://www.soft32.com/blog/platforms/windows/keep-your-dvd-collection-up-to-date-with-emdb-erics-movie-database/
292
-
293
-[4] http://www.hometheaterinfo.com/dvdlist.htm
294
-
295
----
296
-
297
----
298
-
299
----
300
-
301
-[English](#markdown-header-using-functions-in-c-dvd-info) | [Español](#markdown-header-utilizando-funciones-en-c-informacion-de-dvds)
302
-
303
-# Using functions in C++ - DVD Info
304
-
305
-
306
-![main1.png](images/main1.png)
307
-![main2.png](images/main2.png)
308
-![main3.png](images/main3.png)
309
-
310
-
311
-A good way to organize and structure computer programs is dividing them into smaller parts using functions. Each function carries out a specific task of the problem that we are solving.
312
-
313
-You've seen that all programs written in C++ must contain the `main` function where the program begins. You've probably already used functions such as `pow`, `sin`, `cos`, or `sqrt` from the `cmath` library. Since in almost all of the upcoming lab activities you will continue using pre-defined functions, you need to understand how to work with them. In future exercises  you will learn how to design and validate functions. In this laboratory experience you will search and display information contained in a DVD data base to practice declaring simple functions and invoking pre-defined functions.
314
-
315
-
316
-##Objectives:
317
-
318
-1. Identify the parts of a function: return type, name, list of parameters, and body. 
319
-2. Invoke pre-defined functions by passing arguments by value ("pass by value"), and by reference ("pass by reference"). 
320
-3. Implement a simple function that utilizes parameters by reference.
321
-
322
-
323
-##Pre-Lab:
324
-
325
-Before you get to the laboratory you should have:
326
-
327
-1. Reviewed the following concepts:
328
-
329
-    a. the basic elements of a function definition in C++
330
-
331
-    b. how to invoke functions in C++
332
-
333
-    c. the difference between parameters that are passed by value and by reference
334
-
335
-    d. how to return the result of a function.
336
-
337
-2. Studied the concepts and instructions for the laboratory session.
338
-
339
-3. Taken the Pre-Lab quiz that can be found in Moodle.
340
-
341
----
342
-
343
----
344
-
345
-##Functions
346
-
347
-In mathematics, a function $$f$$ is a rule that is used to assign to each element $$x$$ from a set called *domain*, one (and only one) element $$y$$ from a set called *range*. This rule is commonly represented with an equation, $$y=f(x)$$. The variable $$x$$ is the parameter of the function and the variable $$y$$ will contain the result of the function. A function can have more than one parameter, but only one result. For example, a function can have the form $$y=f(x_1,x_2)$$ where there are two parameters, and for each pair $$(a,b)$$ that is used as an argument in the function, the function has only one value of $$y=f(a,b)$$. The domain of the function tells us the type of value that the parameter should have and the range tells us the value that the returned result will have.
348
-
349
-Functions in programming languages are similar. A function has a series of instructions that take the assigned values as parameters and performs a certain task. In C++ and other programming languages, functions return only one result, as it happens in mathematics. The only difference is that a *programming* function could possibly not return any value (in this case the function is declared as `void`). If the function will return a value, we use the instruction `return`. As in math, you need to specify the types of values that the function's parameters and result will have; this is done when declaring the function.
350
-
351
-###Function header:
352
-
353
-The first sentence of a function is called the *header* and its structure is as follows:
354
-
355
-`type name(type parameter01, ..., type parameter0n)`
356
-
357
-For example,
358
-
359
-`int example(int var1, float var2, char &var3)`
360
-
361
-would be the header of the function called `example`, which returns an integer value. The function receives as arguments an integer value (and will store a copy in `var1`), a value of type `float` (and will store a copy in `var2`) and the reference to a variable of type `char` that will be stored in the reference variable `var3`. Note that `var3` has a & symbol before the name of the variable. This indicates that `var3` will contain the reference to a character.
362
-
363
-###Invoking
364
-
365
-If we want to store the value of the `example` function's result in a variable `result` (that would be of type integer), we invoke the function by passing arguments as follows:
366
-
367
-`result=example(2, 3.5, unCar);`
368
-
369
-Note that as the function is invoked, you don't include the type of the variables in the arguments. As in the definition for the function `example`, the third parameter `&var3` is a reference variable; what is being sent to the third argument when invoking the function is a *reference* to the variable `unCar`. Any changes that are made on the variable `var3` will change the contents of the variable `unCar`.
370
-
371
-You can also use the function's result without having to store it in a variable. For example you could print it:
372
-
373
-`cout << "The result of the function example is:" << example(2, 3.5, unCar);`
374
-
375
-or use it in an arithmetic expression:
376
-
377
-`y=3 + example(2, 3.5, unCar);`
378
-
379
-
380
-
381
-###Overloaded functions
382
-
383
-Overloaded functions are functions that have the same name, but a different *signature*.
384
-
385
-The signature of a function is composed of the name of the function, and the types of parameters it receives, but does not include the return type.
386
-
387
-The following function prototypes have the same signature:
388
-
389
-```
390
-int example(int, int) ;
391
-void example(int, int) ; 
392
-string example(int, int) ;
393
-```
394
-
395
-Note that each has the same name, `example`, and receives the same amount of parameters of the same type `(int, int)`.
396
-
397
-The following function prototypes have different signatures:
398
-
399
-```
400
-int example(int) ;
401
-int elpmaxe(int) ;
402
-```
403
-
404
-Note that even though the functions have the same amount of parameters with the same type `int`, the name of the functions is different.
405
-
406
-The following function prototypes are overloaded versions of the function `example`:
407
-
408
-```
409
-int example(int) ;
410
-void example(char) ;
411
-int example(int, int) ;
412
-int example(char, int) ;
413
-int example(int, char) ;
414
-```
415
-
416
-All of the above functions have the same name, `example`, but different parameters. The first and second functions have the same amount of parameters, but their arguments are of different types. The fourth and fifth functions have arguments of type `char` and `int`, but in each case are in different order.
417
-
418
-In that last example, the function `example` is overloaded since there are 5 functions with different signatures but with the same name.
419
-
420
-
421
-###Values by default
422
-
423
-Values by default can be assigned to the parameters of the functions starting from the first parameter to the right. It is not necessary to initialize all of the parameters, but the ones that are initialized should be consecutive: parameters in between two parameters cannot be left uninitialized. This allows calling the function without having to send values in the positions that correspond to the initialized parameters.
424
-
425
-**Examples of function headers and valid invocations:**
426
-
427
-1. **Headers:** `int example(int var1, float var2, int var3 = 10)` Here `var3` is initialized to 10.
428
-
429
-    **Invocations:**
430
-
431
-    a. `example(5, 3.3, 12)` This function call assigns the value 5 to `var1`, the value 3.3 to `var2`, and the value of 12 to `var3`.
432
-
433
-    b. `example(5, 3.3)` This function call sends the values for the first two parameters and the value for the last parameter will be the value assigned by default in the header. That is, the values in the variables in the function will be as follows: `var1` will be 5, `var2` will be 3.3, and `var3` will be 10.
434
-
435
-2. **Header:** `int example(int var1, float var2=5.0, int var3 = 10)`
436
-Here `var2` is initialized to 5 and `var3` to 10.
437
-
438
-    **Invocations:**
439
-
440
-    a. `example(5, 3.3, 12)` This function call assigns the value 5 to `var1`, the value 3.3 to `var2`, and the value 12 to `var3`.
441
-
442
-    b. `example(5, 3.3)` In this function call only the first two parameters are given values, and the value for the last parameter is the value by default. That is, the value for `var1` within the function will be 5, that of `var2` will be 3.3, and `var3` will be 10.
443
-
444
-    c. `example(5)` In this function call only the first parameter is given a value, and the last two parameters will be assigned  values by default. That is, `var1` will be 5, `var2` will be 5.0, and `var3` will be 10.
445
-
446
-
447
-**Example of a valid function header with invalid invocations:**
448
-
449
-1. **Header:** `int example(int var1, float var2=5.0, int var3 = 10)` 
450
-
451
-    **Invocation:**
452
-
453
-    a. `example(5, , 10)` This function call is **invalid** because it leaves an empty space in the middle argument.
454
-
455
-    b. `example()` This function call is **invalid** because `var1` was not assigned a default value. A valid invocation to the function `example` needs at least one argument (the first). 
456
-
457
-**Examples of invalid function headers:**
458
-
459
-1. `int example(int var1=1, float var2, int var3)` This header is invalid because  the  default values can only be assigned starting from the rightmost parameter.
460
-
461
-2. `int example(int var1=1, float var2, int var3=10)` This header is invalid because you can't place parameters without values between other parameters with default values. In this case, `var2` doesn't have a default value but `var1` and `var3` do.
462
-
463
----
464
-
465
----
466
-
467
-##DVD movies and the DVD data base
468
-
469
-DVD stands for "digital versatile disk" or "digital video disk", which is an optical disc format for storing digital information invented by Philips, Sony, Toshiba, and Panasonic in 1995. The DVD offers larger storage capacity than compact disks (CD), but have the same dimensions. DVDs can be used to store any kind of digital data, but are famous for their use in the distribution of movies.
470
-
471
-
472
----
473
-
474
----
475
-
476
-
477
-!INCLUDE "../../eip-diagnostic/DVD/en/diag-dvd-01.html"
478
-
479
-!INCLUDE "../../eip-diagnostic/DVD/en/diag-dvd-03.html"
480
-
481
-!INCLUDE "../../eip-diagnostic/DVD/en/diag-dvd-11.html"
482
-
483
-!INCLUDE "../../eip-diagnostic/DVD/en/diag-dvd-12.html"
484
----
485
-
486
----
487
-
488
-
489
-
490
-## Laboratory session
491
-
492
-In this laboratory session we will be using a data base of DVD movies maintained by http://www.hometheaterinfo.com/dvdlist.htm. This database contains 44MB of information for movies that have been distributed in DVD. Some of the stored information in the database for each DVD is: DVD title, publishing studio, date of publication, type of sound, versions, price, rating, year and genre. The fields of information for each movie are stored in text with the following format:
493
-
494
-`DVD_Title|Studio|Released|Status|Sound|Versions|Price|Rating|Year|Genre|Aspect|UPC|DVD_ReleaseDate|ID|Timestamp`
495
-
496
-For example, 
497
-
498
-```
499
-Airplane! (Paramount/ Blu-ray/ Checkpoint)|Paramount||Discontinued|5.1 DTS-HD|LBX, 16:9, BLU-RAY|21.99|PG|1980|Comedy|1.85:1|097361423524|2012-09-11 00:00:00|230375|2013-01-01 00:00:00
500
-```
501
-
502
-
503
-###Exercise 1
504
-
505
-The first step in this lab experience is to familiarize yourself with the functions that are already defined in the code. Your tasks require that you imitate what the functions do, so it is important that you understand how to invoke, declare and define the functions. 
506
-
507
-**Instructions**
508
-
509
-1. Open the project `DVDInfo` in Qt by double clicking the file `DVDInfo.pro` in the folder `Documents/eip/Functions-DVDInfo` on your computer. You may also access `http://bitbucket.org/eip-uprrp/functions-dvdinfo` to download the folder `Functions-DVDInfo` to your computer.
510
-
511
-2. Configure the project. The file `main.cpp` has the function invocations that you will use in the next exercises. The declarations and definitions of the functions that will be invoked can be found in the files `movie.h` and `movie.cpp`.
512
-
513
-3. Double click on the file `movie.h` that contains this project's function prototypes. Go to `movie.h` and identify which functions are overloaded and describe why.
514
-    
515
-    Study the function prototypes and documentation in `movie.h` so that you understand the task they carry out and the data types they receive and return. For each of the following functions, identify the data types they receive and return:
516
-
517
-    ```
518
-    showMovie
519
-    showMovies (las dos)
520
-    getMovieName
521
-    getMovieByName
522
-    ```
523
-
524
-4. You can find the function definitions in the file `movie.cpp`. Note that some versions of the function `showMovie` use the object called`fields` of the `QStringList` class. The purpose of this object is to provide easy access to information fields of each movie, using an index between 0 and 14.  For example, you may use fields[0] to access a movie’s title, fields[1] to access a movie’s studio, fields[8] to access its year, and so forth.
525
-
526
----
527
-
528
-!INCLUDE "../../eip-diagnostic/DVD/en/diag-dvd-06.html"
529
-
530
-
531
-###Exercise 2
532
-
533
-In this exercise you will modify the `main` function and some of the pre-defined functions so that they display only certain movies from the database, display only part of the information, or display the information in a specific format.
534
-
535
-**Instructions**
536
-
537
-1. In the file `main.cpp`, modify the `main` function so that the program displays the movies that have positions from 80 to 100.
538
-
539
-2. Now modify the `main` function so that the program  displays only the movies that have “forrest gump” in the title.
540
-
541
-3. Once again, modify the `main` function so that the program displays only the movie in position 75125 using function composition and the function `showMovie`.
542
-
543
-4. For the movie in part 3 of this exercise, add the necessary code to the `main` function so that the program displays the name and the rating of the movie.
544
-
545
-5. Modify the `getMovieInfo` function in the file `movie.cpp` so that it receives an additional parameter by reference to which the name of the movie will be assigned. Remember that you must also modify the function's prototype in `movie.h`.
546
-
547
-6. For the movie in part 3, add the necessary code to the `main` function so that, using `getMovieInfo`, it displays the name, rating, year and the genre of the movie in one line. Hint: note that the function `getMovieInfo` has parameters that are passed by reference. 
548
-
549
-###Exercise 3
550
-
551
-The functions whose prototypes are in `movie.h` are implemented in the file `movie.cpp`. In this exercise you will use the files `movie.h`, `movie.cpp`, and `main.cpp` to define and implement additional functions. As you implement these functions, remember to use good programming techniques and document your program.
552
-
553
-**Instructions**
554
-
555
-1. Study the functions that are already implemented in `movie.cpp` so that they may be used as examples for the functions you will create.
556
-
557
-2. Implement a function `getMovieStudio` that receives a string with the information of a movie and returns the name of the film's **studio**. Remember to add the function's prototype in the file `movie.h`. Invoke the function `getMovieStudio` in `main()` to display the name and studio of the movie in the position 75125 and demonstrate its functionality. 
558
-
559
-3. Implement an overloaded function `getMovieInfo` that returns the name of the studio as well as the name, rating, year and genre. Invoke the function `getMovieInfo` in `main()` to display the name, studio, rating, year and genre of the movie in the position 75125 and demonstrate its functionality.
560
-
561
-4. Implement a function `showMovieInLine` that **displays** the information the information displayed by `showMovie`, but in a single line. The function should have a parameter to receive a string of information of the movie. Invoke the function `showMovieInLine` in `main()` to display the information for the movie in position 75125 to demonstrate its functionality. 
562
-
563
-5. Implement a function `showMoviesInLine` that **displays** the same information displayed by `showMovies` (all of the movies within a range of positions) but in a single line per movie. For example, a function call would be: `showMoviesInLine(file, 148995, 149000);`. Invoke the function `showMoviesInLine` in `main()` to display the information and demonstrate its functionality.
564
-
565
----
566
-
567
----
568
-
569
-##Deliverables
570
-
571
-Use "Deliverables" in Moodle to hand in the files `main.cpp`, `movie.cpp`, and `movie.h` with the function calls, changes, implementations and declarations that you made in Exercises 2 and 3. Remember to use good programming techniques, include the names of the programmers involved, and to document your program.
572
-
573
-
574
-
575
----
576
-
577
----
578
-
579
-##References
580
-
581
-[1] http://mathbits.com/MathBits/CompSci/functions/UserDef.htm
582
-
583
-[2] http://www.digimad.es/autoria-dvd-duplicado-cd-video.html
584
-
585
-[3] http://www.soft32.com/blog/platforms/windows/keep-your-dvd-collection-up-to-date-with-emdb-erics-movie-database/
586
-
587
-[4] http://www.hometheaterinfo.com/dvdlist.htm
1
+## [\[English\]](README-en.md) - for README in English
2
+## [\[Spanish\]](README-es.md) - for README in Spanish