仓颉语言开发指南

main(): Unit {
    println("Hello, World!")
}

let x: Int64 = 10
let PI = 3.14      // 推断：Float64
var name = "Alice"   // 可变变量

// let vs var
let y = 20  // 不可变（推荐，类似 final）
var z = 20  // 可变

// 空安全：用 Option 表达"可能没有值"
let s: String = "hi"        // 非空，不能赋空
let s: ?String = None  // 可空，?String = Option<String>
let s: Option<String> = Some("hi")

let name = "Alice"
let age = 18
let s = "Name: ${name}, Age: ${age}"
// 表达式嵌入
let msg = "Next year: ${age + 1}"

// if 是表达式，直接赋值！
let label =
    if (score >= 60) {
        "pass"
    } else {
        "fail"
    }
// 不需要三元运算符

let msg = match (day) {
    case "sat" | "sun" => "weekend"
    case _ => "weekday"
}

// 范围/条件匹配：用守卫 where
let grade = match (score) {
    case s where s >= 90 => "A"
    case s where s >= 80 => "B"
    case s where s >= 60 => "C"
    case _ => "D"
}

// 半开区间 [0, 10)
for (i in 0..<10) { }
// 闭区间 [1, 10]
for (i in 1..=10) { }

// 遍历集合
for (s in list) { }

while (cond) { }

// 最后一项表达式即返回值
func add(a: Int64, b: Int64): Int64 {
    a + b
}
// 多返回值：用元组
func divMod(a: Int64, b: Int64): (Int64, Int64) {
    (a / b, a % b)
}

interface Drawable {
    func draw(): Unit
}
open class Shape {
    public func draw(): Unit {}
}
// <: 表示继承/实现；& 连接多个接口
class Circle <: Shape & Drawable {
    public override func draw(): Unit {}
}

// 非空类型不能赋 None
let s: String = None      // ❌ 编译错误
let s: ?String = None    // ✅ 可空

// 可选链 ?. 与空合并 ??
let len = s?.length        // ?String 类型
let len = s ?? ""        // s 为 None 时用 "" 

// 用 match 解构（穷尽，编译器强制处理 None）
match (s) {
    case Some(v) => println(v.length)
    case None => println("no value")
}

match (obj) {
    case d: Dog => d.bark()
    case c: Cat => c.meow()
    case _ => println("unknown")
}

// 给已有类型"追加"方法，无需改源码
extend String {
    public func isInt(): Bool {
        match (toInt64()) {
            case Some(_) => true
            case None => false
        }
    }
}
"123".isInt()  // true，像原生方法一样调用

let res = list
    .filter { s => s.size > 3 }
    .map { s => s.toUpperCase() }

import std.sync.*

func fetchData(url: String): Future<String> {
    spawn {
        return httpGet(url)  // 返回值即 Future 的结果
    }
}
main(): Unit {
    let fut = fetchData("https://x.com")
    let r = fut.get()   // 阻塞等待结果
    println(r)
}

try {
    let x = 10 / 0
} catch (e: ArithmeticException) {
    println(e)
} finally {
    cleanup()
}

class Box<T> {
    var value: T
    public init(v: T) { value = v }
    public func get(): T { value }
}
// 编译期为 Box<String>、Box<Int64>
// 各自生成真实类型代码