[Dart] A classe List e todos os seus métodos

7 min readMar 16, 2023

Fala galera, blz?! Tudo bem com vocês? Espero que sim. Bom, hoje vou falar sobre a classe List em Dart e mostrar para vocês um guia com todos os métodos que essa classe tão importante para nós, possui. Se você está começando a programar em Dart ou quer saber mais sobre como trabalhar com listas, esse post é para você!

Antes de começarmos, é importante lembrar que uma lista é uma coleção de elementos que podem ser acessados por um índice. Em Dart, as listas são representadas pela classe List e possuem uma série de métodos que nos permitem manipulá-las de diversas maneiras. Dito isso, bora por a mão na massa!

length

Esse método retorna o número de elementos na lista. Por exemplo:

add

O método add adiciona um elemento no final da lista. Por exemplo:

addAll()

O método addAll() é usado para adicionar vários elementos a uma lista. Ele recebe uma outra lista como argumento e adiciona todos os seus elementos à lista original.

insert

O método insert adiciona um elemento em uma posição específica da lista. Por exemplo:

remove

O método remove remove(pois é o remove remove ;p) um elemento da lista. Por exemplo:

clear

O método clear remove todos os elementos da lista. Por exemplo:

indexOf

O método indexOf retorna o índice do primeiro elemento igual ao elemento passado como parâmetro. Por exemplo:

lastIndexOf

O método lastIndexOf retorna o índice do último elemento igual ao elemento passado como parâmetro. Por exemplo:

sort

O método sort ordena os elementos da lista. Por exemplo:

sublist

O método sublist retorna uma lista com um subconjunto dos elementos da lista original. Por exemplo:

forEach

O método forEach executa uma função para cada elemento da lista. Por exemplo:

map

O método map cria uma nova lista a partir da aplicação de uma função em cada elemento da lista original. Por exemplo:

any

O método any verifica se pelo menos um elemento da lista atende a uma determinada condição. Por exemplo:

every

O método every verifica se todos os elementos da lista atendem a uma determinada condição. Por exemplo:

reduce

O método reduce aplica uma operação em pares de elementos da lista e retorna um valor único. Por exemplo:

fold

O método fold é semelhante ao reduce, mas permite especificar um valor inicial para a operação. Por exemplo:

skip

O método skip retorna uma nova lista que exclui os primeiros N elementos da lista original. Por exemplo:

skipWhile

O método skipWhile retorna uma nova lista que exclui os elementos iniciais da lista original que atendem a uma determinada condição. Por exemplo:

take

O método take retorna uma nova lista com os primeiros N elementos da lista original. Por exemplo:

takeWhile

O método takeWhile retorna uma nova lista com os elementos iniciais da lista original que atendem a uma determinada condição. Por exemplo:

toSet

O método toSet retorna um conjunto a partir dos elementos da lista original, removendo quaisquer elementos duplicados. Por exemplo:

join

O método join concatena os elementos da lista original em uma única string, separados por um delimitador especificado. Por exemplo:

getRange

O método getRange retorna uma nova lista que contém uma faixa de elementos da lista original, a partir de um índice inicial até um índice final especificado. Por exemplo:

setRange

O método setRange substitui uma faixa de elementos na lista original com os elementos de outra lista. Por exemplo:

removeRange

O método removeRange remove uma faixa de elementos da lista original, a partir de um índice inicial até um índice final especificado. Por exemplo:

replaceRange

O método replaceRange substitui uma faixa de elementos na lista original com os elementos de outra lista, a partir de um índice inicial até um índice final especificado. Por exemplo:

fillRange()

O método fillRange() é usado para preencher uma faixa de índices em uma lista com um determinado valor.

first()

O método first() é usado para acessar o primeiro elemento de uma lista.

asMap

O método asMap retorna um Map que mapeia os índices dos elementos na lista original para os próprios elementos. Por exemplo:

shuffle

O método shuffle embaralha aleatoriamente a ordem dos elementos na lista original. Por exemplo:

cast()

O método cast() é usado para converter uma lista de um tipo para outro tipo. Ele retorna uma nova lista com os elementos convertidos.

elementAt()

O método elementAt() é usado para acessar um elemento específico de uma lista pelo seu índice.

expand()

O método expand() é usado para converter cada elemento de uma lista em zero ou mais elementos, que são adicionados à lista resultante.

firstWhere()

O método firstWhere() é usado para encontrar o primeiro elemento em uma lista que atende a um determinado critério.

removeWhere()

O método removeWhere() é utilizado para remover todos os elementos da lista que atendem a uma determinada condição. Ele recebe como parâmetro uma função que retorna um valor booleano. Essa função é aplicada a cada elemento da lista, e se ela retornar true, o elemento é removido.

Nesse exemplo, o método removeWhere() é utilizado para remover todos os números pares da lista.

retainWhere()

O método retainWhere() é utilizado para manter apenas os elementos da lista que atendem a uma determinada condição. Ele recebe como parâmetro uma função que retorna um valor booleano. Essa função é aplicada a cada elemento da lista, e se ela retornar false, o elemento é removido.

Nesse exemplo, o método retainWhere() é utilizado para manter apenas os números pares da lista.

reversed()

O método reversed() é utilizado para inverter a ordem dos elementos da lista. Exemplo:

setAll()

O método setAll() é utilizado para modificar os elementos da lista a partir de uma função. Ele recebe como parâmetro um índice inicial e uma função que recebe um índice como parâmetro e retorna o valor que será atribuído à posição correspondente na lista. Exemplo:

single()

O método single() é utilizado para obter o único elemento de uma lista. Se a lista não tiver exatamente um elemento, é lançada uma exceção.

singleWhere()

O método singleWhere() é utilizado para obter o único elemento de uma lista que atende a uma determinada condição. Se a lista não tiver exatamente um elemento que atende a condição, é lançada uma exceção.