Eure Programmierkonventionen ?

Gerard

Original erstellt von Shade Of Mine:
**der user muss
Dimah::Private::WhatsLessThanWith::replace
aufrufen!
da ist Dimah::ReplaceWhatsLessThanWith schon besser!

warum sollte er dass denn nicht? da spart er sich doch sinnlose ifs und aufrufe von string::size()

nicht dass das so teuer waere, aber in 90% der Faelle weiss der Anwender ja schon, was groesser ist!**

naja ob

Dimah::WhatsLessThanWith::replace
Dimah::ReplaceWhatsLessThanWith

Vom Schreibaufwand ist es doch fast gleich und die Vorteile der namespace Lösung habe ich schon genant.
Jetzt ist die Frage ob Private oder nicht Private, ok in diesen Fall ist der Private teil noch Eingärmassen brauchbar für den User, aber anderseits will ich den User der die lib nutzt und nur einfach replacen will nicht mit unnötigen Details belasten "welches replace brauche ich den?, was ist waht?" und am Ende bringt es ihn nichts messbares.
Der normale User sieht "Private" ah ok weiter brauche ich nicht zu gehen, der User der unnötige size aufrufe sparen will, oh "Private" ;).

kartoffelsack

Funktionsnamen beginnen mit Verb und groß.

Variablen mit Typkennung (angelehnt an ungar. Not. - was daran immer alle so schrecklich finden, versteh ich nicht. ). Member-Variablen mit m_

Klassen mit C, Funktionsklassen mit F (da hat mir noch keiner nen anderen tollen Vorschlag gemacht).

Ansonsten ziehmlich viele Leerzeilen, Zeilenumbrüche. Find ich halt irgendwie übersichtlicher.

Ich rücke zwei Leerzeichen ein.

Variablendeklarationen schreib ich so:

double
  dWert;

d.h. den Typ in eine extra-Zeile und ein Zeichen weiter eingerückt. So find ich die erste Verwendung (Deklaration) einer Variable auf Anhieb. Der eigentliche Auslöser dafür waren aber Templates

std::multimap<CAussageKraeftigerName, FSortierungNachXXXSchema> mpAussageKraeftigeNamen;

is einfach schrecklich.

Ansonsten mach ich Kommentare für Doxygen, wo ichs für nötig finde auch im Code (allerdings formulier ich da wenig aus und achte nich so auf Grammatik etc.).

Alles was Code ist in Englich (Variablennamen etc), Kommentare aber in Deutsch, da sonst die Bereitschaft sinkt, welche zu schreiben.

Mit Namespaces gruppier ich die Klassen, mach die Namespaces aber nie länger als 4 Buchstaben, weil sie sonst zu nervig werden (mach sie normalerweise nicht auf).

[ Dieser Beitrag wurde am 02.12.2002 um 19:32 Uhr von kartoffelsack editiert. ]

davie

Was mit namespace aliases?

kartoffelsack

@dimah

Wenn ich Funktionen innerhalb von ner Bibliothek Privat machen will, schreib ich die in Klassen statt nem namespace und erklär MEINE Klassen zu friends davon.

Dann muss ich mich nicht drauf verlassen, dass der Benutzer meinen Namespace "Privat" respektiert.

Geht das auch ohne namespaces, stattdessen ungarische notation?

rüdiger

Taster schrieb:

Geht das auch ohne namespaces, stattdessen ungarische notation?

Ungarische Notation war noch nie als Ersatz für namespaces gedacht. Warum du aber dafür einen 4 Jahre alten Thread ausgraben musst, verstehe ich nicht.