C++ #ifndef für include-Dateien, warum ist all caps verwendet, für die header-Datei?

Diese sind Präprozessor-Symbole und haben keine solchen Regeln. (solange Sie mit den #defines im Header)

Jedoch, die Konvention ist die Verwendung von Großbuchstaben für Präprozessor-Symbole.

Ist es nicht erforderlich, alle in Großbuchstaben geschrieben werden. Es ist nur die Allgemeine Konvention. Normalerweise verwende ich etwas wie #ifndef MYHEADER_H_INCLUDED.

Die Idee ist, um sicherzustellen, dass Ihre header-Datei nur einmal gelesen während bauen. Das idiom, um dies zu erreichen, ist die Struktur:

   #ifndef _SOME_UNIQUE_NAME
   #define _SOME_UNIQUE_NAME
   /* The actual header code */
   #endif

Dies bedeutet, dass Sie sollten wählen Sie einen Namen, Sie sind ziemlich sicher, einzigartig sein und einen gültigen Bezeichner #ifndef. Sie sollten auch sicherstellen, dass die Bezeichner nicht in tatsächliche code oder verwirrt mit einer variable oder so etwas. Mit einem Großbuchstaben tag markiert das idiom deutlich. Außer, dass, es ist lediglich von Konventionen nicht Sprache, diktieren, dass die Wahl. Die Visual Studio-Assistenten generiert eine GUID wie Bezeichner für. Sone Compiler support #pragma once, die den gleichen Effekt haben.

Es ist völlig subjektiv und es gibt keine durchsetzbare Regeln andere als die normalerweise in Verbindung mit dem Zeichensatz zur Benennung von Präprozessor-Makros. Es ist üblich für Makros definiert werden, die im oberen Fall. Dieser neigt dazu, Ihnen helfen, zeichnen sich in source code. Eine Konvention, die ich neigen dazu, zu bleiben, um die strengen aktivierte version des Dateinamen mit der Periode durch einen Unterstrich ersetzt und führende und nachfolgende Unterstriche. So, nach einer Datei namens DataTableNameMangler.hpp den include-guard Aussehen würde:

#ifndef _DATATABLENAMEMANGLER_HPP_
#define _DATATABLENAMEMANGLER_HPP_

...

#endif //_DATATABLENAMEMANGLER_HPP_

Gibt es keinen guten Grund für diese, obwohl ich empfehle, Konsistenz, dass der name mit dem Dateinamen genau. Ich normalerweise benutze ein wenig die Klasse creator Skript, um die Erstellung meiner ersten Klassen. Das folgende Bash-snippet gibt eine Idee:

#!/bin/bash
INC_GUARD_NAME="_${1^^*}_HPP_"
echo "#ifndef $INC_GUARD_NAME"
echo "#ifndef $INC_GUARD_NAME"
echo
echo "class $1 {};"
echo
echo "#endif //$INC_GUARD_NAME"

Also:

$ ./makeclass.bash DataTableNameMangler
#ifndef _DATATABLENAMEMANGLER_HPP_
#ifndef _DATATABLENAMEMANGLER_HPP_

class DataTableNameMangler {};

#endif //_DATATABLENAMEMANGLER_HPP_

Dies ist natürlich nur ein sehr einfaches Beispiel. Wichtig ist, denken Sie daran, dass der Kommentar vor der Wache-name in die Letzte Zeile. #endif übernimmt keine Parameter, so wird das makro übergeben werden, der auf der C++ - compiler wird sich beschweren, wenn es nicht kommentiert.