W tym samouczku dowiesz się o instrukcjach Pythona, dlaczego wcięcia są ważne i jak używać komentarzy w programowaniu.
Instrukcja Pythona
Instrukcje, które może wykonać interpreter języka Python, nazywane są instrukcjami. Na przykład a = 1jest instrukcją przypisania. ifOświadczenie, forOświadczenie, whileOświadczenie itp. to inne rodzaje instrukcji, które zostaną omówione później.
Instrukcja wielowierszowa
W Pythonie koniec instrukcji jest oznaczony znakiem nowego wiersza. Ale możemy sprawić, by instrukcja obejmowała wiele linii za pomocą znaku kontynuacji linii (). Na przykład:
a = 1 + 2 + 3 + 4 + 5 + 6 + 7 + 8 + 9
To jest wyraźna kontynuacja linii. W Pythonie kontynuacja linii jest implikowana w nawiasach (), nawiasach () i nawiasach klamrowych (). Na przykład możemy zaimplementować powyższą instrukcję wielowierszową jako:
a = (1 + 2 + 3 + 4 + 5 + 6 + 7 + 8 + 9)
W tym przypadku otaczające nawiasy () niejawnie wykonują kontynuację wiersza. To samo dotyczy () i (). Na przykład:
colors = ('red', 'blue', 'green')
Możemy również umieścić wiele instrukcji w jednym wierszu za pomocą średników, w następujący sposób:
a = 1; b = 2; c = 3
Wcięcie w Pythonie
Większość języków programowania, takich jak C, C ++ i Java, używa nawiasów klamrowych () do definiowania bloku kodu. Python używa jednak wcięć.
Blok kodu (treść funkcji, pętla itp.) Zaczyna się wcięciem i kończy pierwszym wierszem bez wcięć. Wielkość wcięcia zależy od Ciebie, ale musi być spójna w całym bloku.
Ogólnie do wcięć używa się czterech białych znaków, które są preferowane w stosunku do tabulatorów. Oto przykład.
for i in range(1,11): print(i) if i == 5: break
Wymuszenie wcięć w Pythonie sprawia, że kod wygląda schludnie i czysto. Powoduje to, że programy w Pythonie wyglądają podobnie i są spójne.
Wcięcie można zignorować w kontynuacji wiersza, ale zawsze warto je zastosować. Dzięki temu kod jest bardziej czytelny. Na przykład:
if True: print('Hello') a = 5
i
if True: print('Hello'); a = 5
oba są ważne i robią to samo, ale poprzedni styl jest jaśniejszy.
Spowoduje to nieprawidłowe wcięcie IndentationError.
Komentarze w Pythonie
Komentarze są bardzo ważne podczas pisania programu. Opisują, co dzieje się wewnątrz programu, dzięki czemu osoba przeglądająca kod źródłowy nie ma problemu z jego zrozumieniem.
Za miesiąc możesz zapomnieć kluczowych szczegółów programu, który właśnie napisałeś. Dlatego poświęcenie czasu na wyjaśnienie tych pojęć w formie komentarzy jest zawsze owocne.
W Pythonie używamy symbolu hash ( # ), aby rozpocząć pisanie komentarza.
Rozciąga się do znaku nowej linii. Komentarze są dla programistów, aby lepiej zrozumieć program. Python Interpreter ignoruje komentarze.
#This is a comment #print out Hello print('Hello')
Komentarze wielowierszowe
Możemy mieć komentarze, które obejmują wiele wierszy. Jednym ze sposobów jest użycie symbolu krzyżyka ( # ) na początku każdego wiersza. Na przykład:
#This is a long comment #and it extends #to multiple lines
Innym sposobem na to jest użycie potrójnych cudzysłowów „” lub „” ”.
Te potrójne cudzysłowy są zwykle używane w przypadku ciągów wielowierszowych. Ale mogą być również używane jako komentarz wielowierszowy. O ile nie są one ciągami dokumentacyjnymi, nie generują dodatkowego kodu.
"""This is also a perfect example of multi-line comments"""
Aby dowiedzieć się więcej o komentarzach, odwiedź stronę Komentarze w języku Python.
Docstrings w Pythonie
Ciąg dokumentacyjny jest skrótem od ciągu dokumentacyjnego.
Python docstrings (ciągi dokumentacji) to literały tekstowe, które pojawiają się zaraz po definicji funkcji, metody, klasy lub modułu.
Podczas pisania dokumentów używa się potrójnych cudzysłowów. Na przykład:
def double(num): """Function to double the value""" return 2*num
Dokumenty pojawiają się zaraz po definicji funkcji, klasy lub modułu. Oddziela to dokumenty od komentarzy wielowierszowych za pomocą potrójnych cudzysłowów.
Dokumenty są powiązane z obiektem jako ich __doc__atrybutem.
Tak więc możemy uzyskać dostęp do ciągów dokumentów powyższej funkcji za pomocą następujących linii kodu:
def double(num): """Function to double the value""" return 2*num print(double.__doc__)
Wynik
Funkcja podwojenia wartości
Aby dowiedzieć się więcej o ciągach dokumentów w Pythonie, odwiedź stronę Python Docstrings.
