C/Podstawy: Różnice pomiędzy wersjami

Usunięta treść Dodana treść
Linia 65:
Dobre komentowanie ma duże znaczenie dla rozwijania oprogramowania, nie tylko dlatego, że inni będą kiedyś potrzebowali przeczytać napisany przez ciebie kod źródłowy, ale także możesz chcieć po dłuższym czasie powrócić do swojego programu, i możesz zapomnieć, do czego służy dany blok kodu, albo dlaczego akurat użyłeś tego polecenia a nie innego. W chwili pisania programu, to może być dla ciebie oczywiste, ale po dłuższym czasie możesz mieć problemy ze zrozumieniem własnego kodu. Jednak nie należy też wstawiać zbyt dużo komentarzy, ponieważ wtedy kod może stać się jeszcze mniej czytelny - najlepiej komentować fragmenty, które nie są oczywiste dla programisty, oraz te o szczególnym znaczeniu. Ale tego nauczysz się już w praktyce.
 
Dobry styl pisania kodu jest o tyle ważny, że powinien on być czytelny i zrozumiały; po to w końcu wymyślono języki programowania wysokiego poziomu (w tym C), aby kod było łatwo zrozumieć ;). I tak - należy stosować wcięcia dla odróżnienia bloków kolejnego poziomu (zawartych w innym bloku; podrzędnych), nawiasy klamrowe otwierające i zamykające blok powinny mieć takie same wcięcia, {{TODO|Wg mnie można by tu było wspomnieć o tym jak praktycznie wstawiać nawiasy, aby o nich nie zapominać. np.<br> Warto tutaj wspomnieć o dobrym nawyku posługiwania się klamrami i nawiasami. Wyobraźmy sobie że piszemy strasznie rozbudowany blok instrukcji. Zatem stawiamy początkowy nawias klamrowy, potem piszemy, piszemy, piszemy kilkanaście bardzo skomplikowanych instrukcji i kiedy z radością sądzimy, że już skończyliśmy to okazuje się, że zapomnieliśmy postawić klamre zamykającą. Jak się od tego ustrzec? Bardzo łatwym i praktycznie nie zawodnym sposobem jest stawianie za jednym razem klamry otwierającej i zamykającej i dopiero późniejsze przystąpienie do wpisywania zawartości bloku, czy warunku między nawiasami<br>[[Wikipedysta:Noisy|Noisy]] 20:55, 24 lis 2006 (CET)}}staraj się aby nazwy funkcji i zmiennych kojarzyły się z zadaniem, jakie dana funkcja czy zmienna pełni w programie. W dalszej części podręcznika możesz napotkać więcej zaleceń dotyczących stylu pisania kodu. Staraj się stosować do tych zaleceń - dzięki temu kod pisanych przez ciebie programów będzie łatwiejszy do czytania i zrozumienia.
 
{{Porada|Jeśli masz doświadczenia z językiem [[C++]] pamiętaj, że w C nie powinno się stosować komentarzy zaczynających się od dwóch znaków slash:<br>