update: clarifications on basic functions usage #5155
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This comment was marked as outdated.
This comment was marked as outdated.
zamulla
force-pushed
the
functions-updates
branch
from
866baf7 to
397049f
Compare
serras
reviewed
Nov 13, 2025
docs/topics/functions.md
Outdated
| ``` | ||
|
|
||
| Such parameters are also referred to as _optional parameters_. | ||
| If a parameter with default value precedes a parameter with no default value, the default value can only be used by calling |
Contributor
There was a problem hiding this comment.
This sentence is a bit hard to read
Contributor
There was a problem hiding this comment.
Also, I think it needs a bit more nuance when you have trailing lambdas
serras
reviewed
Nov 13, 2025
docs/topics/functions.md
Outdated
| If a function does not return a useful value, its return type is `Unit` (corresponds to the `void` type in Java). | ||
|
|
||
| `Unit` is a type with only one value - `Unit`. | ||
| You don't have to declare this return type, or return `Unit` explicitly. |
Contributor
There was a problem hiding this comment.
This is not entirely true. You still very much use Unit in functional types:
fun also(block: T.() -> Unit): T { ... }
Contributor
There was a problem hiding this comment.
Also, I think it's important to clarify that Unit is only assumed as the return type when you use braces to define the function. Otherwise, the type is inferred to the result type of the expression.
serras
reviewed
Nov 13, 2025
serras
approved these changes
Nov 16, 2025
zamulla
force-pushed
the
functions-updates
branch
from
ff03575 to
deba8dc
Compare
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
No description provided.