Co kryje siΩ pod tym do╢µ
tajemniczym tytu│em? Zapewne wielu z Was jest teraz poch│oniΩtych
nauk▒ Delphi. Zapewne tak jak ja podczas nauki zapominacie o do╢µ wa┐nej
sprawie podczas pisania program≤w. W niniejszym artykule spr≤buje Wam
przedstawiµ spos≤b kodowania program≤w. Po co to robiµ - zapytacie?
Ot≤┐ dla zwiΩkszenia czytelno╢ci kodu. Uwierzcie mi, ┐e je┐eli
zaczniecie siΩ stosowaµ do przedstawionych poni┐ej wskaz≤wek Wasz
kod nagle zyska na czytelno╢ci. Wa┐ne jest to wtedy gdy udostΩpniacie
kod innej osobie.
Przede wszystkim staraj siΩ stosowaµ
wciΩcia. Nie pisz jednej linii pod drug▒ w jednym rzΩdzie. WciΩcia
powinny mieµ wielko╢µ dw≤ch spacji. Tak┐e jedna linia kodu nie
powinna przekraczaµ wielko╢ci 80 znak≤w. Instrukcje d│u┐sze powinny
byµ podzielone znakiem "+". Kolejna linia powinna byµ wciΩta
o dwa znaki.
Przy pisaniu staraj siΩ, aby s│owo begin
stanowi│o oddzieln▒ liniΩ.
if X = 20 then
begin //tak jest nieprawid│owo
if X = 20 then
begin
Edit1.Text := 'Tak!';
end else
Edit1.Text := 'Nie';
Exit; //Tak
jest prawid│owo
Zauwa┐, ┐e pomiΩdzy znakiem
"=" postawione s▒ spacje zwiΩkszaj▒ce czytelno╢µ tekstu.
Nazwy procedur powinny byµ pisane w
tzw. wielb│▒dzim stylu:
procedure tojestmojaprocedurawykonujacapewnaczynnosc;
Powiniene╢ pisaµ tak:
procedura ToJestMojaProceduraWykonujacaPewnaCzynnosc;
To samo tyczy siΩ nazewnictwa
komponent≤w.
Instrukcja if tak┐e nie
powinna przekraczaµ piΩciu poziom≤w. W takiej sytuacji lepiej jest u┐yµ
instrukcji case.
case ComboBox1.ItemIndex
of
1:
begin
...
end;
2:
begin
...
end;
WszΩdzie tam gdzie jest to mo┐liwe
stosuj instrukcje with. Np.
with MediaPlayer
do
begin
FileName := 'Piosenka.mid';
Open;
Play;
end;
Nazwy formularza powinen mieµ nazwΩ
zako±czon▒ przyrostkiem Frm, np:
MainFrm, AboutFrm, ChildFrm.
W kodzie ╝r≤d│owym na pocz▒tku
umieszczaj informacjΩ o jego autorze i przeznaczeniu np.
(************************************)
{ Pad v. 1.0
}
{ Copyright © 2000 by Adam Boduch }
{ All rights reserved
}
{ e-mail: boduch@poland.com
}
(************************************)
Staraj siΩ nazywaµ komponenty
zgodnie z ich przeznaczeniem - np. BtnZamknij, edtImie. Nie ulegaj z│udzeniu,
┐e skr≤towe nazwy zmiennych s▒ lepsze. Zamiast pisaµ:
var
S, A, B : String;
n, g, h : Boolean;
pisz:
var
Imie, Nazwisko : String;
WpisaneImie : Boolean;
Unikaj stosowania typu
zmiennoprzecinkowego Real - zalecane jest u┐ycie Double.
Pisz▒c w│asn▒ klasΩ przed jej
nazw▒ pisz literΩ "T". To samo tyczy siΩ wyj▒tk≤w tyle,
┐e nale┐y u┐ywaµ litery "E".
I jeszcze jedna porada - stosuj
komentarze! Wierz mi, ┐e jak po kilku miesi▒cach spojrzysz na sw≤j
kod bΩdziesz mia│ trudno╢ci z jego odczytaniem.
Mam nadzieje, ┐e rady jaki tu
przetoczy│em pomog▒ Wam przy pisaniu program≤w. Trzymajcie siΩ!
