In this tutorial, you will learn pretty much each of the 4 visibility modifiers in Kotlin and how they work in various situations.
Visibility modifiers are the keywords which are used to restrict the use of class, interface, methods, and property of Kotlin in the application.
Visibility modifiers are keywords that set the visibility (accessibility) of classes, objects, interface, constructors, functions, properties and their setters. (You can’t set visibility modifier of getters as they generally take the same visibility as that of the property.)
In Kotlin Class and Objects tutorial, you learned about visibility modifiers public and private in a nutshell. You will learn about two more visibility modifiers protected and internal (just as public and private) in detail.
Visibility Modifiers Inside Package
A package organizes a set of related functions, properties and classes, objects, and interfaces. Suggested reading: Kotlin Packages
Modifier | Description |
public | declarations are visible everywhere |
private | visible inside the file containing the declaration |
internal | visible inside the same module (a set of Kotlin files compiled together) |
protected | not available for packages (used for subclasses) |
Note: If visibility modifier isn’t indicated, it is public by default.
Let’s take an example:
// file name: hello.kt package test fun function1() {} // public by default and visible everywhere private fun function2() {} // visible inside hello.kt internal fun function3() {} // visible inside the same module var name = "Foo" // visible everywhere get() = field // visible inside hello.kt (same as its property) private set(value) { // visible inside hello.kt field = value } private class class1 {} // visible inside hello.kt
Visibility Modifiers Inside Classes and Interfaces
Here’s the means by which visibility modifiers works for individuals (functions, properties) pronounced inside a class:
Modifier | Description |
public | visible to any client who can see the declaring class |
private | visible inside the class only |
protected | visible inside the class and its subclasses |
internal | visible to any client inside the module that can see the declaring class |
Note: If you override a protected part in the determined class without indicating its visibility, its visibility will likewise be protected.
Let’s take an example:
open class Base() { var a = 1 // public by default private var b = 2 // private to Base class protected open val c = 3 // visible to the Base and the Derived class internal val d = 4 // visible inside the same module protected fun e() { } // visible to the Base and the Derived class } class Derived: Base() { // a, c, d, and e() of the Base class are visible // b is not visible override val c = 9 // c is protected } fun main(args: Array<String>) { val base = Base() // base.a and base.d are visible // base.b, base.c and base.e() are not visible val derived = Derived() // derived.c is not visible }
Changing Visibility of a Constructor
By default, the visibility of a constructor is public. In any case, you can change it. For that, you need to explicitly add constructor watchword.
The constructor is public by default in the example beneath:
class Test(val a: Int) { // code }
Here’s how you can change its visibility.
class Test private constructor(val a: Int) { // code }
Here the constructor is private.
Note: In Kotlin, local functions, variables and classes cannot have visibility modifiers.
Thanks for reading! We hope you found this tutorial helpful and we would love to hear your feedback in the Comments section below. And show us what you’ve learned by sharing your photos and creative projects with us.