howto:codingstandards:01-bezeichner

01 - Bezeichner

Bezeichner sind die «Namen» von Klassen, Funktionen, Attributen, Variablen und Konstanten sowie Modulen und Paketen.

Ein sprechender Bezeichner sagt etwas über den Sinn und Zweck einer Komponente aus. Durch den Einsatz von sprechenden Bezeichnern werden viele Kommentare überflüssig.

Die Bezeichner (Namen) von Klassen, Funktionen, Attributen, Variablen und Konstanten müssen sprechend sein.
Alle Bezeichner (Namen) werden in Englisch geschrieben.
Schleifenzähler innerhalb einer kurzen Iteration (max. 5 Zeilen) dürfen auch kürzere Variablennamen wie i, j verwenden.

Beispiel

total_marks = 0
i = 0
while i < 3:
    mark = input('Note >')
    total_marks = total_marks + int(mark)
    i = i + 1
average = total_marks / 3
print('Durchschnitt: ' + str(average))

Durch eine einheitliche Schreibweise verbessern Sie die Lesbarkeit Ihres Sourcecodes.

Vermeide Sonderzeichen, Leerzeichen und Umlaute in allen Bezeichnern, sowie in Datei- und Ordnernamen.
Die Bezeichner von Funktionen und Variablen bestehen aus Kleinbuchstaben.
Zusammengesetzte Bezeichner werden in snake_case geschrieben (z. B. get_fullname)
Konstanten werden nur mit Grossbuchstaben geschrieben (z.B. PI).

Beispiel

def main():
    PI=3.14159
 
    radius=float(input('Radius >'))
    circumference=2*radius*PI
    circular_area = radius*radius*PI
Klassennamen werden in PascalCase geschrieben. Sie bestehen aus einem Substantiv und beginnen mit einem Grossbuchstaben (z.B. Person).
Die Bezeichner von Attributen einer Klasse beginnen mit einem Underscore (z.B. _firstname).
Für Module werden kurze, ganz in Kleinbuchstaben geschriebene Namen gewählt. Unterstriche können im Modulnamen verwendet werden, wenn dies die Lesbarkeit verbessert (snake_case).
Python-Pakete haben auch kurze, ganz in Kleinbuchstaben geschriebene Namen. Der Name eines Pakets enthält keine Unterstriche.

Beispiele

phone.py
class Person:
    def __init__(self, firstname, lastname):
        self._firstname = firstname
        self.<_astname = lastname
 
    def get_fullname(self):
        return (self._firstname + ' ' + self._lastname)
 
...
smartphone.py
from phone import Phone
 
class SmartPhone(Phone):
    pass

Die Klasse SmartPhone leitet sich von der Klasse Phone im Modul phone.py ab.

  • howto/codingstandards/01-bezeichner.txt
  • Last modified: 2024/03/28 14:07
  • by 127.0.0.1