Advertisement
  1. Code
  2. Kotlin
Code

Kotlin Desde Cero: Paquetes y Funciones Básicas

This post is part of a series called Kotlin From Scratch.
Kotlin From Scratch: Ranges and Collections
Kotlin From Scratch: More Fun With Functions

Spanish (Español) translation by Rafael Chavarría (you can also view the original English article)

Kotlin es un moderno lenguaje de programación que compila a código byte Java. Es gratuito y de código abierto, y promete hacer el código para Android incluso más divertido.

En el artículo anterior, aprendiste sobre rangos y colecciones en Kotlin. En este tutorial, continuaremos aprendiendo el lenguaje viendo cómo organizar código usando paquetes, y después continuaremos a una introducción a funciones en Kotlin.

1. Paquetes

Si estás familiarizado con Java, sabes que Java usa paquetes para agrupar clases relacionadas; por ejemplo, el paquete java.util tiene un número de útiles clases utilitarias. Los paquetes son declarados con la palabra clave package, y cualquier archivo Kotlin con una declaración package al inicio puede contener declaraciones de clases, funciones o interfaces.

Declaración

Viendo el código de abajo, hemos declarado un paquete com.chikekotlin.projectx usando la palabra clave package. También, declaramos una clase MyClass (discutiremos clases en Kotlin en artículos futuros) dentro de este paquete.

Ahora, el nombre completamente calificado para la clase MyClass es com.chikekotlin.projectx.MyClass.

En el código de arriba, creamos una función de nivel superior (llegaremos a eso pronto). Así que de manera similar a MyClass, el nombre completamente calificado para la función saySomething() es com.chikekotlin.projectx.saySomething.

Importaciones

En Kotlin, usamos la declaración import para habilitar al compilador para localizar las clases, funciones, interfaces u objetos a ser importados. En Java, por el otro lado, no podemos importar directamente funciones o métodos---solo clases o interfaces.

Usamos import para acceder a una función, interfaz, clase u objeto fuera del paquete en donde fue declarado.

En el pedazo de código de arriba, importamos la función saySomething() desde un paquete diferente, y después ejecutamos esa función.

Kotlin también soporta importaciones comodín usando el operador *. Eso importará todas las clases interfaces y funciones declaradas en el paquete a la vez. Esto no es recomendado, sin embargo---es mejor usualmente hacer tus importaciones explícitas.

Importar Aliasing

Cuando tienes librerías que tienen nombres de clase o función en conflicto (ej. cada una declara una función con el mismo nombre), puedes usar la palabra clave as para darle a esa entidad importada un nombre temporal.

Nota que el nombre temporal es usado solo dentro del archivo en donde fue asignado.

2. Funciones

Una función agrupa una serie de declaraciones de código que realizan una tarea. Los detalles de la implementación de la función están ocultos del llamador.

En Kotlin, las funciones están definidas usando la palabra clave fun, como se muestra en el siguiente ejemplo:

En el código de arriba, definimos una función simple hello() con un solo parámetro name del tipo String. Esta función devuelve un tipo String. El formato de definición de parámetros para funciones es: nombre: tipo, ej. edad: Int, precio: Double, estudiante: StudentClass.

La función de arriba es similar a la anterior, pero nota que esta tiene un tipo de retorno de Unit. Debido a que esta función no nos devuelve ningún valor significativo---solo imprime un mensaje---su tipo de retorno es Unit por defecto. Unit es un objeto Kotlin (discutiremos objetos Kotlin en artículos posteriores) que es similar a los tipos Void en Java y C.

Nota que si no declaras explícitamente el tipo de retorno para ser Unit, el tipo es inferido por el compilador.

Funciones de Una Sola Línea

Las funciones de una sola línea son funciones que son expresiones de una sola línea. En esta función, nos deshacemos de los corchetes y usamos el símbolo = antes de la expresión. En otras palabras, nos deshacemos de la función bloque.

La función de arriba puede ser acortada en una sola línea:

Mirando a la función actualizada de arriba, puedes ver que hemos hecho nuestro código más conciso removiendo las llaves {}, la palabra clave return, y también el tipo de retorno (que es inferido por el compilador).

Aún puedes incluir el tipo de retorno para ser más explícito si quieres.

Parámetros Nombrados

Los parámetros nombrados permiten funciones más legibles nombrando los parámetros que están siendo pasados a una función cuando se llaman.

En el siguiente ejemplo, creamos una función que imprime mi nombre completo.

Para ejecutar la función de arriba, solo la llamaríamos así:

Viendo a la llamada de función de arriba, no sabemos cuáles tipos de argumentos String son iguales a cuáles parámetros de función (aunque algunos IDEs como IntelliJ IDEA nos pueden ayudar). Los usuarios de la función tendrán que buscar en la firma de la función (o el código fuente) o documentación para saber a qué corresponde cada parámetro.

En la segunda llamada de función de arriba, proporcionamos los nombres de parámetro antes de los valores de argumento. Puedes ver que esta llamada de función es más clara y más legible que la anterior. Esta manera de llamar funciones ayuda a reducir la posibilidad de errores que pueden ocurrir cuando los argumentos del mismo tipo son intercambiados por error.

El llamador también puede alterar el orden de los parámetros usando parámetros nombrados. Por ejemplo:

En el código de arriba, intercambiamos la posición de argumento de firstName con lastName. El orden del argumento no importa con parámetros nombrados porque el compilador mapeará cada uno de ellos al parámetro correcto de función.

Parámetros Por Defecto

En Kotlin, podemos darle a una función valores por defecto para cualquiera de sus parámetros. Estos valores por defecto se usan si nada es asignado a los argumentos durante la llamada de la función. Para hacer esto en Java, necesitaríamos crear diferentes métodos sobrecargados.

Aquí, en nuestro método calCircumference(), modificamos el método agregando un valor por defecto para el parámetro pi---Math.PI, una constante del paquete java.lang.Math.

Cuando llamamos esta función, podemos pasar nuestro valor aproximado para pi o usar el valor por defecto.

Veamos otro ejemplo.

En el siguiente código, intentamos llamar a la función, pero no compilará:

En la llamada de función de arriba, estoy pasando mi primer nombre y apellido a la función, y esperando usar el valor por defecto para el nombre medio. Pero esto no compilará porque el compilador está confundido. Este no sabe para qué es el argumento "Mgbemena"---¿es para el parámetro middleName o para lastName?

Para resolver este asunto, podemos combinar parámetros nombrados y parámetros por defecto.

Interoperabilidad Java

Dado que Java no soporta valores de parámetro por defecto en métodos, necesitarás especificar todos los valores de parámetro de manera explícita cuando llamas una función Kotlin desde Java. Pero Kotlin nos proporciona la funcionalidad para hacer más sencillo para los llamadores Java anotando la función Kotlin con @JvmOverloads. Esta anotación instruirá al compilador Kotlin para generar las funciones sobrecargadas Java por nosotros.

En el siguiente ejemplo, anotamos la función calCirumference() con @JvmOverloads.

El siguiente código fue generado por el compilador Kotlin para que los llamadores Java puedan entonces elegir a cuál llamar.

En la última definición de método Java generada, el parámetro pi fue omitido. Esto significa que el método usará el valor pi por defecto.

Argumentos Ilimitados

En Java, podemos crear un método para recibir un número no especificado de argumentos incluyendo puntos suspensivos (...) después de un tipo en la lista de parámetro del método. Esto concepto también es soportado por funciones Kotlin con el uso del modificador vararg seguido por el nombre del parámetro.

El modificador vararg permite a los llamadores pasar una lista separada por comas de argumentos. Tras bambalinas, esta lista de argumentos será envuelta en un arreglo.

Cuando una función tiene múltiples parámetros, el parámetro vararg es típicamente el último. También es posible tener parámetros después de vararg, pero necesitarás usar parámetros nombrados para especificarlos cuando llamas a la función.

Por ejemplo, en el código de arriba, el parámetro con el modificador vararg está en la última posición en una lista de múltiples parámetros (esto es lo que hacemos usualmente). ¿Pero qué si no lo queremos en la última posición? En el siguiente ejemplo, está en la segunda posición.

Como puedes observar en el código actualizado de arriba, usamos argumentos nombrados en el último parámetro para solucionar esto.

Operador Propagado

Digamos que queremos pasar un arreglo de enteros a nuestra función printNumbers(). La función espera que los valores sean desenrrollados a una lista de parámetros, sin embargo. Si intentas pasar el arreglo directamente a printNumbers(), verás que no compilará.

Para resolver este problema, necesitamos usar el operador *. Este operador desempacará el arreglo y después pasará los elementos individuales como argumentos a la función por nosotros.

Insertando el operador * en frente de instArray en la lista de argumentos de la función, el código ahora compila y produce el mismo resultado que si hubiéramos pasado los elementos de intsArray como una lista separada por comas de argumentos.

Devuelve Múltiples Valores

Algunas veces queremos devolver múltiples valores desde una función. Una manera es usar el tipo Pair en Kotlin para crear un Pair y después devolverlo. Esta estructura Pair encierra dos valores que después pueden ser valorados. Este tipo Kotlin puede aceptar cualquier tipo que suministres a su constructor. Y, lo que es más, los dos tipos ni siquiera tienen que ser el mismo.

En la función de arriba, construimos un nuevo Pair pasando las variables userName y userState como el primer y segundo argumento respectivamente a su constructor, y después devolvimos su Pair al llamador.

Otra cosa que notar es que usamos una función llamada require() en la función getUserNameAndState(). Esta función de ayuda desde la librería estándar es usada para dar nuestros llamadores de función una condición previa para cumplir, o de otro modo IllegalArgumentException será lanzado (discutiremos Excepciones en Kotlin en un artículo futuro). El segundo argumento opcional para require() es una función literal devolviendo un mensaje para ser mostrado si la excepción es lanzada. Por ejemplo, llamar a la función getUserNameAndState() y pasar -1 como un argumento disparará:

IntelliJ IDEA code execution result

Recuperando Datos Desde Pair

En el código de arriba, accedimos el primer y segundo valores desde el tipo Pair usando sus propiedades first y second.

Sin embargo, hay una mejor forma de hacer esto: desestructurando.

Lo que hemos hecho en el código actualizado de arriba es asignar directamente el primer y segundo valor del tipo Pair devuelto a las variables name y state respectivamente. Esta característica es llamada declaración de desestructuración.

Valores Triples de Retorno y Más allá

Ahora, ¿qué si quieres devolver tres valores a la vez? Kotlin nos proporciona con otro tipo útil llamada Triple.

Estoy seguro de que algunos de ustedes se están preguntando qué hacer si quieres devolver más de tres valores. La respuesta para eso estará en un artículo futuro, cuando discutamos las clases de datos de Kotlin.

Conclusión

En este tutorial, aprendiste sobre los paquetes y funciones básicas en el lenguaje de programación Kotlin. En el siguiente tutorial en la serie Kotlin Desde Cero, aprenderás más sobre funciones en Kotlin. ¡Nos vemos pronto!

Para aprender más sobre el lenguaje Kotlin, recomiendo visitar la documentación Kotlin. ¡O revisa algunos de nuestros otros artículos de desarrollo de apps Android aquí en Envato Tuts+!

Advertisement
Advertisement
Looking for something to help kick start your next project?
Envato Market has a range of items for sale to help get you started.