Dart語言學習-List

 資料出自：https://www.gushiciku.cn/pl/pI7Z/zh-tw

一、宣告陣列的方式

1、宣告一特定類型陣列，如果在宣告時前面不要加上<類型>，那就不會限制陣列中的類型。

var list = <int>[]; //設定int型別的空陣列，或List<int> list =[];
print('$list - length: ${list.length}'); // 輸出 [] - 0

2、宣告特定長度陣列

var list2 = List(2); //適用於2.0的舊版本
print('$list2'); // [, ]
var newList = List.filled(2, "3"); //適用於3.0的新版本，第一個參數為長度，第二個參數為要填入的值
print('$newList'); // [3,3]

3、定義混合類型陣列，var 陣列名=[] 或是List list=[];

var list3 = []; 
list3.add(3);
list3.add('value');
print(list3); // [3, 'value']

二、陣列的常用屬性

1、獲取陣列長度 - length

var list = [1, 2, 3, 4];
print(list.length); // 4

2、獲取陣列第一個元素 - first

var list = [1, 2, 3, 4];
print(list.first); // 1

3、獲取陣列最後一個元素 - last

var list = [1, 2, 3, 4];
print(list.last); // 4

3、獲取倒序迭代器 - reversed （獲取值為literable，注意與原來陣列不同，需tolist()才能轉型回陣列）

var list = [1, 2, 3, 4];
print(list.reversed); // (4, 3, 2, 1)

4、判斷陣列是否為空 - isEmpty

var list = [1, 2, 3, 4];
print(list.isEmpty); // false

5、判斷陣列是否為非空 - isNotEmpty

var list = [1, 2, 3, 4];
print(list.isNotEmpty); // true

三、陣列的常用方法

1、新增元素 - add

var list = [];
list.add(1);
print(list); // [1]

2、批量新增 - addAll （增加另一List在後）

var list = [1, 2, 3, 4];
var list2 = [0, 20, 40];
list.addAll(list2);
print(list); // [1, 2, 3, 4, 0, 20, 40]

3、指定位置插入 - insert （參數1為位置，參數2為value）

var list = [1, 2, 3, 4];
list.insert(2, 90);
print(list); // [1, 2, 90, 3, 4]

4、指定位置批量插入 - insertAll

var list = [1, 2, 3, 4];
var list2 = [0, 20, 40];
list.insertAll(2, list2);
print(list); // [1, 2, 0, 20, 40, 3, 4]

5、刪除指定值 - remove （參數為value）

var list = [1, 2, 6, 4];
list.remove(6);
print(list); // [1, 2, 4]

6、刪除指定索引 - removeAt (參數為位置)

var list = [1, 2, 6, 4];
list.removeAt(2);
print(list); // [1, 2, 4]

7、刪除指定範圍 - removeRange

var list = [1, 2, 6, 4];
list.removeRange(2, 4);
print(list); // [1, 2]

8、刪除最後一個 - removeLast

var list = [1, 2, 6, 4];
list.removeLast();
print(list); // [1, 2, 6]

9、刪除符合條件的所有元素 - removeWhere

var list = [1, 2, 6, 4, 6];
// 刪除大於3的元素
list.removeWhere((v) => v > 3);
print(list); // [1, 2]

10、刪除所有元素 - clear

var list = [1, 2, 6, 4, 6];
list.clear();
print(list); // []

11、修改陣列中某區間元素為指定值 - setRange

var list = [1, 2, 6, 4, 6];
list.setRange(1, 4, [9, 9, 9]); // 將索引1到4的值修改為9
print(list); // [1, 9, 9, 9, 6]

12、修改指定索引後的陣列值 - setAll

var list = [1, 2, 6, 4, 6];
list.setAll(2, [2, 4, 5]); // 設定索引為2開始的後面3位數分別為2，4，5
print(list); // [1, 2, 2, 4, 5]

13、替換 - replaceRange

var list = [1, 2, 6, 4, 6];
list.replaceRange(0, 4, [3]); // 將索引從0-4的元素替換成3
print(list); // [3, 6]

14、將指定區間替換成某個固定值- fillRange

var list = [1, 2, 6, 4, 6];
list.fillRange(2, 4, 1); // 將區間2到4的元素替換成數值1
print(list); // [1, 2, 1, 1, 6]

15、獲取某個區間的值- getRange  (返回iterable)

// 返回迭代器
var list = [1, 2, 6, 4, 6];
print(list.getRange(2, 4)); // 返回Iterable (6, 4)

16、查詢指定區間的值- sublist  (返回list)

// 返回list
var list = [1, 2, 6, 4, 6];
print(list.sublist(2)); // [6, 4, 6] ， 返回從索引2開始的所有資料
print(list.sublist(2, 4)); // [6, 4]， 返回list從2到4的資料

17、判斷陣列內是否有滿足條件的元素- any

var list = [3, 2, 6, 4, 6];
// 陣列中是否有大於2的元素
print(list.any((v) => v > 2)); // true
// 陣列中是否有大於6的元素
print(list.any((v) => v > 6)); // false

18、判斷陣列所有元素是否都滿足設定條件 - every

var list = [3, 2, 6, 4, 6];
// 陣列中所有元素是否都大於1
print(list.every((v) => v > 1)); // true
// 陣列中所有元素是否都大於2
print(list.every((v) => v > 2)); // false

19、判斷陣列是否包含某個元素 - contains

var list = [3, 2, 6, 4, 6];
// 陣列中是否包含3
print(list.contains(3)); // true
// 陣列中是否包含1
print(list.contains(1)); // false

20、獲取滿足條件的第一個元素 - firstWhere

var list = [3, 2, 3, 6, 4, 3];
// 獲取最後一個大於2的元素
print(list.firstWhere((v) => v > 2)); // 3

// 如果未查詢到所制定條件的元素，進入orElse引數
list.firstWhere((v) => v > 6, orElse: () {
   print(3333); 
});

21、獲取滿足條件的最後一個元素 - lastWhere

var list = [3, 2, 6, 4, 6];
// 獲取最後一個大於4的元素
print(list.lastWhere((v) => v > 4)); // 6 

// 如果未查詢到所制定條件的元素，進入orElse引數
list.lastWhere((v) => v > 6, orElse: () {
   print(3333); 
});

22、從指定位置開始，獲取滿足條件的第一個元素的索引 - indexWhere

var list = [3, 2, 6, 4, 6];
// 查詢第一個大於4的元素索引值
print(list.indexWhere((v) => v > 4)); // 2
// 從索引3開始，查詢第一個大於4的元素索引值
print(list.indexWhere((v) => v > 4, 3)); // 4
// 從索引3開始，查詢第一個大於9的元素索引值
// 若不存在，返回-1
print(list.indexWhere((v) => v > 9, 3)); // -1

23、獲取滿足條件的最後一個元素的索引(倒敘查詢) - lastIndexWhere

var list = [3, 2, 6, 4, 6];
// 獲取最後一個大於4的元素索引值
print(list.lastIndexWhere((v) => v > 2)); // 4
// 從索引2開始，查詢最後一個大於4的元素索引值
print(list.lastIndexWhere((v) => v > 3, 3)); // 2
// 如果沒有，返回-1
print(list.lastIndexWhere((v) => v > 9)); // -1

24、從指定位置開始，獲取指定值的索引 - indexOf

var list = [3, 2, 6, 4, 6];
// 從索引3開始，獲取6第一次出現時的索引值，如果不存在，返回 -1 
print(list.indexOf(6, 3)); // 4
print(list.indexOf(6)); // 2

25、從指定位置開始，倒敘獲取指定值的索引 - lastIndexOf

var list = [3, 2, 6, 4, 6];
// 從索引3開始，獲取6第一次出現時的索引值，如果不存在，返回 -1 
var list = [3, 2, 6, 4, 6];
print(list.lastIndexOf(6, 3)); // 4
print(list.lastIndexOf(6)); // 2
print(list.lastIndexOf(7)); // -1

26、獲取唯一元素 - singleWhere

var list = [3, 2, 6, 4, 6];
// 獲取大於6的唯一元素，不存在該元素，執行orElse
print(list.singleWhere((v) => v > 6, orElse: () {
    print(' --- ');
})); // ---

// 獲取等於2的唯一元素，存在，返回2
print(list.singleWhere((v) => v == 2, orElse: () {
    print(' --- ');
  })); // 2
  
// 獲取等於6的唯一元素，存在該元素，但是出現次數不唯一，不會執行orElse，直接丟擲錯誤，進入catch
print(list.singleWhere((v) => v == 6, orElse: () {
    print(' --- ');
})); // error

27、將陣列用指定字元拼接成字串 - join

var list = [3, 2, 6, 4, 6];
// 將陣列轉換為用&拼接的字串
print(list.join('&')); // 3&2&6&4&6

28、將陣列轉為Set類別，去除重複值 - toSet 

var list = [3, 2, 6, 4, 6];
 print(list.toSet()); // {3, 2, 6, 4}

29、陣列遍歷 - forEach （沒有回傳）

var list = [3, 2, 6, 4, 6];
list.forEach((element) {
	// element 為list內的每個元素
    print(element);
    /*
       3
       2
       6
       4
       6
     */
});

30、按指定條件返回Iterable - map （有回傳）

var list = [3, 2, 6, 4, 6];
// 將list所有元素加1並返回Iterable
var x = list.map((e) {
 return e + 1; 
});
print(x); //(4, 3, 7, 5, 7)
// 將list所有元素與4比較並返回boolean Iterable
var y = list.map((e) {
  return e > 4;
});
print(y);//(false, false, true, false, true)

31、累加 - reduce

var list = [3, 2, 6, 4, 6];
// 將每次返回值作為value迴圈執行。最終返回最後一次執行值
var x = list.reduce((value, element) {
  print('value: $value - element: $element');
  /**
  	每次的執行結果
  	value: 3 - element: 2
	value: 5 - element: 6
	value: 11 - element: 4
	value: 15 - element: 6
  */
  return value + element;
});
print('x: $x'); // x: 21

32、排序 - sort

var list = [3, 2, 6, 4, 6];
// 按回調中的return結果正負數來排序
// a - b 為升序， b - a為降序
list.sort((a, b) {
  return a - b;
});
print(list); // [6, 6, 4, 3, 2]

33、由0取值至指定索引位置 - take

var list = [3, 2, 6, 4, 6];
print(list.take(2)); // 3,2

34.由指定索引位置取值至最後一個元素-skip

var list = [3, 2, 6, 4, 6];
print(list.skip(2)); // 6,4,6

35.複製另一個陣列的值 - from

Final numbers = num[1,2,3];
//從某陣列複製內容，並將型態轉變
Final list = List<int>.from(numbers);
print(list); // [1,2,3]

36.刪除條件陣列中不符合條件的數 - retainWhere

List<String> list = [a,b,c,d,e];
//生成10組陣列
list.retainWhere((e) => e.compareTo("b") > 0 && e.compareTo("e") < 0);
print(list); // [c,d]

37.隨機打亂陣列順序 - shuffle

List<String> list = [a,b,c,d,e];
//隨機打亂
list.shuffle();
print(list); // [c,d,a,b,e]

38.將設置的開頭與陣列中的每個值結合 - fold

List<String> list = [a,b,c,d,e];
var list2=list.fold('start:'(e)=>return '$e1 $e2';);
print(list2); 
// [c,d,a,b,e]

39.重複擴充陣列內的內容 - expand

List<String> list = ['a','b','c','d','e'];
List<String> result=list.expand((e)=>[e,e]).toList();
print(result); 
// [a,a,b,b,c,c,d,d,e,e]

39.返回符合後面條件的Iterable - where

  List<int> list = [1, 2, 3, 4, 5, 6];
  Iterable<int> result1 = list.where((e) => e > 3);
  List<int> result2 =list.where((e) => e > 3).toList();

  print(result1);
  print(result2);
  
  //(4, 5, 6)
  //[4, 5, 6]

40.自動生成大量數值陣列 - generate

List<String> list = [];
//生成10組陣列
list = List<String>.generate(10, (i) => "$i");
print(list); 
// [0,1,2,3,4,5,6,7,8,9]

41.強制改變List中的數值類型- cast

List<String> list = ['1','2','3'];
//強制將int轉換成String
List<int> newint = List.cast<int>();
print(newint.runtimeType);