9. diel - Najčastejšie chyby C# začiatočníkov - Pomenovanie premenných

V predchádzajúcom cvičení, Riešené úlohy k 7.-8. lekciu C# .NET, sme si precvičili získané skúsenosti z predchádzajúcich lekcií.

V dnešnom C# .NET tutoriále si ukážeme prvé tzv. dobré praktiky pre programovanie v C# .NET. Často ich porušujú nielen nováčikovia a programátori tak zanášajú do svojich programov zbytočné chyby. Nerobíš ich tiež?

Slovo senior programátora

Gratulujem k zdolaniu prvých lekcií Základných konštrukcií jazyka C# .NET!

Materiál pre dnešnú lekciu som zostavil na základe dvadsiatich rokov skúseností s programovaním. Ako šéfredaktorovi a lektorovi mi rukami prešli stovky, možno tisíce zdrojových kódov vytvorených komunitou. Nebolo ťažké si všimnúť, že hoci väčšina týchto kódov funguje, obsahuje zbytočné chyby, ktoré sa navyše stále dookola opakujú. Chyby napodiv často robili ako nováčikovia, tak skúsenejší programátori. Medzi chybujúce som v začiatkoch patril aj ja.

Došiel som k tomu, že základným a mylným predpokladom je:

✗ Program je správne, ak funguje.

Programy a domy

Pokiaľ staviame dom, tak to, že sa nám páči a nefúka do neho, neznamená, že je skonštruovaný správne. Dom totiž musí mať premyslenú architektúru, a pokiaľ nemá základy, o pár rokov sa nám začne zosúvať.

Programovanie je často prirovnávané k stavebníctvu práve s ohľadom na architektúru, v našom prípade však tú softvérovú. Vysvetlime si prečo.

Ľudský mozog dokáže naraz pracovať len s určitým obmedzeným množstvom informácií. Zjednodušene môžeme povedať, že pokiaľ je program napísaný neprehľadne, od určitej chvíle musel programátor udržať v hlave viac vecí, než človek vôbec dokáže. Pridávanie ďalších funkcií do takého programu potom vždy spôsobí, že v aplikácii vznikne chyba. V praxi to dopadá tak, že hobby projekt autora "prestane baviť" a komerčný projekt skrachuje, pretože už je "veľmi zložitý".

Uveďme si ešte iný príklad. Keď bude naša domácnosť usporiadaná tak, že kladivo bude v lekárničke, ktorá bude umiestnená v pivnici, asi ťažko s ňou budeme schopní efektívne fungovať. Hoci tento príklad znie absurdne, jeho alternatívy v podobe programov vznikajú denne.

Kedy je program správne?

To je ľahké. Program je správne, ak:

• funguje,
• dodržiava dobré praktiky a
• je otestovaný.

Všimnime si, že funkcionalita z pohľadu užívateľa programu predstavuje len 1/3 kritérií kvality programu. Podobne ako funkčnosť domu z pohľadu bývajúceho predstavuje asi iba zlomok jeho reálnej kvality z hľadiska staviariny.

Práve o porušovaní dobrých praktík ao kvalite kódu sa dnes budeme baviť. Záleží nám na tom, aby ste boli naozaj dobrí, preto týchto lekcií nájdete naprieč našimi kurzami viacero.

Ako správne pomenovávať premenné?

Hovorí sa, že 10% času niečo programujeme a 90% času pre to vymýšľame názov Ide samozrejme o nadsádzku, ale vtip naráža na nutnosť stráviť určitý čas vymýšľaním názvov premenných. To aby každý vrátane nás, kto sa po pár mesiacoch vracia k vlastnému kódu, pochopil, na čo ona premenná slúži. Všeobecne sa dá spoľahnúť na jednoduché pravidlo:

Premenné vždy pomenovávame podľa toho, čo obsahujú, nie podľa toho, na čo v programe slúžia.

Porovnajme nasledujúce 2 kódy:

string listing, text2;
int[5] array;
int foo, bar, x, calculation;

string title, name;
int[5] answers;
int i, j, bonus, totalBonus;

Oba kódy vytvárajú premenné pre jednoduchý konzolový kvíz. Pri prvom príklade nie je vôbec jasné, čo niektoré premenné obsahujú, napr. pomenovať premennú array má asi rovnakú vypovedaciu hodnotu, ako keby sme ju pomenovali variable.

Častou chybou tiež je, že chceme napr. uložiť výsledok nejakého výpočtu a premennú pomenujeme calculation. Výpočet s premennou však vôbec nesúvisí, to je nejaká akcia (dej), premenná vždy obsahuje hodnotu (výsledok deja). Tou je tu v prípade kvízu totalBonus. Podobne je v prvom kóde pomenovaná premenná extract, pretože ju niekde vypisujeme. Z druhého kódu ale reálne vidíme, že obsahuje názov kvízu.

Ruku na srdce - kto z vás by pochopil, že kód vľavo sa týka programu na kvízy?

Tiež nikdy nepomenovávame premenné helperVariable alebo helpV apod.

Pozor na "slovenglish" a diakritiku

V zdrojovom kóde je na našej úrovni začiatočníkov jedno, akým jazykom budeme premenné pomenovávať (pokiaľ teda nepošleme Angličanovi kód v slovenčine).

Premenné v jednom projekte pomenovávame jedným jazykom. Ak pomenovávame po slovensky, tak bez diakritiky!

Opäť si ukážme príklady:

string message = "Čau!";
int počet;

String message = "Hi!";
int count;

String sprava = "Čau!";
int pocet;

V identifikátoroch (napr. v názvoch premenných) nikdy nepoužívame háčiky ani čiarky. V hodnotách v nich uložených je to už samozrejme v poriadku.

Napriek tomu, že moderné jazyky podporujú kódovanie UTF-8 aj v identifikátoroch, možno veľmi ľahko na háčik alebo čiarku zabudnúť a používame potom inú premennú ! Navyše súbor so zdrojovým kódom môže spracovávať aplikácia, ktorá ho nepodporuje, čo sa typicky aj časom stane (napr. je občas problém zobraziť diakritiku v prílohe mailovým klientom a pod.).

Viacslovné premenné

Dnešné aplikácie sú čoraz zložitejšie. Často sa stane, že by jedno slovo na opis toho, čo je v premennej uložené, nestačilo. Potom je výhodné použiť viac slov. Krátke identifikátory z 80. rokov tak v súčasných business aplikáciách striedajú aj pomerne dlhé názvy ako userObjectOutputStreamFactory a podobne.

Takto dlhý názov má však zmysel iba v zložitej aplikácii, kde je niekoľko podobných premenných, a preto musíme pridať ďalšie slovo. Nebudeme teda v Hello world aplikácii vytvárať premennú textWithGreetingsHelloWorld, ale stačí nám len greeting, pokiaľ tam iný nie je

Oddelenie slov

Kvôli čitateľnosti musíme slová v takom názve premennej nejako oddeliť:

• Viac slov oddeľujeme podľa konvencie daného programovacieho jazyka. V prípade C# ide o tzv. camelCase (slovensky ťavie notácie, kedy každé ďalšie slovo začína veľkým písmenom a názov potom vyzerá ako hrby). V iných jazykoch sa môže používať napr. podčiarknutie ako snake_case a ďalšie notácie.
• Vyhneme sa pokiaľ možno číslovaniu premenných a už vôbec nepíšeme čísla slovami, nie greeting2 ani greetingsTwo. "Two" totiž nehovorí nič o tom, čo pozdrav obsahuje.

Ukážme si to na príkladoch:

string message1;
string messageTwo;

string received; // text, bytes, message, order...?
string sent;

string receivedmessage;
string sentmessage;

string receivedMessage;
string sentMessage;

Nepoužívame skratky

Túto podkapitolu začnime citáciou:

Všetci si lámali hlavu, k čomu je ten stĺpec DATBIR. Až sa raz zistilo, že je to vraj dátum narodenia (date of birth).

Táto zlá praktika je vlastne opakom viacslovných názvov premenných. Nevymýšľame nezmyselné skratky, napríklad z názvu rm nikto nespozná, že myslíme receivedMessage. Pomôcka môže byť:

Pokiaľ sa na kód pozrie niekto iný ako my, mal by presne vedieť, čo v ktorej premennej je.

string ms;
int nm;

string message;
int numberOfMessages;

Ako sme sľúbili, k téme dobrých praktík sa ešte niekoľkokrát vrátime v podobných, skôr odpočinkových lekciách

V budúcej lekcii, Textové reťazce v C# druhýkrát - Práca s jednotlivými znakmi, na vás čaká prekvapenie