모범 사례
연산자를 직관적으로 유지합니다
모범 사례은(는) CoddyKit의 무료 Kotlin Academy 강의입니다. 이것은 4개 중 4번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 Kotlin Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. Kotlin Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
직관적인 연산자 유지하기
의미가 명확한 경우에만 연산자를 오버로드하세요. 벡터에서 +를 사용하는 것은 분명하지만, 이메일 보내기를 의미하는 +는 그렇지 않습니다.
data class Vec(val x: Int, val y: Int) {
operator fun plus(o: Vec) = Vec(x + o.x, y + o.y)
}
fun main() {
println(Vec(1, 2) + Vec(3, 4))
}예상되는 의미 보존하기
일반적인 대수 법칙을 따르세요. 대칭적인 타입에서는 a + b가 교환법칙이 성립하는 것처럼 느껴져야 하며, 독자를 당황하게 해서는 안 됩니다.
data class Money(val cents: Int) {
operator fun plus(o: Money) = Money(cents + o.cents)
}
fun main() {
println(Money(100) + Money(50))
}불변성 우선하기
plus와 같은 연산자는 수신 객체를 변경하는 대신 새로운 값을 반환해야 합니다. 이는 숫자의 동작 방식과 일치합니다.
data class Point(val x: Int) {
operator fun plus(o: Point) = Point(x + o.x)
}
fun main() {
val a = Point(1)
val b = a + Point(2)
println("${a.x} ${b.x}")
}plus와 plusAssign 비교
불변 값에는 plus를 정의하고, 변경 가능한 컨테이너를 제자리에서 변경할 때는 plusAssign를 정의하세요. 둘을 서로 충돌하는 동작으로 함께 정의하지 마세요.
class Cart {
val items = mutableListOf<String>()
operator fun plusAssign(item: String) { items.add(item) }
}
fun main() {
val c = Cart()
c += "book"
println(c.items)
}반환 타입 일치시키기
이항 연산자에서는 같은 타입을 반환하여 결과를 자연스럽게 연결할 수 있게 하세요.
data class N(val v: Int) {
operator fun plus(o: N) = N(v + o.v)
}
fun main() {
println((N(1) + N(2) + N(3)).v)
}영리해 보이기 위한 오버로드는 피하기
이름이 있는 함수가 더 읽기 좋다면 그 함수를 사용하세요. 연산자는 진정으로 수치적이거나 컨테이너와 같은 의미를 나타낼 때 사용해야 하며, 수수께끼처럼 사용해서는 안 됩니다.
data class Log(val lines: List<String>) {
fun append(line: String) = Log(lines + line)
}
fun main() {
println(Log(emptyList()).append("start").lines)
}equals와 hashCode 일관성 유지하기
비교나 동등성 연산자를 오버로드한다면 equals와 hashCode를 일관되게 유지하여 컬렉션이 잘못 동작하지 않도록 하세요.
data class Id(val v: Int)
fun main() {
val set = hashSetOf(Id(1), Id(1))
println(set.size)
}연산자 우선순위 주의하기
오버로드한 연산자에도 기본 제공 연산자의 우선순위가 유지됩니다. 자연스러운 우선순위에서 예상한 결과가 나오도록 설계하세요.
data class N(val v: Int) {
operator fun plus(o: N) = N(v + o.v)
operator fun times(o: N) = N(v * o.v)
}
fun main() {
println((N(2) + N(3) * N(4)).v)
}놀라운 연산자 문서화하기
연산자가 명확하지 않은 동작을 한다면 호출하는 사람이 오해하지 않도록 주석이나 KDoc을 추가하세요.
data class Range2(val start: Int, val end: Int) {
// contains: is value inside the range?
operator fun contains(v: Int) = v in start..end
}
fun main() {
println(5 in Range2(1, 10))
}in에 포함 여부 검사 사용하기
in 연산자는 contains에 매핑됩니다. 여러분의 타입에서 포함 여부가 명확하게 정의되는 경우에만 이를 재정의하세요.
class Team(val members: List<String>) {
operator fun contains(name: String) = name in members
}
fun main() {
val t = Team(listOf("Ann", "Bo"))
println("Ann" in t)
}확실하지 않다면 함수 사용하기
명확한 이름의 메서드는 모호한 연산자보다 거의 항상 안전합니다. 가독성이 실제로 향상될 때만 오버로드를 사용하세요.
data class Temperature(val c: Int) {
fun warmerThan(o: Temperature) = c > o.c
}
fun main() {
println(Temperature(30).warmerThan(Temperature(20)))
}빠른 확인
연산자 오버로드의 모범 사례에 대한 이해도를 확인해 보세요.
복습
연산자 오버로드의 모범 사례를 배웠습니다:
- 의미가 명확하고 관례적인 경우에만 오버로드하세요.
- 불변성과 같은 타입의 반환을 우선하여 결과를 연결할 수 있게 하세요.
plus(값)와plusAssign(변경)를 구분하세요.equals/hashCode를 일관되게 유지하고, 더 명확하다면 이름이 있는 함수를 우선하세요.
data class V(val x: Int) {
operator fun plus(o: V) = V(x + o.x)
}
fun main() {
println((V(2) + V(5)).x)
}자주 묻는 질문
“모범 사례” 강의는 무료인가요?
네 — “모범 사례” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 Kotlin Academy 강의 전체를 잠금 해제할 수 있습니다. Kotlin Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
“모범 사례”에서 뭘 배우나요?
연산자를 직관적으로 유지합니다 브라우저에서 직접 실행하는 실습 코드로 Kotlin Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.
Kotlin Academy을(를) 시작하는 데 경험이 필요한가요?
사전 경험은 필요하지 않습니다. CoddyKit의 Kotlin Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 4번째 강의입니다.
“모범 사례” 강의는 얼마나 걸리나요?
대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.
이 Kotlin Academy 강의에서 코드를 작성하고 실행할 수 있나요?
네. 모든 Kotlin Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.