Kommentare in Python

Kommentare richtig einsetzen

Kommentare sind in jeder Programmiersprache ein wichtiger Bestandteil. Sie erfüllen verschiedene Aufgaben, je nachdem wo sie eingesetzt werden. Es gibt Kommentare um Funktionen, Methoden oder Klassen zu beschreiben, aber auch Kommentare innerhalb eines Code-Blocks, die dazu dienen eine Stelle im Code näher zu erläutern.

In Python kann man auf verschiedene Weise einen Kommentar schreiben. Am einfachsten geht das mit dem # Zeichen gefolgt vom eigentlichen Kommentar, der sich in der gleichen Zeile anschließt.

# this is a simple comment, in only one line

Möchte man über mehrere Zeilen kommentieren, so kann man entweder in jeder Zeile ein # Zeichen setzen:

# comment starting in the first line 
# continues in the second 
# and maybe third?

oder aber man benutzt einen multiline-string, welcher mit drei Anführungszeichen eingeleitet und ebenso beendet wird:

""" this is a multi line comment 
to describe some more details """ 

Wie bereits angedeutet, werden die möglichen Kommentar Typen an unterschiedlichen Stellen im Code immer wieder verwendet.

Hier wird ein Line-Kommentar benutzt, um zu erklären, weshalb der nachfolgende Codeblock entsprechend aufgebaut ist:

# Make sure os.environ exists, at least
try:
    environ
except NameError:
    environ = {}

Kommentare über mehrere Zeilen werden meist für die Dokumentation benutzt. Documentation-Strings oder kurz „docstrings“ schließen sich der Funktions- bzw Methodendefinition an.

def removedirs(name):
    """removedirs(name)

    Super-rmdir; remove a leaf directory and all empty intermediate
    ones.  Works like rmdir except that, if the leaf directory is
    successfully removed, directories corresponding to rightmost path
    segments will be pruned away until either the whole path is
    consumed or an error occurs.  Errors during this latter phase are
    ignored -- they generally mean that a directory was not empty.

    """
    rmdir(name)
    head, tail = path.split(name)
    if not tail:
        head, tail = path.split(head)
    while head and tail:
        try:
            rmdir(head)
        except OSError:
            break
        head, tail = path.split(head)

Hier findet man die PEP8 Definitionen zu Kommentaren.

„Kommentare in Python“ weiterlesen

einfach python

Python möglichst einfach erklärt

Dieses wordpress Blog ist mein neuestes Projekt und befasst sich mit der Programmiersprache Python. Mit kleinen kurzen Beiträgen möchte ich die Sprache Neulingen in der Programmierung näher bringen, aber auch mal alten Programmierhasen oder Quereinsteigern ein paar A-ha Effekte entlocken.

Ausschließlich in deutscher Sprache

Das Blog ist bewusst in Deutsch gehalten. Natürlich ist die Sprache der Wahl in der Programmierung Englisch, aber ich denke, dass es gerade für Einsteiger beim Lesen von How-To’s und Tutorials in englischer Sprache oft Verständnisproblem gibt. Mir ging und geht es zum Teil manchmal immer noch so. Außerdem möchte ich das Netz nicht noch zusätzlich mit grammatikalisch nicht ganz flüssigem Englisch füllen, das haben andere schon zu oft erledigt.

Zu meinen Artikeln werde ich zusätzlich noch weiterführende Links angeben, in denen man sich dann noch tiefgreifender mit dem ein oder anderen Thema beschäftigen kann.

Ich hoffe, dass dieses Blog und die kommenden Artikel dem ein oder anderen weiterhelfen und freue mich immer über Kommentare, positive wie auch kritische. Zu lernen haben wir alle immer etwas…

Viel Spaß beim Lesen und Stöbern,

Christian