探討 Dart 語言：宣告、數據類型、操作符 | 從基礎到應用指南

A. 所有的東西都是物件，甚至包含 Java 的基礎類型 (eg. int)

B. Dart 是弱類型語言，不必指定數據類型

C. 指定數據類型、const 常量可以提高運行速度

D. Dart 是 AOT (Ahead Of Time) 編譯，在安裝前會先進行預編譯，編譯成本地代碼 (Dart to java or object-c)

E. Dart 也可以 JIN (Just In Time) 編譯

F. 以 60fps 運行的流暢動畫和轉場，可以在沒有鎖的時候進行物件分配 & 垃圾回收，Dart 避免了線程的搶佔 (線程的特性與 Java 不同)

G. 代碼即是布局，不須另外使用另一個語言建構 (Android 使用 Xml 建構)

A. 統一的程序入口 main()，這一點如同 C、Java 語言

B. 並沒有 public、protected、private 的參數訪問限制概念，但 私有可以變量可以使用下滑線 ( _ ) 來表示

int hello;

int _hello; // 私有

C. 支持異步處理 anync/ await

D. 所有函數都有函數返回值！ 如果沒有返回值默認返回為 null

void main() {
  print('Hello World');

  // 使用 Object 宣告
  Object o1 = 1;
  o1 = "1";

    
  // 使用 var 宣告
  var v1 = 1;
  //v1 = "1";   // v1 已定型不可再改（自動推導）

    
  // 使用 var 宣告
  var v2;
  v2 = 1;
  v2 = "1";     // 兩個完全不同物件，v2 類似於 const 指標

    
  // 使用 dynamic 宣告
  dynamic d1 = 1;    // 與 Object 差異是 dynamic 是在運行時確定
  d1 = "1";

  Object name1 = 'Alien';
  var name2 = 'Pan';
  dynamic name3 = 'Kyle';

  print("$name1, $name2, $name3");
}

// 函數入參，未聲明就是動態類型 dynamic，如下
void testPrint(a) {
}

void testPrint2(dynamic a) {
}

● 不同語言的 var 所造成的差異（編譯期間）

● 在 JS 中也有 var 這種宣告方式，但 JS 是「動態類型語言」（python 也是），可在賦予值後重新設定不同的類型

// JS
var k = "Hello JS"
k = 3;        // okay

● Dart 則是「靜態類型語言」，在賦值時就被定義（自動推倒）

// Dart 在賦值時就被定義類型
var k = "Hello Dart";
k = 10;       // Err !!!


var j;    // 尚未被定義就是 null 也就是 object
j = "Hello Dart";
j = 20;      // Okay !!!

void main() {
  final String FINAL_NAME = "Apple";
  const String CONST_NAME = "Banana";

  //const String TEMP = FINAL_NAME; //  Err: 運行時確定
  final String TEMP_2 = CONST_NAME; // okay
}

class MyClass {
  final String TAG_1 = "MyClass";
  // const String TAG_2 = "MyClass";    // Err: 如同 C++ 的 const 概念使用
  // const 定義在類中，必須使用 static 描述 -> static const 
  static const String TAG_3 = "MyClass";
}

● 運行時 final 不可以賦予給編譯時常量 const，因為 const 必須編譯期就確定，而相反操作過來就可以，因為 final 運行時再確認即可

所以被 const 描述的稱之為常量，它的效能往往會比被 final 描述的更好，因為它在編譯過後就被確定類型

● const & final 不可以跟 var 一起使用

● Dart 與 Java 語言對於數字類型的看待、差異

A. Dart 只有 int(整) & double(浮點數)，而沒有 float、short...

B. 數字類型佔用字節數（byte）的差異：int 在 java 中占用 4 個字節，dart 則會依照平台而改變，屬於動態改變自節數

// Dart
int i = 2;
print('int cost byte: ${i.bitLength}');    // 可看當前需要多少個 bit

A. 基礎差異：總體來說比起 Java 使用起來更加的自由

void testString() {
  String s1 = "Apple";
  // 使用 ${} 可直接引用其他字串，若是單個詞可省略大括號 {}
  String s2 = "This is $s1";
  print(s2);
  String s2_1 = 'This is $s1';  // 單、雙引號都可引用，groovy 單引號則不行
  print(s2_1);

  // 傳統跳脫字元 `\`，並且可以如同 Java 使用 `+` 號
  String s3 = "This is \"${s1 + "!"}\" ";
  print(s3);
  // 嵌套使用
  String s4 = 'This is "${s1 + "!"}" ';
  print(s4);

  // 三個單引號 or 雙引號可以使用換行字串
  String s5 = """
  Hello
  World
  EveryBody
  """;
  print(s5);
  String s6 = '''
  Apple
  Banana
  Car
  ''';
  print(s6);

  // 原始字 raw -> r""
  String s7 = r"\n";  // 跳脫字元不起作用
  String s8 = "\n";
  print(s7);


  String rType = r"\n";   // r 可輸出元形 "\\n"
  print(rType);
}

B. 特殊字元差異

// Java
void main() {
  String str = "\uA388\uA388";

  println(str);
}

// Dart
void main() {
  var clapping = '\u{1f44f}';
  print("$clapping");

  var test = '\u1f44f';  // 超過未使用  其實就是 '\u1f44' + 字串 ｆ
  print("$test");

  var test2 = '\uf44f';  // 未超過
  print("$test2");

}

● Dart String 字串長度的陷阱（關鍵字: 代碼點 & 代碼單元）

代碼單元：String#length 只是大部分是「字符長度」，但並不完全代表代碼單元數量… 假設字符串是以 UTF-16 編碼存儲的（Dart、Java 就是如此），一個代碼單元是 16 位的整數

代碼點：Unicode 編碼中每個字符對應的一個整數值，也就是儘管超過程式語言的代碼編制長度，也會算成是一個整數值

範例如下

void main() {

  String testLen = "\u5566\u7788";

  print("${testLen.length}");

}

void testBool() {
    bool flag = false;

    String msg = flag ? "Hello" : "World";

    print(msg);
}

以下我們會特別加入 const 的使用，並與 C/C++ 比較 (有相似之處)；

● const 如果放在宣告物件的描述，會讓該物件的引用、內容皆不可修改

● 但如果 const 只放在建立物件實例的描述，則該物件的引用可以修改，而物件的實例內容則不能修改！

void testList() {
// 創建方法 1
  List list1 = new List();
// 創建方法 2，省略 new
  List list2 = List();
// 創建方法 3
  List list3 = [0,1,2,3];
// 下標 index 取值
  print("list3[1]: ${list3[1]}");

  list3.add(44);
  print("list3[4]: ${list3[4]}");

  // 1. const 修飾引用 & 內容
  const List list4 = [1,3,5,7,9];
//  list4.add(123);     Err: 編譯期間會錯誤
//  list4[3] = 10;      Err: 內容也會被修飾
//  list4 = list3;      Err: 引用指標也會被修飾

  // 2. const 修飾內容
  List list5 = const [9,7,5,3,1];
  print(list5);
  list5 = list4;        // 指標未被修飾，可以修改引用指標
//  list5[0] = 333;     Err: const 修飾內容
  // list5.add(55);    Err: const 修飾內容
  print(list5);
}

void testMap() {

  // Map 創建方法 1
  Map map1 = new Map();
  // Map 創建方法 2
  Map map2 = Map();
  // Map 創建方法 3
  Map map3 = {'A': 1, 'B': 2, 'C': 3};

  print("map3[A]: ${map3['A']}");
  print("map3[B]: ${map3['B']}");
  print("map3[C]: ${map3['C']}");

  const Map map5 = {'A': 1};
//  map5['A'] = 3;
  var map6 = const {'A': 1};

  // 直接"自動"拓展 !!!
  map3['D'] = 4;
  print("map3[D]: ${map3['D']}");

}

Dart 特別分出兩個單詞：代碼點、代碼單元

void testRunes() {
  // \u{1f44f} 是超過 2Byte 的數據
  String str = "\u{1f44f}";
  print("String: $str, ${str.length}");

  var r = "\u{1f44f}";
  print("var: $r");

  var clapping = '\u{1f44f}'; // 超過 unsigned 2 Byte 需要使用大括號 {} 
  print(clapping); //👏
  // 16位代碼單元
  print(clapping.codeUnits); // 超過 16 位[55357, 56399]
  // 獲得完整的 32 位代碼單元
  print(clapping.runes.toList()); //輸出 10 進位 [128079]
  
  // 取得 codePointCount
  print("Code point count: ${clapping.runes.length}");

//fromCharCode 根據字節碼（Byte）創建字符串
  print( String.fromCharCode(128079));
  print( String.fromCharCodes(clapping.runes));
  print( String.fromCharCodes([55357, 56399]));
  print( String.fromCharCode(0x1f44f));

  Runes input = new Runes(
      '\u2665  \u{1f605}  \u{1f60e}  \u{1f47b}  \u{1f596}  \u{1f44d}');
  print("Runes: " + String.fromCharCodes(input));
}

● Java 如何儲存超過 2Byte 的字串？

以往 Java String 類型無法放置超過 2Byte 的數據，如果要儲存就要使用 \u 開頭的方式來表達，範例如下

public static void main(String[] args) {
    String over2Byte = "\uD83D\uDC4F";

    System.out.println("length: " + over2Byte.length());
}

而 String#length() 方法是在 UCS-2（Unicode 的其中一種）編碼下所返回的單元（Byte）數量

void testSymbol() {
  Symbol symbol1 = #Hello;

  switch(symbol1) {
    case #Hello:
      print(symbol1);
      break;

    case #World:
      print("World");
      break;
  }

  Symbol symbol2 = new Symbol("Book");
  print("#Book == symbol2: ${#Book == symbol2}");
}

void testDecide() {
  int a = 10;
  double b = 11.11;

  // as
  // int & double 無法互轉
  //print("b as int: ${b as int}");

  // is
  if(a is int) {
    print("a is int");
  }

  // is!
  if(b is! int) {
    print("b is not int");
  }
}

以 Java、Dart 兩種語言來比較：

// 使用 Dart 表達… 若 b == null 則將 value 賦予 b，若有值則不改變
b ??= value;    


// 使用 Java 表達… 等同於上 ??= 操作符
if(b == null) {
    b = value;
}

操作符 ??= 使用範例如下：

void printMessage(String? msg) {
  msg ??= "No message";
  print(msg);
}

void main() {
  printMessage('Hello world');

  printMessage(null);
}

以 Java、Dart 兩種語言來比較：

// 使用 Dart 表達… 先執行 expr1 如果為 null ，則換執行 expr2 返回
expr1 ?? expr2


// 使用 Java 表達… 
int function() {
    if(expr1 == null) {
        return expr2
    }
    return expr1;
}

操作符 ?? 使用範例如下：

void printMessage2(String? msg) {
  print(msg ?? "No message");
}

void main() {
  printMessage2('Hello world');

  printMessage2(null);
}

以 Java、Dart 兩種語言來比較：

// 使用 Dart 表達… 如果 expr1 不為 null，則執行 method 方法
expr1?.method();


// 使用 Java 表達… 功能同上
if(expr1 != null) {
    expr1.method();
}

操作符 .? 使用範例如下：

void printMessage3(String? msg) {
  final length = msg?.length;

  print('message len: $length');
}


void main() {
  printMessage3('using operation `.?`');

  printMessage3(null);
}

這種操作尤其可以使用在「建造者 builder 模式」

void testLink() {

  MyBuilder builder = MyBuilder(); // 可省略 new 關鍵字

  builder..setName("Alien")..setId(123)..setPhone('456')..show();
}

class MyBuilder {
  String? _name;
  int? _id;
  String? _phone;


  void setName(String name) {
    _name = name;
    // 一般 Java 製作 builder 模式就必須返回此類 this 物件
  }

  void setId(int id) {
    // 使用級聯則不用
    _id = id;
  }

  void setPhone(String phone) {
    // 可接續使用
    _phone = phone;
  }

  void show() {
    print('name($_name}), id($_id), phone($_phone)');
  }
}

void main() {
  var message = ['Hello', 'World', '123'];

  print(['你好', '世界', '456', ...message]);
}