Witam i witam ponownie.
Rozpoczynamy nową sekcję.
W tej sekcji chcę omówić niektóre z podstawowych pojęć w C.
Chcę opisać niektóre z rzeczy, które mieliśmy w naszym przykładzie lub naszym pierwszym wyzwaniu,
naszym głównym programie tutaj.
Więc mam to wyzwanie, prawdopodobnie je pamiętasz.
Zawiera wiele różnych instrukcji w wierszach kodu.
Spróbuję omówić tutaj niektóre koncepcje. Wrócę do tego przykładu.
Pierwszą rzeczą, którą chcę omówić, jest koncepcja komentarza.
Więc wrócimy do tego za sekundę. W tym miejscu chcę przejść do kilku slajdów.
Dlatego komentarze są używane w programie w celu udokumentowania programu i
zwiększenia jego czytelności.
Powiedziałem ci, dlaczego ważne jest, aby program był czytelny.
Ponieważ zamierzasz utrzymywać kod i musisz być w stanie spojrzeć na niego
i zrozumieć, co robi. Tak więc, jeśli chodzi
o komentarze, może
to trochę pomóc w tej koncepcji czytelności.
Komentarze mają przypominać Tobie lub komuś innemu czytającemu
Twój kod, co robi program lub co robi konkretny wiersz kodu.
Więc komentarze są dla Twojej korzyści.
Komentarze są ignorowane przez kompilator.
Więc nie ma znaczenia, czy będziesz postępować zgodnie ze składnią komentarzy, kompilator
nie będzie zgłaszał żadnych błędów, cokolwiek jest w komentarzu.
Więc znowu, są one bardzo przydatne i chcesz ich używać w swoich programach.
I są podstawową koncepcją wszystkich języków programowania.
Tak więc nie ma tu nic nowego do zobaczenia.
Ponownie, jako programista możesz napisać jakiś kod, wrócić do niego za
6 miesięcy i możesz nie
pamiętać, dlaczego napisałeś kod tak, jak to zrobiłeś.
Możesz nie rozumieć funkcji, możesz nie rozumieć logiki.
Umieszczając komentarz w kodzie, można
zaoszczędzić znaczną ilość czasu, który marnujesz na ponowne uczenie się rzeczy, zwłaszcza
ponowne uczenie się tego kodu.
Albo wyobraź sobie, że napisałeś
jakiś kod i jest to duży program, nad którym pracuje wielu programistów
i ktoś inny musi przyjrzeć się temu kodowi.
Jeśli są komentarze i opisują, co robi kod, ta druga
osoba będzie w stanie zrozumieć ten kod znacznie szybciej.
Będzie bardziej czytelny. Więc znowu, komentarze poprawiają
czytelność albo poprawiają czytelność programisty, który napisał kod, albo
poprawiają czytelność kogoś, kto patrzy na kod.
Możesz łatwo spojrzeć na ten kod źródłowy, a następnie szybko zrozumieć, co robi kod.
Dlatego chcesz umieścić komentarze w swoim kodzie.
Składnia służąca do umieszczania komentarzy w kodzie jest
taka, że istnieją dwa sposoby umieszczania komentarzy w kodzie.
I znowu, jest to bardzo, bardzo podobne do Java, bardzo podobne do wielu języków.
Ale w c możesz mieć komentarze wielowierszowe lub pojedyncze.
Jeśli użyjesz 2 znaków ukośnika, po którym następuje
gwiazdka, będzie to oznaczać komentarz wieloliniowy, komentarz
obejmujący wiele wierszy.
Gwiazdka ukośnika w przód oznacza początek tego komentarza.
A kiedy masz te wielowierszowe komentarze, ponieważ mają one komentarz początkowy, musisz
mieć coś, co mówi, że to się kończy.
Aby zakończyć komentarze, umieść znak gwiazdki z ukośnikiem
na końcu bez spacji między nimi.
A więc wszystko pomiędzy gwiazdą ukośnika do
przodu a ukośnikiem kończącym gwiazdę jest
uważane za komentarz,
wszystko na niebiesko. W ten sposób możesz objąć wiele linii.
Innym sposobem dodawania komentarza do programu w c jest używanie
komentarzy jednowierszowych.
Komentarze jednowierszowe to tylko 2 ukośniki.
Wszystko po dwóch ukośnikach w tym wierszu jest ignorowane
przez kompilator i traktowane jako komentarz.
Wszystko po tym nie jest komentarzem, to nowa linia kodu.
Więc to naprawdę zależy
od komentarza, który podajesz, czy chcesz używać komentarzy wielowierszowych, czy też komentarzy jednowierszowych.
Pokażę ci, jak możesz dodać je do swojego kodu w ciągu sekundy.
Jeśli chodzi o stylizację, niezależnie od tego, czy używasz komentarzy wielowierszowych, czy też
komentarzy jednowierszowych, prawdopodobnie będziesz używać obu w zależności od tego, co próbujesz zrobić lub
ile linii musisz opisać lub jak duży jest twój komentarz.
W tym przykładzie używamy tutaj komentarza wielowierszowego, który zwykle znajduje
się na początku pliku. Opisuje, kto napisał
plik, autora pliku, a następnie prawa autorskie.
Możesz również dodawać komentarze, które wyróżniają się, jeśli dzieje
się coś naprawdę, naprawdę ważnego w Twoim
kodzie, umieszczając wiele gwiazdek.
A więc drugi przykład tutaj, w którym mówi, że jest to bardzo ważny komentarz,
naprawdę wyróżnia się z powodu tych wszystkich gwiazdek.
Jest to więc trochę inny styl niż komentarz nagłówka u góry
w pierwszym przykładzie.
Teraz ostatni przykład tutaj, który jest tylko jednym wierszem komentarza,
znajduje się na końcu wiersza kodu i po prostu mówi ci, co robi pojedynczy wiersz.
Widzisz więc te różne style komentarzy wielowierszowych w porównaniu z komentarzami jednowierszowymi.
Oto typowy przykład, który można zobaczyć w programie.
To jest program zawierający kod C.
Prawdopodobnie nie wiesz, do cholery, co to robi.
Ale możesz spojrzeć na komentarze i w pewnym sensie określić, co się dzieje.
Na górze znajduje się komentarz, który mówi, że ten program dodaje 2 wartości całkowite i wyświetla wyniki.
Mówi ci o celu programu,
co robi.
Następnie zobaczysz kilka pojedynczych komentarzy.
A skąd wiesz, że są to komentarze jednowierszowe? Ponieważ mają 2 ukośniki.
Widzisz więc komentarz w jednym wierszu, który mówi o zadeklarowaniu zmiennych.
Widzisz inny, który mówi przypisać wartości i obliczyć ich sumę.
A potem zobaczysz taki, który mówi, że wyświetl wynik.
Każdy komentarz w jednym wierszu opisuje każdą pojedynczą grupę kodu, informując o tym,
co robią.
Dzięki temu możesz szybko przyjrzeć
się temu kodowi i zrozumieć, co robi, patrząc na komentarze.
Dzięki temu program jest bardziej czytelny.
Czytelność jest zaletą, ponieważ ułatwia utrzymanie kodu.
Dlatego ważne jest, aby używać komentarzy. A to jest szybki przykład
dodawania komentarzy do kodu.
Jak często powinniśmy korzystać z komentarzy.
Istnieje koncepcja zbyt wielu komentarzy.
Nie chcesz, aby Twój kod miał komentarz dla każdego wiersza.
To faktycznie zmniejsza czytelność kodu, ponieważ jest po prostu przepełniony.
W rzeczywistości utrudnia to czytanie, ponieważ jest po prostu przytłaczające.
Więc nie chcesz umieszczać komentarza dla każdego wiersza kodu.
Musisz mądrze wybierać swoje komentarze i inteligentnie ich używać.
To przyjdzie wraz z praktyką, kiedy dodawać
komentarze, kiedy nie dodawać komentarzy, gdzie je umieszczać.
Zazwyczaj na początku mojego pliku źródłowego mam
komentarze ze standardowymi informacjami, takimi jak autor, cel, opis, data
utworzenia komentarzy, a następnie przeplatane w całym kodzie, opisując kilka wierszy
kodu, w których znajduje się logika trochę bardziej skomplikowane.
Nie zawsze będę dodawać komentarze do deklarowania zmiennych, ponieważ jest to dość oczywiste.
Mogę nie dołączać komentarzy do niektórych funkcji, opisów,
ponieważ sam opis może być bardziej znaczący.
Wszystko zależy od praktyki.
Ale ilekroć dodajesz komentarze, tradycyjnie dobrym pomysłem jest dodanie
tych komentarzy podczas pisania kodu.
Po pierwsze, jeśli to zrobisz, program zostanie skomentowany i nie
zapomnisz tego zrobić.
Łatwiej jest również udokumentować program, dlaczego
faktycznie rozumiesz, co robi podczas pisania kodu.
Wciąż świeżo w pamięci, nie musisz wracać miesiąc później
i mówić, co mam na myśli tutaj, a teraz muszę dodać komentarz.
Dlatego dodaj komentarze podczas pisania kodu.
Komentarze mogą również pomóc, gdy próbujesz znaleźć i naprawić
błędy na etapie debugowania. Jeśli są błędy logiczne, możesz
spojrzeć na komentarze i możesz w pewnym sensie wyizolować, cóż, to
jest błąd, który się wydarzył.
Ten komentarz pokrywa się z tą funkcją.
Założę się, że błąd jest w tej grupie kodu. Pomaga więc wyodrębnić błędy w debugowaniu.
Komentarz może pomóc w czytaniu programu, ale może również wskazywać źródło
błędu logicznego, dlatego komentarze są ważne.
Kolejnym argumentem dotyczącym komentowania jest
ta wielka debata z programistami. Ile komentarzy zapewniacie?
Jest też fajna książka o nazwie Clean Code, która mówi o
pisaniu kodu wysokiej jakości. Wierz lub nie, ale
może istnieć dobry lub zły kod, a jest
to określane jako jakość kodu.
Chcesz pisać wysokiej jakości kod.
Porozmawiamy o tym przez cały kurs, ale wielu uczniów, którzy uczą się nowych języków, myśli o tym, że jeśli dane wyjściowe
są zgodne z tym, czego potrzebuję, nie ma znaczenia,
w jaki sposób piszę kod. To nieprawda.
Ponownie, pamiętaj o fazie konserwacji.
Pamiętaj, że produkt lub
program, który wydasz, będzie dostępny w terenie może przez kilka lat.
Jeśli więc chcesz znaleźć istniejące błędy lub dodać nowe funkcje, ważne jest,
aby kod był bardzo wysokiej jakości, łatwiejszy w utrzymaniu, bardzo
luźno powiązany, wysoce spójny.
I będziemy rozmawiać o tych koncepcjach w miarę przechodzenia.
Będziemy pisać wysokiej jakości kod w całej klasie.
Jednym ze sposobów pisania kodu wysokiej jakości jest dostarczanie komentarzy, ale także
udostępnianie komentarzy samodzielnie udokumentowanych.
To naprawdę oznacza używanie znaczących nazw. O tym właśnie mówi książka Clean Code.
Tworząc zmienną, używaj opisowej nazwy.
Kiedy więc patrzysz na zmienną, wiesz dokładnie, do czego jest używana,
nie musisz więc dodawać komentarza.
Jeśli masz funkcję, która dodaje 2 liczby, nazwij funkcję dodaj 2 liczby.
Czy potrzebujesz komentarza, aby powiedzieć, co robi ta funkcja, nie.
Ponieważ nazwa mówi ci, co robi.
Dlatego znaczące nazwy to dobry sposób na umieszczanie samodokumentujących się komentarzy.
Wróćmy do naszego przykładu z naszego wyzwania
i chcę Ci dokładnie pokazać,
jak możesz dodawać komentarze i gdzie je dodajesz.
Zauważysz, że kompilator zignoruje te komentarze.
Więc w naszym pierwszym przykładzie, który jest
programem podstawowym, zazwyczaj dodam komentarze wielowierszowe na początku pliku, przed jakimikolwiek wierszami kodu.
I pamiętaj, że możemy dodać te wielowierszowe komentarze, podając po prostu ukośnik, gwiazdkę
i gwiazdkę, aby rozpocząć komentarz.
A potem wszystko pomiędzy
komentarzem będzie
komentarzem, wszystko pomiędzy gwiazdką a gwiazdką.
I zauważysz, kiedy zrobię tę gwiazdę z ukośnikiem, że wszystko jest szare,
ponieważ to mówi mi, że nie mam teraz komentarza końcowego.
Musisz więc dodać tę gwiazdkę do
przodu, aby zakończyć komentarz. Zobaczysz, że kolory się teraz zmieniają.
Dlatego lubię używać IDE, ponieważ wiele mówi o tym skoordynowanym kolorystycznie
formatowaniu.
Zatem wszystko między gwiazdką ukośnika jest początkiem
komentarza wieloliniowego, wszystko przed gwiazdką do przodu jest
opisem lub końcem komentarza wieloliniowego.
Zwykle umieszczam na początku pliku coś w
rodzaju autora, umieszczam swoje imię i nazwisko, a następnie może podam cel.
Zwykle jest to dobra praktyka i umieszczę coś takiego jak
ten program, wypisuje moje imię na ekranie.
A potem zwykle podam datę utworzenia, niezależnie od daty.
A to jest przykład wielowierszowego nagłówka komentarza. A potem przedstawię komentarze w
całym kodzie. Zwykle komentarze jednowierszowe
lub komentarze wielowierszowe, zależy to tylko od liczby komentarzy.
Więc może nie jesteśmy zaznajomieni z tym kodem. I mógłbym powiedzieć, że wiesz, że
2 ukośniki to komentarz w jednym wierszu. Mogę powiedzieć, że ten kod
wyświetla moje imię.
I znowu, kiedy podaję te ukośniki lub komentarze
wieloliniowe, kompilator je ignoruje. Zasadniczo możesz tam umieścić wszystko, co chcesz, i to nie ma znaczenia.
Nie ma składni, której musisz przestrzegać, nie ma nic.
Ignoruje wszystko, co jest tutaj pomalowane na szaro, co jest
uważane za komentarz.
Dlatego komentarze są podstawową, fundamentalną rzeczą w każdym programie.
Chciałem je opisać wcześnie, ponieważ będę ich używał i
powinieneś dodawać je podczas pisania kodu.
Ponadto w przypadku komentarzy w środowisku
IDE zdarza się, że kompilujesz kod i wszystko kończy się niepowodzeniem.
Dlatego są chwile, kiedy możesz chcieć skomentować wszystko lub
skomentować bloki kodu, aby spróbować zdebugować problem, spróbuj wyodrębnić swój błąd.
Możesz podświetlić wiele wierszy kodu, a następnie
przejść do edycji w menu i powiedzieć komentarz
lub usunąć komentarz.
Jeśli powiesz komentarz, skomentuje cały ten kod,
który zaznaczyłeś.
A potem możesz ponownie skompilować i być może nie masz już błędu kompilatora.
Jest to sposób na wyodrębnienie błędów w czasie wykonywania lub kompilacji.
Więc IDE ma kilka fajnych
narzędzi, które pozwalają na automatyczne komentowanie wielu linii poprzez podświetlanie
i przełączanie.