Ejemplo 1. Creando una función sencilla: Teorema de Pitágoras

Como primer ejemplo, codificaremos una función que "calcule" el valor de la longitud de la hipotenusa de un triángulo rectángulo dadas las longitudes de los catetos.

Esto con los siguientes objetivos:

• "Mostrar" algunas características de una función.
• Crear y utilizar una función de paso por valor.
• Paso de varios valores a una función como argumento.
• Ejemplificar qué es el regreso de valores de una función.
• Introducir una forma de "analizar problemas" para crear un algoritmo, así como su codificación.

Para comenzar, se analiza el problema: 

La función debe calcular la longitud de la hipotenusa de un triángulo rectángulo cuando se conocen las longitudes de los catetos.

El teorema de Pitágoras establece que la suma del cuadrado de los catetos es igual al cuadrado de la
hipotenusa (sus longitudes):

$ c^2=a^2+b^2$

Ya que necesitamos la longitud de la hipotenusa  c, entonces hacemos el despeje:

$c=\sqrt{a^2+b^2}$

En este momento "ya tenemos" una parte de lo que necesitamos, ahora pensemos, ¿cómo YO resolvería el problema? 

Bueno, la respuesta sería una serie de pasos:

1. Conocemos a.
2. Conocemos b.
3. Aplicamos la fórmula $c=\sqrt{a^2+b^2}$.

Siguiendo esto es posible plantear el algoritmo como un diagrama de flujo:

Se puede leer de la siguiente manera:

1. Inicio de la función.
2. Se ingresan los valores a y b.
3. Se realiza en cálculo $c=\sqrt{a^2+b^2}$.
4. Fin de la función.

Ya que en este caso crearemos una función, los valores a y b se pasarán como argumento de dicha función que llamaremos "pitagoras".

Cuando se tienen diferentes valores éstos se separan con un caracter coma ',' .

Cada valor se distinguirá con un nombre de variable, en este caso a y b, esto se asemeja a una declaración de variables.

En este último diagrama, se eliminó el bloque de entrada de valores porque ya se podrán usar al pasarlos como argumento de la función.

Por último, la codificación.

Creamos un nuevo archivo -> Agregamos un Editor de Programas

Como nombre escribimos pitagoras.

Será una función.

Dejamos el acceso a librería como público.

En la pantalla que aparece tenemos la función. Escribimos dentro del paréntesis las variables que "contendrán" los valores a y b que utilizará la calculadora (como se muestra en la siguiente imagen).

Declaramos una variable c.

NOTA: Tal vez te preguntes por qué se declara con el comando Local. Esto se debe a que en programación tenemos dos tipos de variables:

• Variables locales: La variable sólo se puede usar en la función donde fue declarada, es decir, que si tengo dos funciones f1() y f2() y declaro una variable en f1(), esta variable será completamente desconocida para f2() y por lo tanto no podrá usarla.
• Variables globales: La variable puede usarse en cualquier función que esté declarada EN UN PROGRAMA.

Ya que únicamente codificamos funciones, nuestras variables se utilizarán exclusivamente en esa función, por lo que las variables se declaran:

Local nombreDeLaVariable

En la siguiente imagen se muestra como declarar la variable c que usaremos.

En este momento la variable c existe, pero no tiene ningún valor asignado.

Vamos a asignarle el valor que necesitamos, para ello existen dos formas:

• Utilizando el símbolo :=  (dos puntos y símbolo de igualdad): Se usa la siguiente sintaxis:

                    Nombre de la variable :=  valor a asignar

• Utilizando el símbolo $\rightarrow$:

                    valor a asignar $\rightarrow$ Nombre de la variable

NOTA: Yo prefiero usar la primer forma := , por lo que la función queda de la siguiente manera:

En este caso el valor que le asignaremos es el resultado de realizar la operación $\sqrt{a^2+b^2}$.

Finalmente, la función regresa el valor de c. Para ello usamos el comando Return, que se usa de la siguiente forma:

Return valorARegresar

Pero, ¿qué es regresar un valor? Usaré un ejemplo para intentar explicarlo. Cuando la calculadora "hace la operación" 1 + 1 nos muestra un valor 2. Esto quiere decir que regresó ese valor, pues viendo a fondo, el símbolo + llama a una función que sumará el valor que está a su derecha al valor que está a su izquierda, el resultado de la suma es regresado para que puedas verlo e incluso usarlo posteriormente. 

NOTA: Puedes ver a detalle esto buscando "Operadores binarios", o si te conformas con wikipedia visita: Operación binaria.

Por último probemos nuestra función. 

Menú -> Verificar sintaxis y almacenar -> Verificar sintaxis y almacenar

Menú -> Verificar sintaxis y almacenar -> Ejecutar

Con esto se inserta una página de "Calculadora" y se escribe el nombre de la función.

Por último escribimos los valores de los catetos, y pulsamos la tecla "enter". Utilicemos el ejemplo:

a=2.2

b=4.4

c=?

El resultado que muestra es el valor de la longitud de la hipotenusa.

Para usar de nuevo la función solo se escribe el nombre, los paréntesis y los valores que se van a usar.

NOTA: Si se pasa un valor menos o un valor más arrojará un error:

Por último, hagamos un ejercicio de guardado:

Se hace clic en la flecha junto a *Doc.

Se despliega el menú Documentos -> Guardar como.

Escribimos el nombre y seleccionamos la ubicación.

 

Con esto podemos usar la función en un futuro.

¿Cómo lo puedo aplicar?

Lo más común: guardar fórmulas. Puedes codificar fórmulas que necesites, guardarlas y después usarlas. La que vimos en el ejemplo es tan sencilla que sería una pérdida de tiempo, pero para fórmulas muy grandes o complejas es muy útil, como veremos en otros ejemplos. La dos imágenes siguientes muestran esto, ya que si codificas varias funciones en un mismo documento ¡estás creando una librería! que claro, veremos más adelante.

En el próximo ejemplo haremos un programa para ver sus ventajas frente a una función.

Cualquier duda puedes dejarla en los comentarios, intentaré responder lo más pronto posible.