Eure Programmierkonventionen ?

Gerard

das _ am ende erkennt man doch bevor man den ersten buchstaben gelessen hat,

Marc++us

Ehrlich? Beim Buch lese ich ja auch den Schluß zuerst... aber bei den Bezeichnern...

Daniel E.

Original erstellt von Marc++us:
**Was lese ich als erstes bei einem Bezeichner? Das erste Zeichen. Und wo hängen die Jungs die Markierung dran? Am Ende.
**

Man macht es hinten dran, _damit_ man den Text so lesen kann, wie man gerne geschrieben hätte, nämlich ohne Kennzeichung. Man _soll_ es also 'überlesen'. Konstruktionen wie Class::member oder this->member machen mehr Arbeit als member_.
IMHO.

DrGreenthumb: Wieso denn?

// C++
struct foo {};
void bar () { foo foo; }

Ist legal.

Gregor: Jap, ich hab' mich wiederholt, hab das allerdings mit noch 2 Minuten vor deinem Post bearbeitet :).

DrGreenthumb

// C++
struct foo {};
void bar () { foo foo; }

Ist legal.

Ich bin erschüttert...

Ok, das geht tatsächlich. Aber ich schreib meine Klassen trotzdem lieber groß

@Marc++us: Was meinst du eigentlich zu der Tab und Leerzeichengeschichte? Was benutzt du?

Gerard

Original erstellt von Marc++us:
Ehrlich? Beim Buch lese ich ja auch den Schluß zuerst... aber bei den Bezeichnern...

kuckt man sich nicht automatisch erst das gesamt bild des wortes an?

Marc++us

Original erstellt von <Meinungsfrage>:
@Marc++us: Was meinst du eigentlich zu der Tab und Leerzeichengeschichte? Was benutzt du?

3 Blanks statt Tab. Mein Vorteil ist, daß ich das verbindlich für alle in der Firma festlegen kann.

Aber das ist eigentlich ein Nicht-Thema, das mit Programmierkonventionen gar nichts zu tun hat. Eine Lizenz z.B. für den frei konfigurierbaren SourceStyler kostet 300$ und formatiert jeden Quelltext (einschließlich der {}-Debatte) so um wie gewünscht. Formatierungen sind eigentlich kein wesentlicher Inhalt für eine Programmierkonvention.

Solche Themen wie Namensgebung halte ich für wichtiger.

Shade Of Mine

zu { und }
In der C Bibel steht: egal ob
foo() {
oder
foo()
{

Hauptache immer gleich.

Blue-Tiger

also ich verwende für die Klammern den "Allman style", sprich

void bla()
{
}

"K&R style" (also bla(){ ) find ich zu unübersichtlich.......

sonstige Konventionen:

Variablen-, Funktions- und alle anderen möglichen Namen werden aus dem Englischen Abgeleitet, nicht aus dem Deutschen.

Kommentare auch in Englisch (brech ich ab und an für kleinere Projekte - mein engl. ist nicht ganz so doll), und VIELE Kommentare (manche sagen ich kommentiere zu viel), meistens vor jedem längeren Block ein Kommentar, was dieser Block überhaupt macht (quasi eine Überschrift).

Variablennamen beginnen mit einer 1-Buchstaben-Abkürzung ihres Datentypes, z. b. "iIrgendwas" für einen Integer..... Außnahme sind Variablen für for-Schleifen, die meistens beliebige Kleinbuchstaben aus dem Alphabet sind.

gleiches gilt für Konstanten, die anstonsten Groß geschrieben werden

Funktionen ("Fitzelarbeiten" wie getBla()und sonstiger Kleinram natürlich nicht) erhalten nach dem Funktionskopf eine Beschreibung ihrer selbst, inkl. Parameter und Rückgabewert. (will auch beginnen, Nebeneffekte zu kommentieren)

überleg

ach ja, für kleinere Projekte: ich benutze Prototypen, die erste eigentliche Funktion im Quelltext ist immer main, alles andere (z. B. main steht ganz am Ende, auf Prototypen wird komplett verzichtet) ist mehr als nur unübersichtlich, IMHO

rüdiger

Also ich kommentiere auch immer in Englisch. Ich kommentiere aber sehr wenig, da ich denke, dass zu viele Kommentare eher überflüssig sind und man lieber den Code eindeutiger schreiben sollte, die meisten Kommentare verweisen bei mir auf das was noch zu tun ist (fangen mit einem [TODO] an) oder mit Warnungen, wo es später hacken könnte (fangen mit [warning] an), dann kann man einfach mit eingem grep die entsprechenden Zeilen auslesen.

@Marc++us
aber führende _ sind dem Compiler vorbehalten, da bleibt mir nur ein _ am ende, aber da ich das nur für Parameter mal benutze, finde ich es nicht alzu schlimm.

indent ist auch ein Programm zum umformatieren von Source Code, aber Open Source.

volkard

Also ich kommentiere auch immer in Englisch.

und hast keine probleme mit dem finden der allerbesten begriffe?
einer, meiner kommentare, die immer wieder hier landen, ist

//Ein Heap ist ein Binärbaum mit der Bedingung, daß jeder 
    //Knoten kleinergleich seinen beiden Kindern (falls 
    //vorhanden) ist. Diese Implementierung als Array 
    //garantiert außerdem, daß der Baum ballanciert ist. 
    //Einfügen eines beliebeigen Elements und Ausfügen 
    //des kleinsten haben nur logarhitmischen Zeitbedarf. 
    //Weil die Integritätsbedingung schwächer als beim 
    //normalen Binärbaum ist, ist der Heap auch ein wenig 
    //schneller.

was heißt das auf englisch? und: trifft die übersetzung den nagel auf den kopf?

ich gebe ja zu, daß ich englische texte flüssig lesen kann, aber übersetzungen von begriffen wie "Eichmaß", "transitive Hülle", <joke>"kreisfreier zusammenhängender Graph",</joke> "Girokonto" oder "Urvater" fallen mir zu schwer, um auch nur im entferntesten annehmen zu können, es bestünde eine glaubhafte chance, den allerbesten begriff zu wählen, und das geht sowohl den bezeichnern als auch den kommentaren so.

rüdiger

@volkard
ja, so Situationen sind oft kritisch, da muss man sich eben auf sein Wörterbuch verlassen.

rüdiger

BTW.
was mir gerade einfällt, seit ihr Typen, die Leerzeichen zwischen Operanden und Operatoren machen?

Also

a = b + 1;

anstelle

a=b+1;

Also ich mach nur Leerzeichen, falls ich das Gefühl habe, dass es ansonsten wirklich übersichtlich wird

also

if(a&&!b)

da finde ich übersieht man so leicht das wichtige !

volkard

Original erstellt von kingruedi:
@volkard
ja, so Situationen sind oft kritisch, da muss man sich eben auf sein Wörterbuch verlassen.

hast natürlich recht.

das war google.

a heap is a binary tree with the condition that everyone is 
small knot its two children (if available).  In addition this 
implementation as array guarantees that the tree is ballanced. 
inserting one like-own element and deleting the smallest have 
only logarhitmic time requirement.  because the integrity 
condition is weaker than with normal binary tree, is the heap 
also a little faster.

das war ich:

a heap is a binary tree with the condition, that each
knot lowerequal his two children (if available) is.
this implementation as array guarantees in addition, 
that the tree ballaced is. insertion and deletion the 
smallest have only logarithmic time requirement.
becaus the integrity condition weaker as at the normal 
binary tree is, is the heap also a bit faster.

ich werde dennoch darauf setzen, daß nur die besten bezeichner und die besten kommentare gut genug sind.

volkard

Original erstellt von kingruedi:
Also ich mach nur Leerzeichen, falls ich das Gefühl habe, dass es ansonsten wirklich übersichtlich wird

ich auch.

Gregor

Ich mache viele Leerzeichen. Ich bin jemand, der sowas schreibt, wie:

for (int i = 0 ; i < blah ; ++i)
{
   a += (i << 1);
}

volkard

Original erstellt von Gregor:
**Ich mache viele Leerzeichen. Ich bin jemand, der sowas schreibt, wie:
for (int i = 0 ; i < blah ; ++i)
{
   a += (i << 1);
}
**

da fehlen aber noch sechs leerzeichen! so ist das ja total unlesbar!

for ( int i = 0 ; i < blah ; ++ i )
{
   a += ( i << 1 ) ;
}

Gregor

Original erstellt von volkard:
**da fehlen aber noch sechs leerzeichen! so ist das ja total unlesbar!
**

Die mache ich halt nicht. :p Ich habe aber auch schon oft genug Leerzeichen bei Klammern gesehen. Finde ich nicht so schön.

volkard

warum nicht nach inhalt zusammenfassen?

for( int i=0 ; i<blah ; ++i )
{
   a += (i<<1);
}

Gregor

Original erstellt von volkard:
**warum nicht nach inhalt zusammenfassen?
**

Hmmm... Ich habe gerade gesehen, dass das bei mir doch nicht so konsistent ist. Manchmal fasse ich auch nach Inhalt zusammen. Allerdings kommt bei mir immer ein Leerzeichen nach "for" und keins nach "(" und keins vor ")".

Ich mache z.B. auch oft folgendes :

a += array [i+1];