Autor Beitrag
NeoInDerMATRIX
ontopic starontopic starontopic starontopic starontopic starontopic starontopic starhalf ontopic star
Beiträge: 245

Win95, Win98(+se), WinNT, Win2000, WinME, WinXP(+pro), VISTA, Linux(SuSe), DOS [MultiMon(3)], Vista
D6 PeE + (FP 2.0l) + D3 Pe + D2005+ D2006 Arch
BeitragVerfasst: Mi 06.10.04 22:58 
Hallo,

ich habe da mal ne frage!
Was findet ihr besser beim Coden, wenn man Variablennamen und Functionsnamen ausschreibt oder abkürtzen tut?

Ich meine sowas wie:
ausblenden Delphi-Quelltext
1:
2:
3:
4:
5:
6:
7:
8:
9:
10:
11:
12:
13:
14:
Var
 RC: HGLRC;
 DC: HDC;
 Wnd: HWND;
 PFD: TPIXELFORMATDESCRIPTOR;
 .
 .
 .
 DC:=GetDC(Wnd);
 .
 RC:=wglCreateContext(DC);
 .
 .
Function SetScr(X, Y, CD);

oder
ausblenden Delphi-Quelltext
1:
2:
3:
4:
5:
6:
7:
8:
9:
10:
11:
12:
13:
Var
 RenderContext: HGLRC;
 DeviceContext: HDC;
 WindowHandle: HWND;
 PixelFormatDescriptor: TPixelFormatDescriptor;
 .
 .
 .
 DeviceContext:=GetDC(WindowHandle);
 .
 RenderContext:=GetDC(DeviceContext);
 .
Function SetScreenMode(SizeX, SizeY, ColorDepth);


Was denkt ihr dazu?

Cu
Neo

Moderiert von user profile iconChristian S.: Code- durch Delphi-Tags ersetzt.
Jörg
ontopic starontopic starontopic starontopic starontopic starontopic starontopic starontopic star
Beiträge: 71

Win 2000, Win XP
Delphi 1, 3, 5, 7
BeitragVerfasst: Mi 06.10.04 23:35 
Lieber ausschreiben oder nicht so extrem abkürzen. Dein Kollege, der als nächstes was an Deinem Quelltext ändern muss, wird's Dir danken. Auch Du selbst wirst von der besseren Lesbarkeit profitieren, wenn Du nach 3 Jahren mal wieder einen Blick in das Projekt wirfst. Allgemeingültige Abkürzungen sind logischerweise erlaubt, wie z.B. i und k als Iterationsvariablen oder Btn für Button etc.

Um gleich mal die Gegenargumente von Abkürzungsfetischisten zu entkräften:
Strg + Leertaste
with ... do

Jörg.
.Chef
ontopic starontopic starontopic starontopic starontopic starontopic starontopic starofftopic star
Beiträge: 1112



BeitragVerfasst: Do 07.10.04 08:42 
Lieber gescheit(!) abkürzen als ausschreiben. Wie eine gescheite Abkürzung aussieht, hängt vom Context ab. Manchmal ist "ph" für ein Prozesshandle genug, manchmal nicht. Aber nichts ist schlimmer als ein durch romanartige Variablennamen überfüllter Quelltext.

_________________
Die Antworten auf die 5 häufigsten Fragen:
1. Copy(), Pos(), Length() --- 2. DoubleBuffered:=True; --- 3. Application.ProcessMessages bzw. TThread --- 4. ShellExecute() --- 5. Keine Vergleiche von Real-Typen mit "="!
uall@ogc
ontopic starontopic starontopic starontopic starontopic starontopic starontopic starofftopic star
Beiträge: 1826
Erhaltene Danke: 11

Win 2000 & VMware
Delphi 3 Prof, Delphi 7 Prof
BeitragVerfasst: Do 07.10.04 09:11 
in deinem beispiel find das abkürzen besser weil man einfach wissen muss was RC, DC, Wnd, PFD ist :)
Motzi
ontopic starontopic starontopic starontopic starontopic starontopic starontopic starhalf ontopic star
Beiträge: 2931

XP Prof, Vista Business
D6, D2k5-D2k7 je Prof
BeitragVerfasst: Do 07.10.04 09:17 
Also ich find das hängt immer ganz davon ab... Ich find in einer kurzen übersichtlichen Prozedur können lokale Variablen auch mal "undurchsichtige" Abkürzungen (eben aus 2 oder 3 Buchstaben) haben, da man durch einen kurzen Blick in die Variablen-Deklaration eh sofort sieht um was es geht. Bei globalen Variablen oder Objekt-Feldern schaut die Sache schon anders aus, da versuch ich schon möglichst aussagekräftige Namen zu vergeben, wobei ich schon auch versuch vernünftig abzukürzen wie zb Wnd für Window etc...

_________________
gringo pussy cats - eef i see you i will pull your tail out by eets roots!
Jörg
ontopic starontopic starontopic starontopic starontopic starontopic starontopic starontopic star
Beiträge: 71

Win 2000, Win XP
Delphi 1, 3, 5, 7
BeitragVerfasst: Do 07.10.04 10:17 
Schließe mich Motzi an, lokale Variablen, deren Deklaration 5 Zeilen weiter oben steht, müssen nicht aussagekräftig sein. Und sprechende Abkürzungen sind ja wohl auch kein Thema, statt ErmitteltesGesamtErgebnis kann man auch GesErg schreiben. Auf jeden Fall sollten sprechende Bezeichner bei Übergabeparametern von Prozeduren eingesetzt werden.

Und zu den Romantexten: Wenn ich 5x memoMeinHinweisText.lines[i] brauche, dann kommt das in eine lokale Variable mit kurzem Namen.

Jörg.
sourcehunter
ontopic starontopic starontopic starontopic starontopic starontopic starofftopic starofftopic star
Beiträge: 482

Win XP | Suse 10.1
Delphi 2005 Pers.
BeitragVerfasst: Do 07.10.04 19:19 
Ich finde, dass es von den Vorlieben des Programmieres abhängt. Wenn du gut mit Abkürzungen zurechtkommst, dann kannst du sie benutzen. Aber ich denke, dass alle Programmierer faul sind, und deshalb muss man sich meißt dazu zwingen nicht zu viele Abkürzungen zu benutzen.

_________________
Linux und OpenSource rulez!