Skip to content

Commit c5fe501

Browse files
authoredFeb 6, 2022
Упростить условия именования аргументов (#18)
Closes #12
1 parent e9fabfa commit c5fe501

File tree

1 file changed

+14
-24
lines changed

1 file changed

+14
-24
lines changed
 

‎README.md

+14-24
Original file line numberDiff line numberDiff line change
@@ -59,30 +59,21 @@ private val promoItem: MarkPromoItem by lazy {
5959
- Позволительно использовать функцию с одним выражением только в том случае, если она помещается в одну строку.
6060

6161
## Именованные аргументы
62-
- Если аргументов больше 3х, то следует их именовать.
62+
- Если по контексту не понятно назначение аргумента, то следует сделать его именованным.
6363
```kotlin
6464
runOperation(
6565
method = operation::run,
66-
consumer = consumer,
67-
errorHandler = errorHandler,
68-
tag = tag,
69-
cache = cache,
70-
cacheMode = cacheMode
66+
consumer,
67+
errorHandler,
68+
tag,
69+
cacheSize = 3,
70+
cacheMode
7171
)
72+
calculateSquare(x = 6, y = 19)
73+
getCurrentUser(skipCache = false)
74+
setProgressBarVisible(true)
7275
```
7376
- Если именованные аргументы не помещаются на одной строке, то следует переносить каждый аргумент на новую строку (как в примере выше).
74-
- Если аргументов 3 или меньше, то необязательно именовать все аргументы. При этом именованные аргументы должны идти в конце.
75-
```kotlin
76-
val date: Date = ..
77-
savePaymentData(date, cost = 100)
78-
```
79-
- Если функция принимает несколько аргументов одного и то же типа,
80-
то стоит именовать эти аргументы при вызове данной функции, чтобы случайно не перепутать их местами.
81-
```kotlin
82-
val startDate: Date = ..
83-
val endDate: Date = ..
84-
compareDates(startDate = startDate, endDate = endDate)
85-
```
8677
- Именуем все лямбды, принимаемые функцией в качестве аргументов (кроме случаев когда лямбда вынесена за круглые скобки),
8778
чтобы во время чтения кода было понятно назначение и ответственность каждой лямбды.
8879
```kotlin
@@ -95,14 +86,13 @@ editText.addTextChangedListener(
9586
}
9687
)
9788
```
98-
- Именовать аргументы примитивных типов.
99-
При этом если аргумент один, и из контекста вызова функции понятно для чего он нужен, то можно его не именовать.
89+
- Полезно именовать аргументы одинаковых типов, чтобы случайно не перепутать их местами.
10090
```kotlin
101-
calculateSquare(x = 6, y = 19)
102-
getCurrentUser(skipCache = false)
103-
setProgressBarVisible(true)
91+
val startDate: Date = ..
92+
val endDate: Date = ..
93+
compareDates(startDate = startDate, endDate = endDate)
10494
```
105-
- Именовать аргумент при передаче `null`.
95+
- Полезно именовать аргумент при передаче `null`.
10696
```kotlin
10797
setAdditionalArguments(arguments = null)
10898
```

0 commit comments

Comments
 (0)