Benennung, von variablen,Prozeduren,FunKtionen

[khalilazzz]

hallo zusammen
gibt es regeln,wei man variblen,proczeduren,functionen benenen kann.damit die Quellcode von jedem verstanden wird.
ich habe problemen damit,die richtige Name für variablen,functionen und prozeduren zu finden.
kennt jemand vieleicht einen tutorial dafür.
im voraus vielen dank

[marabu]

Hallo,

da bist du nicht alleine mit deinem Problem. Die Namensgebung ist mit das schwierigste beim Programmieren - der Entwurf von Algorithmen ist da vergleichsweise einfach...

Am besten man schaut mal, wie es die Entwickler bei Borland machen. Im Laufe der Zeit hat sich da einiges als stabil herausgestellt. Der Quellcode der VCL ist ein gutes Studienmaterial. Oder, wenn man keine Quellcode-Lizenz hat, die Bücher der Delphi Evangelisten (Calvert, Pacheco, Teixeira, ...). Bei Steve Teixeira war damals (D4) ein Kapitel zur Namensgebung dabei, wenn ich nicht irre.

Ansonsten gilt vor allem eines: bleib konsistent bei dem was du machst. Wechsle nicht - schon gar nicht innerhalb eines Projektes.

Grüße vom marabu

[leddl]

Naja, ein Tutorial ist wohl etwas übertrieben, das macht jeder etwas anders.
Aber ein paar Tips gebe ich gerne.
Es hat sich eingebürgert, Zählvariablen für Schleifen i,j,k,... zu nennen. Ausnahme wären hier natürlich Koordinaten, die man natürlich praktischerweise mit x,y,z betitelt.
Prozeduren und Funktionen solltest du am besten mit einem aussagekräftigen Namen angeben. Am besten auch noch in Englisch, damit auch Leute aus anderen Ländern erkennen können, was die Prozedur macht.
Ebenso verhält es sich mit Variablen. Kurze, knackige (am besten Englische), aber erklärende Begriffe sind immer am praktischsten. Wichtig ist halt, daß ein Name für eine Variable oder Prozedur nicht über eine ganze Zeile geht, nur weil du erklären willst, was diese Prozedur macht.
Komponenten solltest du ein Prä- Oder Suffix anstellen, an dem man erkennen kann, um welchen Typ es sich handelt, zb NameEdit (TEdit), ListLB (TListBox), BoldCB (TCheckBox),...
Die Variablen einer Klasse, die als Platzhalter für die Properties stehen, bekommen üblicherweise ein f vorangestellt. (zb property Size : Integer ==> fSize : Integer)

[Sanchez]

Hallo,

Im Object Pascal Styleguide von Charles Calvert wirst du einige Infos finden.
Luckie hat ihn z.B. auf seiner HP: http://luckie-online.de/Developer/Ar...yleGuide.shtml

@Luckie: Hab grad bemerkt, dass die Links im Inhaltsverzeichnis mitten ins Nirvana zeigen.

grüße, daniel