Namengebung

Namenwahl

1. Namen entsprechen dem Verwendungszweck des jeweiligen Konstrukts.
2. Nach Möglichkeit werden Namen ausgeschrieben. Wenn sie zu lang sind, können sinnvolle und wiedererkennbare Abkürzungen verwendet werden. (Gegenbeispiel: heißt 'tmt' Transmit oder Timeout?). Ausnahme: ‘historisch’ gewachsene Standardabkürzungen ('Rcv', 'Snd', etc.)
3. Underscores in Namen sind unzulässig. Sie werden verwendet, um Modul-Prefizes von Namen abzugrenzen.

Verboten:	Lies_Stammdaten()
Erlaubt:	LiesStammdaten(); Fibu_LiesStammdaten();

4. Es werden grundsätzlich deutsche Namen verwendet. Ausnahmen bilden Fachwörter.

Mischformen (GetStapelEintrag) sind absolut verboten.

Weitere Ausnahmen bilden Namen oder Namensbestandteile, die den Charakter von Schlüsselwörtern haben. Auf solche Ausnahmen wird in diesem Dokument hingewiesen. Ausnahmen über dieses Dokument hinaus gibt es nicht.

5. Bei Übersetzungsproblemen sind gängige Begriffe (in einem Glossar) zu sammeln und ggf. übersetzt als Richtlinie zu definieren. Grundlage für die Übersetzungen solcher Namen sind entsprechende Fachwörterbücher bzw. von externen professionellen Übersetzern erstellte Dokumente.
6. Von Fremdsystemen übernommene Abkürzungen können beibehalten werden. So muß z.B. MFC oder OWL nicht übersetzt werden.

Typen

1. Durch typedef erzeugte Typnamen werden groß geschrieben und dürfen Underscores enthalten. (außer Structs, Klassen und Zeiger auf Structs oder Klassen)

typedef int ALARM_PRIORITAET;

2. Die Namen von Aufzählungstypen folgen den Regeln für typedefs. Die Namen öffentlicher Aufzählungstypen tragen den Modulpräfix. Die Namen der Denoter beginnen mit einem Präfix, der dem Namen des Aufzählungstyps entlehnt ist. Da die Denoter den Status von (öffentlichen) Konstanten haben, bestehen ihre Namen aus Großbuchstaben.

typedef enum { F_ROT, F_GRUEN, F_BLAU } FARBE;
typedef enum { ZG_NURLESEN, ZG_NURSCHREIBEN, ZG_WAHLFREI } MEM_ZUGRIFF;

3. Die Namen von Structs und Klassen beginnen mit einem großen C und bezeichnen Klassifizierungen von Substantiven. Sie dürfen keine Underscores enthalten. Bei zusammengesetzten Wörtern werden Großbuchstaben verwendet.

typdef struct CComplex // bei struct Groß/Kleinschreibung trotz typedef!
{
    float m_fReal;
    float m_fImag;
} CComplex;

class CDatenbank;
class CSchnellerSpeicher;

typedef CComplex* PComplex;
typedef CSchnellerSpeicher* PSchnellerSpeicher;

Datenobjekte

1. Variablennamen beginnen immer mit einem kleinen Buchstaben (ein Modulprefix gilt nicht als Namensbestandteil).
2. Variablennamen bezeichnen Substantive. Bei Bedarf kann ein Artikel und/oder Adjektiv(e) vorangestellt werden (um z.B. der vorhergehenden Forderung zu genügen).

int nObereGrenze;
CDocument dasDokument;
void* pDatenpuffer;

3. Private Namen beginnen mit einem Underscore.

int _nGesamtFehlerAnzahl;

4. Falls sich öffentliche Variablen nicht vermeiden lassen, werden sie zusätzlich mit dem Modulpräfix versehen.

int* Mmgr_pDerEinzigeSpeicherVorrat;

5. Mit #define definierte Konstanten werden groß geschrieben und dürfen Underscores enthalten.

#define MAX_LIMIT 1234

Die Namen öffentlich deklarierter Konstanten dürfen ebenfalls dieser Konvention folgen.

const int nMaxLimit = 1234;
const int Stack_nMaxLimit = 1234;
const int MAX_LIMIT = 1234;

6. Variablen dürfen innerhalb ihres Geltungsbereichs nicht für verschiedene Zwecke genutzt werden.
7. Variablennamen beginnen mit einem Typprefix. Der eigentliche Name beginnt mit Großbuchstaben, gefolgt von Kleinbuchstaben. Bei zusammengesetzten Namen wird wieder mit Großbuchstaben begonnen, es werden keine Unterstriche benutzt. Ausnahmen: Laufvariablen (i, j, …)

int nFehler;
int nGesuchterWert;
LPCSTR lpszBenutzerName;

8. Die Namen von Elementvariablen erhalten das Präfix m_.

class CFehlerstatus
{
    int m_nStatusCode;
    LPCSTR m_lpszFehlermeldung
};

Makros, Funktionen

1. (C) Makronamen werden groß geschrieben und dürfen Underscores enthalten.

#define ABS(x) (0 > (x) ? -(x) : (x))

(C++) Die Verwendung von Makros ist unzulässig. Stattdessen sind inline- bzw. template-Funktionen zu verwenden.

2. Funktionsnamen beginnen mit Großbuchstaben, gefolgt von Kleinbuchstaben. Bei zusammengesetzten Namen wird wieder mit Großbuchstaben begonnen, es werden keine Underscores benutzt. Öffentliche Funktionen eines Moduls werden mit einem Modulprefix Xyz_ gekennzeichnet.

void DurchsucheBaum(const PKNOTEN pAusdrucksBaum);
BOOL Msg_NachrichtIstVorhanden(void);

3. Funktionen ohne Rückgabewert oder mit einem Statusrückgabewert beginnen mit einem Verb. Der Imperativ ist zu bevorzugen, also

nicht	TagesdatumSetzen(const PGmsDatum pDatum),
sondern	SetzeTagesdatum(const PGmsDatum pDatum); void SendePaket(const PGmsPaket pPaket); ERRORTYPE PruefeName(LPCSTR pName);

1. Namen von Funktionen mit einem Rückgabewert beginnen mit einem Substantiv oder Adjektiv, das den Rückgabewert beschreibt.

ALARM NaechsterAlarm(const PTIME pBezugsZeitpunkt);
LPCSTR Benutzername(const int nBenutzernummer);

also nicht:

LPCSTR LiesBenutzername(int nBenutzernummer)!

2. Funktionen mit dem Rückgabewert BOOL beginnen mit Ist bzw. Hat:

BOOL IstGueltigerName(LPCSTR pName);
BOOL HatFehlerzustand(void);

3. Namen von Konversionsfunktionen haben die Form „Quelle"Nach„Ziel".

int HexNachBinaer(LPCSTR lpszHexzahl);

5. (C, Pascal) Eine Initialisierungsfunktion ist eine Funktion, die Datenstrukturen aus ihren Bestandteilen erzeugt. Initialisierungsfunktionen sind von Konversionsfunktionen zu unterscheiden. Initialisierungsfunktionen liefern als Wert eine Datenstruktur. Die Namen von Initialisierungsfunktionen beginnen mit Build. Falls ein Zeiger auf die neue Datenstruktur zurückgegeben wird, beginnt der Name der Funktion mit New. Letztere Funktionen liefern bei Rückgabe von Zeigern allozierte Datenstrukturen, die vom Aufrufer durch Aufruf einer Freigabefunktion freigegeben werden müssen. Namen von Freigabefunktionen beginnen mit Delete. Diese Namensprefizes haben den Charakter von Schlüsselwörtern (sie entsprechen u.a. den Operatoren new und delete in C++) und sind deshalb aus der englischen Sprache gewählt.

void BuildZeit /* (C) */
    (
        PZeit this,
        const int nStunden,
        const int nMinuten,
        const int nSekunden
    );

PZeit NewZeit
    (
        const int nStunden,
        const int nMinuten,
        const int nSekunden
    );

void DeleteZeit(PZEIT pZeit);

(C++, Delphi) Solche Initialisierungsfunktionen sind unzulässig. Es sind Konstruktoren, Cast-Operatoren und Destruktoren (C++: zusammen mit den Operatoren new und delete) zu verwenden. Die Namen von Funktionen, die Speicher für ein Datenobjekt auf dem Heap verwenden, der vom Aufrufer freizugeben ist, beginnen mit New.

Typprefizes

Wesentliche Teile der hier aufgeführten Tabellen wurden ursprünglich von Microsoft für die Erstellung von Windows-Anwendungen vorgeschlagen [Petz90].

Typenprefizes für Variablennamen

1. Namen von Variablen selbstdefinierter Strukturen, Typen etc. können, müssen aber kein besonderes Prefix erhalten. Wird ein Prefix verwendet, ist es bei der Deklaration des Typs anzugeben und überall zu verwenden.
2. Variablen, die einen enum-Typ repräsentieren, erhalten das Präfix n, da ihre Größe systembedingt von der Integer-Größe abhängt.
3. Für selbstdefinierte Klassen oder structs können Prefizes ähnlich denen für Moduln sinnvoll sein. Diese Abkürzung wird im Klassenkopf mit angegeben.

struct CKonfigurationsdaten;
CKonfigurationsdaten knfGeraet1;

4. Weitere (hier nicht berücksichtigte) system- bzw. compilerbedingte Besonderheiten (z.B. Zeiger auf speziell reservierte Speicherbereiche) sind in getrennten Richtlinien aufzuführen.

Allgemeine Namenprefizes

Der verwendete Präfix Mod steht für eine sprechende Abkürzung des Modulnamens (vorzugsweise 3-5 Zeichen).

Von Windows-Anwendungen verwendete Symbole

[weiter in "Programmierstil"] | [Inhalt] | [Einleitung] | [Layout] | [Programmierstil] | [Anhänge]

Copyright © 1996-98 by Uwe Sauerland