#Swift The difference between Parameter and Agrument

看文档时候总看到 parameters 和 arguments 这两个词。中文意思都是参数，总是弄混淆，这里专门写一下区别做记录，前面是形参，后面是实参。

Argument Label（实参标签）是 Swift 中函数、方法或初始化器定义的一部分，用于在调用函数时为参数提供更具描述性和可读性的标签。它可以帮助开发者在调用函数时明确每个实参的作用，提高代码的可读性。

参数标签（Argument Label）和参数名称（Parameter Name）的区别

• 参数名称（Parameter Name）：用于函数或方法的内部，函数体内部使用参数名称来访问传入的值。
• 实参标签（Argument Label）：用于函数或方法的外部，调用函数时使用的名称。调用者通过这个标签来传递对应的实参。

在 Swift 中，参数可以同时有一个参数名称 和一个实参标签。实参标签通常用于提升代码的可读性。

示例：参数标签和参数名称

func greet(person name: String) {
    print("Hello, \(name)!")
}

在这个函数中：

• person 是实参标签，用于调用时标识该参数的作用。
• name 是参数名称，在函数体内部使用，用来表示实际传递进来的值。

调用这个函数时，实参标签 person 被用于描述参数的意义：

greet(person: "Alice")
// 输出: Hello, Alice!

在函数调用时使用 person: "Alice"，person 作为实参标签使调用更具可读性，明确传递的字符串是表示一个人。

默认的实参标签

默认情况下，Swift 的每个参数都会使用其参数名称 作为实参标签。也就是说，如果你不显式定义实参标签，Swift 会默认使用参数名称作为实参标签。

示例：没有显式指定实参标签

func add(a: Int, b: Int) -> Int {
    return a + b
}

let result = add(a: 5, b: 3)  // 使用默认的实参标签
print(result)  // 输出: 8

在这个例子中，a 和 b 是参数名称和实参标签，因为没有显式指定实参标签，Swift 默认将它们作为实参标签。

自定义实参标签

你可以在函数定义中显式指定实参标签，以使调用时的标签更加具描述性。自定义实参标签可以使函数调用更清晰。

示例：显式定义实参标签

func move(toX x: Int, toY y: Int) {
    print("Moving to (\(x), \(y))")
}

move(toX: 10, toY: 20)  // 使用自定义实参标签

在这个例子中，toX 和 toY 是自定义的实参标签，x 和 y 是参数名称。实参标签 toX 和 toY 使得调用函数时能够清晰描述要移动的方向，而参数名称 x 和 y 只在函数内部使用。

使用 _ 省略实参标签

在某些情况下，如果你不希望调用函数时使用实参标签，可以使用下划线（_）来省略实参标签。这样，调用函数时就只需要传递参数值，而不需要使用标签。

示例：省略实参标签

func multiply(_ a: Int, _ b: Int) -> Int {
    return a * b
}

let result = multiply(5, 3)  // 省略实参标签
print(result)  // 输出: 15

在这个例子中，_ 用于省略实参标签，因此调用 multiply 时不需要提供标签，直接传入参数值。

参数标签的好处

1. 提高可读性：参数标签可以使函数调用更加自描述，从而提升代码的可读性。特别是当函数有多个相似类型的参数时，使用标签可以明确实参的含义。

2. 帮助文档化：参数标签作为函数调用的一部分，类似于文档化代码的功能，能让代码更具描述性。

示例：多个相似类型参数的函数

func divide(numerator: Int, denominator: Int) -> Int {
    return numerator / denominator
}

let result = divide(numerator: 10, denominator: 2)  // 使用参数标签明确含义
print(result)  // 输出: 5

在这个例子中，参数标签 numerator 和 denominator 明确了调用 divide 函数时传入的两个整数的含义，即谁是分子，谁是分母。相比于不使用标签的版本，调用 divide(10, 2)，标签使得函数调用更加清晰和直观。

总结

• 实参标签（Argument Label）：用于函数调用时，标识函数参数的意义。它提升了代码的可读性。
• 参数名称（Parameter Name）：用于函数内部，标识传入的值。
• 默认标签：如果没有指定实参标签，Swift 默认使用参数名称作为实参标签。
• 自定义标签：你可以为参数显式指定实参标签，使函数调用更加具有描述性。
• 省略标签 ：通过使用 _ 省略实参标签，使调用更加简洁。

参数标签在 Swift 中为开发者提供了一种更灵活的方式来定义和调用函数，使代码既清晰又简洁。