Diskusia – 14. diel - Najčastejšie chyby C začiatočníkov - Vieš pomenovať premenné?

Při vytváření názvu proměnné se snažíme o to, aby byl název validní, čitelný, výstižný, snadno zapisovatelný a byl v souladu s ostatními názvy v programu.

ANO

Názvy, které jsou tvořeny z více slov zapisujeme pomocí camelCase, PascalCase nebo snake_case.
Názvy, které budeme chtít sdílet široké veřejnosti, píšeme výhradně v anglickém jazyce.
Názvy proměnných píšeme výhradně v jednom jazyce.
Pro ukazatelové proměnné zapisujeme znak '*' spojitě s názvem proměnné.
Pro názvy, ze kterých nemusí být na první pohled vidět jejich typ, využíváme výhody Maďarské notace.
Názvy pro ukazatelové proměnné vytváříme pomocí prefixu 'p' nebo "p_".
Názvy, u kterých přidáváme komentář zapisujeme na samostatný řádek.
U názvů, u kterých lze význam obtížně vystihnout, přidáváme doplňující komentář.
Mezi názvem a operátorem píšeme jednu mezeru.
K názvům Boolovských proměnných přidáváme dotazovací sloveso.
Názvy globálních proměnných vytváříme pomocí prefixu 'g' nebo "g_".
Názvy konstant zapisujeme výhradně velkými písmeny.
Názvy proměnných, jejichž doba životnosti je krátká, píšeme krátké.
Názvy polí se zapisují výhradně v množné formě.

NE

Názvy, které začínají číslicí.
Názvy, které končí podtržítkem.
Názvy, které obsahují nestandartní platné znaky.
Názvy, které se obtížně zapisují a vyslovují.
Názvy, které se shodují s klíčovým slovem.
Názvy, které se shodují se jménem funkce.
Názvy, které jsou shodné pro lokální a globální proměnnou.
Názvy, které se diametrálně liší od názvu proměnné stejného smyslu.
Názvy, které na první pohled nedávají žádný význam nebo jsou matoucí.
Názvy, jejichž význam je tvořen vynecháním písmen, zkratkovitě.
Názvy, kde počátečními znaky jsou dvě podtržítka nebo podtržítko následované velkým písmenem.
Názvy, které obsahují dvě nebo více podtržítek za sebou.
Názvy, které jsou příliš krátké nebo příliš dlouhé.
Názvy, jejichž délka je větší než 32 znaků.
Názvy, u kterých jsou dva znaky vizuálně podobné a přesto odlišné.
Názvy, kde všechny znaky jsou psány velkými písmeny a název neobsahuje podtržítko.
Názvy, kde všechny znaky jsou psány malými písmeny a název neobsahuje podtržítko.

Názvů pro proměnnou, splňující pravidla uvedená v úvodu, lze vytvořit mnoho. Který z nich je ale ten správný?

Pokud se chcete přesvědčit, zda Vámi zvolený název pro proměnnou je správný, požádejte kolegu o to, aby Vám sdělil co si myslí, že daná proměnná představuje. Pokud jeho odpověď odpovídá tomu co proměnná skutečně představuje, je název vhodný. A naopak, pokud představa bude odlišná nebo Vy sami si nebudete jisti, pak je název pro proměnnou špatně zvolený a je nutné jej změnit.

Pokud už jste sami nějaké programy napsali, otevřte si jejich zdrojový kód, podívejte se a zodpovězte si sami, zda stále víte, jaký význam má ta která proměnná v programu. Dost možná si na vše nevzpomenete...

Jak ale budete psát víc a víc programů, bude pro Vás vymyšlení vhodného názvu pro proměnnou jednodušší a přirozenější.