Skip to content
This repository was archived by the owner on Apr 10, 2025. It is now read-only.

[QM] Code Conventions

n2code edited this page May 13, 2014 · 6 revisions

Code Conventions


Encoding

  • eingerückt wird mit TABS, nicht mit Leerzeichen
  • Encoding: UTF-8
  • LineBreaks: LF \n Unix-Style

Benennung

  • Funktionsnamen, Variablennamen: camelCaseMitJedemNeuenWortErstesWortKlein

void ladeTolleDinge()

  • Strukturen/Datentypen: WieObenAberErstesWortGross

Spielfeld feld;

  • keine Unterstriche in Namen, keine Typenpräfixe

DONT: intNummer instead do: nummer

DONT: meine_variable instead do: meineVariable

  • Sprechende Funktionsnamen:

DONT: Spiel() instead do: SpielStarten()


Kommentare

keine Kommentare nach Zeilen

DONT: int nummer = 3; //erste Zuweisung

DO: //erste Zuweisung

int nummer = 3;

Blockkommentare zur Funktionsdoku:

/**
* Ich teste etwas.
* @param c1 the first argument.
* @param c2 the second argument.
*/
void testForEquality(char c1,char c2) ...

Klammerung

One-True-Brace-Style:

if (x < foo(y, z)) {
    qux = bar[4] + 5;
} else {
    while (z) {
        qux += foo(z, z);
        z--;
    }
    return ++x + bar();
}

  • Gliederung mit Leerzeichen
  • Nur eine Zuweisung pro Zeile (DONT: int x, y;)
  • Keine Gotos!
  • Breaks und Continues möglichst vermeiden, ansonsten gut kommentieren

Clone this wiki locally