|
Zaleca się używanie następujących reguł przy tworzeniu nazw elementów i zmiennych:
- CONSTANT NAME piszemy dużymi literami i nie używamy w nazwach podkreślenia gdyż może to powodować nieczytelność kodu bądź błędną interpretację elementów interfejsu. Przykłady pisowni nazw: WYJSCIE, POMIAR, LED1, GRAPH. W nazwach nie wolno stosować polskich znaków i znaków spacji. Ograniczenie to wynika z specyfikacji języka ANSI C.
- Callback Function – pierwsza literę nazwy funkcji piszemy duża a pozostałe małymi, np. Wyjscie, Pomiar, Strat, NazwaElementu, Inicjuj_Karte itp. W nazwach funkcji nie można stosować polskich liter i znaków spacji.
- Nazwy zmiennych piszemy bez polski liter i bez znaków spacji. Zazwyczaj stosuje się małe litery, np. wartość, rms, avg.
Powyższe zasady spotyka się we wszystkich przykładach i instrukcjach producenta. Nie są one obowiązkowe ale polepszają czytelność kodu, funkcji i zmiennych. Przykładem może być tutaj pokrętło ustawiające jakąś wartość w programie. Przykładem stosowanego nazewnictwa dla tego elementu może być:
- CONSTANT NAME: WARTOSC
- Callback Function: Wartosc
- Nazwa zmiennej odczytywanej z elementu: wartosc
Zastosowanie omawianego wcześniej nazewnictwa pozwala szybko zorientować się że funkcja czy zmienna odnosi się do elementu WARTOSC.
|