Kotlin Academy · Lektion

Bedste praksis

Hold operatorer intuitive

Lektion 4 af 413 trin

Bedste praksis er en gratis Kotlin Academy-lektion på CoddyKit. Dette er lektion 4 af 4. Du kan læse alle 3 lektioner i dette læringsspor gratis i deres fulde længde — derefter låser CoddyKit PRO alle lektioner op samt praktiske øvelser med en indbygget kodeeditor og en AI-underviser døgnet rundt. Den er en del af læringsforløbet i Kotlin Academy, og dine fremskridt synkroniseres på tværs af nettet og CoddyKit-appen. Kotlin Academy-kurset indeholder 4 lektioner i alt.

Gør operatorer intuitive

Overload kun en operator, når dens betydning er åbenlys. + på vektorer er tydeligt; + med betydningen send-e-mail er ikke.

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))
}

Bevar den forventede semantik

Følg den sædvanlige algebra: a + b bør føles kommutativt for symmetriske typer og bør ikke overraske læserne.

data class Money(val cents: Int) {
    operator fun plus(o: Money) = Money(cents + o.cents)
}

fun main() {
    println(Money(100) + Money(50))
}

Foretræk uforanderlighed

Operatorer som plus bør returnere en ny værdi i stedet for at ændre modtageren, så de svarer til den måde, tal opfører sig på.

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 kontra plusAssign

Definér plus for uforanderlige værdier, og definér plusAssign til ændringer direkte i foranderlige containere. Undgå at definere begge med modstridende adfærd.

class Cart {
    val items = mutableListOf<String>()
    operator fun plusAssign(item: String) { items.add(item) }
}

fun main() {
    val c = Cart()
    c += "book"
    println(c.items)
}

Tilpas returtyperne

Returnér den samme type fra binære operatorer, så resultater naturligt kan kædes sammen.

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)
}

Overload ikke for at være smart

Hvis en navngiven funktion er lettere at læse, så brug den. Operatorer er til ægte numerisk semantik eller containersemantik, ikke til gåder.

data class Log(val lines: List<String>) {
    fun append(line: String) = Log(lines + line)
}

fun main() {
    println(Log(emptyList()).append("start").lines)
}

Hold equals og hashCode konsistente

Hvis du overloader sammenligning eller lighed, skal du holde equals og hashCode synkroniserede for at undgå ødelagte samlinger.

data class Id(val v: Int)

fun main() {
    val set = hashSetOf(Id(1), Id(1))
    println(set.size)
}

Vær opmærksom på operatorpræcedens

Overloadede operatorer bevarer den indbyggede præcedens. Design dem, så den naturlige præcedens giver de forventede resultater.

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)
}

Dokumentér overraskende operatorer

Hvis en operator gør noget, der ikke er åbenlyst, skal du tilføje en kommentar eller KDoc, så kaldere ikke bliver vildledt.

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))
}

Brug contains til in

Operatoren in svarer til contains. Tilsidesæt den kun, når medlemskab er veldefineret for din type.

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)
}

Brug en funktion, hvis du er i tvivl

En tydeligt navngiven metode er næsten altid sikrere end en uklar operator. Begræns overload til situationer, hvor det virkelig forbedrer læsbarheden.

data class Temperature(val c: Int) {
    fun warmerThan(o: Temperature) = c > o.c
}

fun main() {
    println(Temperature(30).warmerThan(Temperature(20)))
}

Hurtig kontrol

Test din forståelse af bedste praksis for operatoroverload.

Opsummering

Du har lært bedste praksis for operatoroverload:

  • Overload kun, når betydningen er åbenlys og konventionel.
  • Foretræk uforanderlige resultater af samme type, og sørg for, at resultater kan kædes sammen.
  • Adskil plus (værdi) fra plusAssign (ændring).
  • Hold equals/hashCode konsistente, og foretræk navngivne funktioner, når de er tydeligere.
data class V(val x: Int) {
    operator fun plus(o: V) = V(x + o.x)
}

fun main() {
    println((V(2) + V(5)).x)
}
Gratis at komme i gang

Lær Kotlin med en AI-underviser — gratis

Skriv og kør rigtig kode i din browser, få øjeblikkelig hjælp fra en AI-underviser døgnet rundt, og fortsæt, hvor du slap, på web eller i appen.

Kurser
51
Lektioner
203

Ofte stillede spørgsmål

Er lektionen “Bedste praksis” gratis?

Ja — alle 3 lektioner i læringssporet Kotlin Academy, inklusive “Bedste praksis”, kan læses gratis i deres fulde længde her på webstedet. Derefter låser CoddyKit PRO alle lektioner op samt interaktive øvelser med en indbygget kodeeditor og en AI-underviser døgnet rundt. Kotlin Academy-kurset indeholder 4 lektioner i alt.

Hvad lærer jeg i “Bedste praksis”?

Hold operatorer intuitive Du øver dig i Kotlin Academy med praktisk kode, som du kører direkte i browseren, og en AI-vejleder døgnet rundt besvarer dine spørgsmål, mens du arbejder dig gennem lektionen.

Skal jeg have erfaring for at begynde på Kotlin Academy?

Der kræves ingen tidligere erfaring. Kotlin Academy på CoddyKit er tilrettelagt for både begyndere og øvede, så du kan starte her eller fra begyndelsen og lære i dit eget tempo. Dette er lektion 4 af 4.

Hvor lang tid tager lektionen “Bedste praksis”?

De fleste CoddyKit-lektioner tager cirka 5–10 minutter. Hver lektion er kort og interaktiv, så du gør løbende fremskridt og kan fortsætte, hvor du slap – på både web og app.

Kan jeg skrive og køre kode i denne Kotlin Academy-lektion?

Ja. Alle Kotlin Academy-lektioner har en indbygget kodeeditor, så du kan skrive og køre rigtig kode direkte i din browser og få øjeblikkelig feedback fra AI – uden lokal opsætning.

Alle lektioner i dette kursus

  1. Operatorfunktioner
  2. Sammenligningsoperatorer
  3. Indeks og invoke
  4. Bedste praksis
← Tilbage til Kotlin Academy