func greet(to name: String) {
//         ^^  ^^^^
//      外部名  内部名
    print("Hello, \(name)")  // 内部用 name
}

greet(to: "张三")  // 调用时用 to

// 没有下划线 - 需要参数标签
func swap(a: inout Int, b: inout Int) {
    let temp = a
    a = b
    b = temp
}
swap(a: &x, b: &y)  // 必须写 a: 和 b:

// 有下划线 - 省略参数标签
func swap(_ a: inout Int, _ b: inout Int) {
    let temp = a
    a = b
    b = temp
}
swap(&x, &y)  // 直接传值

// 1. 外部名 ≠ 内部名
func greet(to name: String) { }
greet(to: "Alice")

// 2. 外部名 = 内部名（省略写法）
func greet(name: String) { }
greet(name: "Alice")

// 3. 省略外部名（用下划线）
func greet(_ name: String) { }
greet("Alice")

// of - "...的"
func price(of product: String) -> Double { }
price(of: "iPhone")

// for - "为了..."
func search(for keyword: String) { }
search(for: "Swift")

// in - "在...中"
func find(in array: [Int]) { }
find(in: [1, 2, 3])

// with - "用..."
func connect(with server: String) { }
connect(with: "api.example.com")

// to/from - "到.../从..."
func send(to user: String) { }
send(to: "admin")

func load(from path: String) { }
load(from: "/data/file.json")

// 1. 参数含义明显
func square(_ n: Int) -> Int { return n * n }
square(5)

// 2. 数学运算
func add(_ a: Int, _ b: Int) -> Int { return a + b }
add(3, 5)

// 3. 简单操作
func print(_ message: String) { }
print("Hello")

// 4. 类型转换
func convert(_ value: Double) -> Int { return Int(value) }
convert(3.14)

// 1. 多个相似类型参数
func transfer(from sender: String, to receiver: String, amount: Double) { }
transfer(from: "Alice", to: "Bob", amount: 100)  // ✅ 清晰

func transfer(_ sender: String, _ receiver: String, _ amount: Double) { }
transfer("Alice", "Bob", 100)  // ❌ 容易混淆

// 2. 参数含义不明显
func showAlert(title: String, message: String) { }
showAlert(title: "错误", message: "网络失败")  // ✅ 清晰

func showAlert(_ title: String, _ message: String) { }
showAlert("错误", "网络失败")  // ❌ 不够清晰

// 3. 需要说明关系
func filter(data: [Int], where condition: (Int) -> Bool) { }
filter(data: [1, 2, 3], where: { $0 > 2 })  // ✅ 语义明确

class DataManager {
    // 获取用户（用 with 说明关系）
    func user(with id: String) -> User? {
        return nil
    }

    // 保存数据（用 to 说明目标）
    func save(to path: String, data: Data) {
        // 保存逻辑
    }

    // 查找元素（用 in 说明范围）
    func find(in collection: [String], matching keyword: String) -> [String] {
        return collection.filter { $0.contains(keyword) }
    }
}

// 使用
let manager = DataManager()
manager.user(with: "12345")
manager.save(to: "/data/file.txt", data: someData)
manager.find(in: ["apple", "banana"], matching: "app")

// 简单验证（用下划线）
func isValidEmail(_ email: String) -> Bool {
    return email.contains("@")
}

isValidEmail("test@example.com")  // 简洁

// 复杂验证（用参数名）
func validate(email: String, checkFormat: Bool, checkDomain: Bool) -> Bool {
    // 验证逻辑
    return true
}

validate(email: "test@example.com", checkFormat: true, checkDomain: false)  // 清晰

// 用了下划线的函数
print("Hello")           // 不需要参数名
max(10, 20)              // 含义明显
abs(-5)                  // 简洁直观
String(123)              // 类型转换

// 需要参数名的函数
String(repeating: "*", count: 5)  // 需要说明
[1, 2, 3].firstIndex(of: 2)       // 需要说明关系

func increment(_ value: inout Int) {
    value += 1
}

var count = 10
increment(&count)  // 传递引用
print(count)       // 11

// ✅ 好的例子
print("Hello")                              // 自然
max(10, 20)                                 // 清晰
showAlert(title: "提示", message: "完成")   // 易懂
transfer(from: "Alice", to: "Bob", amount: 100)  // 语义明确

// ❌ 不好的例子
print(message: "Hello")                     // 啰嗦
showAlert("提示", "完成")                   // 不清晰
transfer("Alice", "Bob", 100)               // 容易混淆