编辑“︁Kotlin函数调用”︁

{{Note|本文介绍Kotlin函数调用的基本语法、高级特性及实际应用场景，适合初学者和需要巩固知识的开发者。}}

= Kotlin函数调用 =

'''函数调用'''是执行函数中定义的操作的过程，在Kotlin中通过函数名和参数列表实现。Kotlin支持多种调用方式，包括标准调用、命名参数、默认参数、中缀调用等，并兼容Java的互操作性。

== 基础调用 ==
最简单的调用形式是直接使用函数名和括号传递参数：

<syntaxhighlight lang="kotlin">
fun greet(name: String) {
    println("Hello, $name!")
}

fun main() {
    greet("Alice")  // 输出: Hello, Alice!
}
</syntaxhighlight>

=== 参数传递规则 ===
* 位置参数：按声明顺序传递
<syntaxhighlight lang="kotlin">
fun sum(a: Int, b: Int) = a + b
sum(3, 5)  // 输出: 8
</syntaxhighlight>

* 命名参数：明确指定参数名
<syntaxhighlight lang="kotlin">
sum(b = 5, a = 3)  // 输出: 8
</syntaxhighlight>

== 高级调用方式 ==
=== 默认参数 ===
允许省略有默认值的参数：
<syntaxhighlight lang="kotlin">
fun log(message: String, level: Int = 1) {
    println("[$level] $message")
}

log("Info")        // 输出: [1] Info
log("Error", 3)    // 输出: [3] Error
</syntaxhighlight>

=== 可变参数 ===
使用{{code|vararg}}关键字：
<syntaxhighlight lang="kotlin">
fun printAll(vararg messages: String) {
    for (m in messages) println(m)
}

printAll("A", "B", "C")  // 输出三行: A \n B \n C
</syntaxhighlight>

=== 中缀函数 ===
需满足以下条件：
1. 成员函数或扩展函数
2. 单参数
3. 使用{{code|infix}}修饰符

<syntaxhighlight lang="kotlin">
infix fun Int.add(x: Int) = this + x

fun main() {
    val result = 5 add 3  // 等同于5.add(3)
    println(result)       // 输出: 8
}
</syntaxhighlight>

== 函数类型调用 ==
Kotlin中函数是一等公民，可将函数赋值给变量：
<syntaxhighlight lang="kotlin">
val operation: (Int, Int) -> Int = ::sum
println(operation(2, 4))  // 输出: 6
</syntaxhighlight>

=== Lambda调用 ===
<syntaxhighlight lang="kotlin">
val square: (Int) -> Int = { x -> x * x }
println(square(4))  // 输出: 16
</syntaxhighlight>

== 实际应用案例 ==
=== 配置构建器模式 ===
利用命名参数和默认参数实现DSL：
<syntaxhighlight lang="kotlin">
class Config {
    var timeout: Int = 1000
    var retries: Int = 3
}

fun configure(block: Config.() -> Unit): Config {
    val config = Config()
    config.block()
    return config
}

val config = configure {
    timeout = 2000
    retries = 5
}
</syntaxhighlight>

=== 数学计算器 ===
展示多种调用方式的组合：
<syntaxhighlight lang="kotlin">
fun calculate(
    op: Char,
    vararg numbers: Double,
    precision: Int = 2
): Double {
    require(numbers.isNotEmpty()) { "至少需要一个操作数" }
    val result = when(op) {
        '+' -> numbers.sum()
        '*' -> numbers.fold(1.0) { acc, d -> acc * d }
        else -> throw IllegalArgumentException("未知操作符")
    }
    return "%.${precision}f".format(result).toDouble()
}

// 调用示例
calculate('+', 1.5, 2.3, precision = 3)  // 输出: 3.800
calculate('*', 2.0, 3.0, 4.0)           // 输出: 24.00
</syntaxhighlight>

== 性能考虑 ==
通过流程图说明调用过程：
<mermaid>
graph TD
    A[调用开始] --> B{是否内联函数?}
    B -->|是| C[直接插入函数体]
    B -->|否| D[创建调用栈帧]
    D --> E[参数压栈]
    E --> F[执行函数体]
    F --> G[返回结果]
</mermaid>

== 与Java互操作 ==
Kotlin调用Java方法时需注意：
* 可变参数需用{{code|*}}展开操作符
* 避免命名参数（Java字节码不保留参数名）
* 处理空安全注解

<syntaxhighlight lang="kotlin">
// Java方法
public class JavaUtils {
    public static String join(String... parts) {
        return String.join(",", parts);
    }
}

// Kotlin调用
val parts = arrayOf("A", "B", "C")
JavaUtils.join(*parts)  // 输出: A,B,C
</syntaxhighlight>

== 最佳实践 ==
1. 优先使用命名参数增强可读性
2. 复杂参数组合使用默认参数
3. 超过3个参数考虑使用Builder模式
4. 高频调用的简单函数声明为{{code|inline}}
5. 避免过度使用中缀表示法

{{Warning|在Android API <24上，默认参数会生成额外方法可能导致方法数限制问题，需使用{{code|@JvmOverloads}}注解。}}

== 参见 ==
* [[Kotlin函数声明]]
* [[Kotlin Lambda表达式]]
* [[Kotlin高阶函数]]

[[Category:编程语言]]
[[Category:Kotlin]]
[[Category:Kotlin函数]]