Ի՞նչ է ձեր համար որակյալ կոդը։

Իմ համար որակյալ կոդը ունի հետևյալ հատկանիշները՝

• Կարդալություն: Այն հեշտ է հասկանալ մյուս ծրագրավորողների կողմից (և ինքներս համար՝ կես տարուց հետո):
• Ապահովելիություն: Փոփոխություններն ու սխալների ուղղումները կատարվում են արագ և անվտանգ:
• Թեստավորելիություն: Կոդը բաժանված է մոդուլների, որոնք հեշտ է առանձնացնել և փորձարկել:
• Մաքուրություն: Չկա կրկնություն (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
}