Napsat si vlastní kód, který po hodinách ladění funguje podle očekávání, je úžasný pocit.
Vrátit se k vlastnímu kódu po několika týdnech a nerozumět mu… to už úžasný pocit rozhodně není.
K tomu, aby váš kód byl srozumitelný i po několika měsících/letech od ukončení vašeho snažení je zapotřebí několika návyků a čím dříve se je programátor naučí, tím bude pro něj život jednodušší.
Tilen MAJERLE (mohli byste ho znát díky jeho stránkám https://stm32f4-discovery.net/, kde se nachází neskutečné množství návodů pro mikrokontroléry STM32) vytvořil jeden delší dokument, kde mapuje nejčastější chyby při psaní kódu v jazyce C (pravidla se dají přenést i na další jazky) a ukazuje, jak by se podmínky, funkce, smyčky měly správně psát.
Na rovinu přiznám, že nejsem zastáncem několika tvrzení, které na stránce jsou i když jsou podle standardu C99 správně. Například u podmínek se složenými závorkami preferuji Allman style namísto 1TBS (OTBS).
Tak či tak, na stránce najdete velké množství rad, které vám dozajista pomohou k „lepším výkonům“.
Naleznete tam také šablonu pro *.c a *.h soubor.
Více na stránce: https://github.com/MaJerle/c_code_style