Local Functions in Kotlin

Introduction

Local Functions is a fundamental concept every Kotlin developer should understand. Functions are first-class in Kotlin — parameters, return types, and concise syntax make APIs easy to read and reuse.

A function declared inside another function is called a local function. In this tutorial you will learn the syntax, walk through a complete example program, study the sample output, and review best practices so you can apply the concept confidently in your own projects.

Definition

• A function declared inside another function is called a local function.
• Local functions can access variables from the enclosing function.
• They help break large functions into smaller, private steps.

Syntax

fun outer() {
    fun inner() { }
    inner()
}

Local Functions in Kotlin Example Program in Kotlin

fun printRange(start: Int, end: Int) {
    fun validate(value: Int) = value in start..end
    for (i in start..end) {
        if (validate(i)) println(i)
    }
}

fun main() {
    printRange(1, 3)
}

Sample Output

1
2
3

When to use

Use default and named parameters to reduce overloads; use single-expression functions for small pure helpers.

How it works

1. The program starts with a main function — the entry point that runs when you execute the file.

2. A function declared inside another function is called a local function.

3. Run the program in IntelliJ IDEA, Android Studio, or with the Kotlin command-line compiler (kotlinc / kotlin). Compare your console output with the sample output shown below.

Best Practices

Common Mistakes

Key Points

• A function declared inside another function is called a local function.
• Local functions can access variables from the enclosing function.
• They help break large functions into smaller, private steps.
• Test the example locally and verify the output matches the sample.
• Experiment by changing input values to see how behaviour changes.

Notes

• Semicolons at the end of statements are optional in Kotlin.