Кодати сифати барои шумо чист?

Маъз, сифатнокод дорои чунин хусусиятҳо дорад:

• Оқишавандагӣ: Он ба осонӣ барои дигар таҳиягарон (ва барои худ пас аз ним сол) фаҳмо аст.
• Дастгирӣ: Тағйиротҳо ва ислоҳоти хатоҳо зуд ва бехатар иҷро мешаванд.
• Тестшавандагӣ: Код ба модулҳо тақсим шудааст, ки онҳоро осон ба ҷудо ва санҷиш кардан мумкин аст.
• Тозаӣ: Бе такрор (DRY), номҳои равшан барои тағйирёбандаҳо ва функсияҳо, риояи услуби кодгузорӣ.
• Самарабахшӣ: Истифодаи оптималии захираҳо (процессор, хотира) барои вазифа.
• Эътимоднокӣ: Ба хатогиҳои эҳтимолӣ (истисноҳо, арзишҳои null) назар мекунад ва онҳоро дуруст коркард мекунад.
• Ҳуҷҷатгузорӣ: Дар ҳолати зарурат, шарҳҳои равшан ё ҳуҷҷатҳо дорад.

Масалан, коди тоза, ки такрорро пешгирӣ мекунад:

// Нодуруст: такрори логика
fun processUser(user: User) {
    if (user.isActive) {
        println("Пасандозии корбари фаъол ${user.name}")
        // Бисёр код...
    } else {
        println("Пасандозии корбари ғайрифаъол ${user.name}")
        // Ҳамон бисёр код...
    }
}

// Дуруст: ҷудо кардани логикаи такроршаванда
fun processUser(user: User) {
    println("Пасандозии корбар ${user.name}") // Логикаи умумӣ
    if (user.isActive) {
        processActiveUser(user)
    } else {
        processInactiveUser(user)
    }
    // Бисёр код... // Логикаи умумӣ пас аз if/else
}

fun processActiveUser(user: User) {
    // Танҳо логикаи махсус барои фаъолон
}

fun processInactiveUser(user: User) {
    // Танҳо логикаи махсус барои ғайрифаъолон
}

Масалан, ки нишон медиҳад, ки хондан ва номҳои равшан:

// Нодуруст
fun calc(a: Int, b: Int): Int {
    return a + b
}

// Дуруст
fun calculateSum(firstNumber: Int, secondNumber: Int): Int {
    return firstNumber + secondNumber
}