Kotlin List: Utilizando listas em Kotlin

O que �?

Lista � a estrutura de dados que representa listas ordenadas de itens.

Em Kotlin temos duas interfaces para representar listas: List e MutableList.

Por que � �til?

Listas s�o utilizadas na maioria das aplicaç�es profissionais, sendo o conhecimento dessa estrutura de dados fundamental para o programador que deseja atuar profissionalmente.

Caracter�sticas

Veja a seguir as caracter�sticas de uma lista criada utilizando a interface List.

List � a interface padr�o para criaç�o de listas;
List � imut�vel, ou seja, uma vez criada a lista nenhum item pode ser adicionado ou removido dela;
Por ser imut�vel, List n�o possui m�todos para alteraç�o da lista, como add ou remove, por exemplo.

Veja a seguir as caracter�sticas de uma lista criada utilizando a interface MutableList.

MutableList � a interface para listas mut�veis, nas quais podemos adicionar ou remover itens;
Por ser mut�vel, MutableList possui m�todos que modificam a lista, como add e remove, por exemplo.

Como utilizar: sintaxe

Para criar uma lista imut�vel usamos a funç�o listOf, que retorna uma List, conforme apresentado no C�digo 1.


  val nomesProdutosPromocao: List<String> = listOf("Acem 1k", "Picanha 1k")

C�digo 1. Criando uma lista imut�vel de produtos

Para criar uma lista mut�vel, que pode receber/remover itens, usamos a funç�o mutableListOf, que retorna uma MutableList, conforme apresentado no C�digo 2.


  val nomesProdutosPromocao: List<String> = mutableListOf("Acem 1k", "Picanha 1k")

C�digo 2. Criando uma lista mut�vel de produtos

List - Exemplo pr�tico

Veremos agora um exemplo pr�tico de como lidar com listas em Kotlin.

Para utilizar a classe List n�o � necess�rio instalar nenhuma depend�ncia ou realizar configuraç�es especiais, uma vez que ela pertence � biblioteca padr�o (Kotlin Standard Library).

Antes de prosseguir vale destacar que usaremos a classe Produto (C�digo 3) nos exemplos a seguir.


  data class Produto(val codigo: String, var valor: Double)

C�digo 3. Classe Produto

Exemplo 1 - Lista de objetos

A funç�o listOf, vista anteriormente pode receber objetos como argumento, como vemos no C�digo 4.


  val produtos = listOf(
      Produto("Java101", 29.99),
      Produto("Spring101", 59.99),
  )

C�digo 4. Criando uma lista com listOf

Note que quando usamos listOf dessa forma n�o � necess�rio informar o tipo da vari�vel produtos como ": List<Produto>", uma vez que o compilador pode reconhecer o tipo da lista atrav�s dos itens dela.

Exemplo 2 - Iterando uma lista com forEach

Para iterar uma lista usamos comumente a funç�o forEach, como vemos no C�digo 5.


  produtos.forEach {
      println(it.codigo)
  }

C�digo 5. Como iterar uma lista

Aprenda mais sobre a funç�o forEach.

Tanto List quanto MutableList possuem o m�todo forEach.

Exemplo 3 - List � imut�vel

Listas em Kotlin s�o imut�veis por padr�o. Isso quer dizer que uma lista n�o pode ser alterada, receber ou perder itens, uma vez criada.

O C�digo 6 gera o erro Unresolved reference: add, pois List n�o possui funç�o para isso.


  produtos.add(Produto("C#101", 19.99))

C�digo 6. Erro ao tentar inserir um item na lista

O mesmo erro ocorrer� ao tentar usar m�todos para remover itens da lista, como removeAt, entre outros.

Para que tais operaç�es sejam realizadas em uma lista ela deve ser mut�vel.

Veremos como criar listas mut�veis no pr�ximo exemplo.

MutableList

Exemplo 1 - Criando uma lista mut�vel

Para criar uma lista, vazia ou n�o, e depois adicionar nela alguns itens devemos usar a funç�o mutableListOf em lugar de listOf. A funç�o mutableListOf cria uma lista mut�vel de itens, como vemos no C�digo 7.


  val produtos = mutableListOf<>(
      Produto("Java101", 29.99),
      Produto("Spring101", 59.99),
  )

C�digo 7. Criando uma lista mut�vel de itens

A funç�o mutableListOf retorna uma inst�ncia de MutableList, que suporta operaç�es que a modifiquem como adicionar ou remover itens, por exemplo.

Exemplo 2 - Transformando uma lista mut�vel em imut�vel

Uma lista mut�vel (MutableList) pode ser transformada em imut�vel (List) em uma funç�o, como vemos no C�digo 8.


  val produtos = mutableListOf<>(
      Produto("Java101", 29.99),
      Produto("Spring101", 59.99),
  )
   
  fun getProdutos() : List<Produto> = produtos

C�digo 8. Retornando uma lista imut�vel de uma lista mut�vel

Dessa forma, a lista retornada por getProdutos servir� apenas para visualizaç�o dos itens.

Exemplo 3 - Adicionando um elemento na lista

Para adicionar itens em uma lista usamos a funç�o add, como mostra o C�digo 9.


  produtos.add(Produto("C#101", 19.99))

C�digo 9. Retornando uma lista imut�vel de uma lista mut�vel

Lembre-se que apenas inst�ncias de MutableList possuem essa funç�o.

Exemplo 4 - Adicionando m�ltiplos elementos em uma lista

� poss�vel ainda adicionar uma lista a outra usando a funç�o addAll, como mostra o C�digo 10.


  val produtos2 = mutableListOf(
      Produto("C#101", 29.99),
      Produto("Blazor101", 59.99),
  )
   
  produtos.addAll(produtos2)

C�digo 10. Adicionando uma lista a outra

No C�digo 10 todos os itens na lista produtos2 ser�o adicionados na lista produtos.

Lembre-se que apenas inst�ncias de MutableList possuem essa funç�o.

Exemplo 5 - Removendo um elemento da lista pela posiç�o

Para remover o item espec�fico de uma lista podemos usar as funç�es removeAt, informando a posiç�o do item, como mostra o C�digo 11.


  produtos.removeAt(1)

C�digo 11. Removendo o item de uma lista

Caso a posiç�o informada n�o exista a exceç�o IndexOutOfBoundsException ser� lançada.

Lembre-se que apenas inst�ncias de MutableList possuem essa funç�o.

Exemplo 6 - Removendo um elemento da lista pelo objeto

Uma outra forma de remover o item de uma lista � informando o objeto a ser removido, como visto no C�digo 12.


  val android202 = Produto("Android202", 14.99)
  produtos.add(android202)
  produtos.remove(android202)

C�digo 12. Removendo o item de uma lista

Diferente de removeAt (Exemplo 7), remove falha amigavelmente, retornando true se o item foi encontrado e removido ou false caso contr�rio.

Lembre-se que apenas inst�ncias de MutableList possuem essa funç�o.

Exemplo 7 - Mutabilidade de refer�ncias para o mesmo objeto

Uma lista imut�vel gerada a partir de uma lista mut�vel � atualizada quando a lista mut�vel muda, uma vez que ambas apontam para o mesmo objeto.

Por exemplo, observe o C�digo 13.


  val produtos = mutableListOf(
      Produto("Java101", 29.99),
      Produto("Spring101", 59.99),
  )
   
  fun retornaProdutos(): List<Produto> = produtos
   
  fun main(args: Array<String>) {
      val produtosImutavel = retornaProdutos()
   
      produtos.add(Produto("C#101", 11.99))
   
      produtosImutavel.forEach {
          println(it.codigo)
      }
   
      produtos.forEach {
          println(it.codigo)
      }
  }

C�digo 13. Refer�ncias para o mesmo objeto em mem�ria

Ambas as vari�veis produtos e produtosImutavel apontam para o mesmo objeto. Dessa forma, quando na Linha 13 um novo produto � adicionado na lista, tanto produtos quanto produtosImutavel passam a armazen�-lo.

Conclus�o

A princ�pio, criar listas imut�veis pode parecer sem utilidade, uma vez que listas servem para armazenar itens. Contudo, conforme avançamos nos estudos, principalmente em boas pr�ticas, descobrimos que quanto menos as coisas mudam mais facilmente s�o testadas e mais dificilmente erros acontecem.

Listas imut�veis s�o �teis, principalmente quando desejamos apenas apresentar para o usu�rio alguns valores, sem que, para isso, tenhamos que correr o risco de, por acidente, adicionar ou remover itens dela. Usar listas imut�veis sempre que poss�vel e listas mut�veis sempre que necess�rio � uma boa pr�tica de programaç�o.

Utilizando listas em Kotlin

Neste artigo conheceremos a classe List em Kotlin e como utilizá-la.

O que �?

Por que � �til?

Caracter�sticas

Como utilizar: sintaxe

List - Exemplo pr�tico

Exemplo 1 - Lista de objetos

Exemplo 2 - Iterando uma lista com forEach

Exemplo 3 - List � imut�vel

MutableList

Exemplo 1 - Criando uma lista mut�vel

Exemplo 2 - Transformando uma lista mut�vel em imut�vel

Exemplo 3 - Adicionando um elemento na lista

Exemplo 4 - Adicionando m�ltiplos elementos em uma lista

Exemplo 5 - Removendo um elemento da lista pela posiç�o

Exemplo 6 - Removendo um elemento da lista pelo objeto

Exemplo 7 - Mutabilidade de refer�ncias para o mesmo objeto

Conclus�o

Artigos relacionados