wtorek, 10 sierpnia 2010

Dylemat konwencji nazweniczej

Myślę czy zastosować w moim projekcie notację węgierską ale trochę zmodyfikowaną:


Prefiks Od czego pochodzi Opis Typ Przykład
i integer całkowitoliczbowe int, short, long iLiczba
ui unsigned integer całkowitoliczbowe bez znaku unsigned int, unsigned short, unsigned long uiLiczba
f float zmiennoprzecinkowe float, double fXPos
p pointer Wskaźniki type * pImage
a array tablica type [ ] pImage
I Interface interfejsy(klasy z wirtualnymi metodami) virtual class IManager
C Class klasy class CImageManager
k kit typy złożone(instancje klas i struktur) type, struct kImage
m_ member of składowe(pola) używane w class, struct m_pImage
E Enumerate enumeraty enum EFlags
f flag flaga bitowa stosowane w enum fVsync
sz string zero napis zakończony zerem char [] szHello

Tabela może być nie kompletna, ale myślę że wymieniłem to co najważniejsze.
Proszę o porady w komentarzach i o oddanie swojego głosu w ankiecie dotyczącej tematu.
Warto przeczytać ten artykuł: http://dezinformacja.org/tarpit/archiwum/1116915727

Może podam kilka złożonych przedrostków:
pk // pointer kit  wskaźnik na typ złożony
m_p // member of pointer członek, wskaźnik
m_pk // member of pointer kit członek, wskaźnik na typ złożony

m_pi // member of pointer integer członek, wskaźnik liczby całkowitej
m_pf // member of pointer float członek, wskaźnik liczby zmiennoprzecinkowej

m_api // member of array pointer integer członek, tablica wskaźników liczb całkowitych
m_apk // member of array pointer kit członek, tablica wskaźników na typ złożony

m_af // member of array flag członek, tablica flag

m_asz // member of array string zero członek, tablica napisów zakończonych zerem

2 komentarze:

  1. Widze, ze zastanawiasz sie czy uzywac notacji wegierskiej. Ja bym odradzal. Na pewno uzywasz jakiegos IDE do pisania kodu. W niemal kazdym masz mozliwosc podejzenia typu zmiennej. Nie ma sensu niepotrzebnie zaciemniac kodu. Jesli juz to polecam chociazby to: http://www.possibility.com/Cpp/CppCodingStandard.html. Aha, czemu nie uzywac notacji wegierskiej? Wystarczy spojrzec na API windowsa (jak bardzo jest czytelne..) i porownac np. z kodem w Javie. Tak czy inaczej grunt, zeby kod byl pisany w jednakowy sposob. Jeszcze jedno. Jesli przyjdzie utrzymywac taki kod pisany w notacji wegierskiej przez inne osoby to zapewniam cie, ze srednio beda sie trzymaly tak narzuconych regul :)

    Ostatecznie kazdy standard jest dobry (nie kazdy musi byc jednak wygodny:P), aby tylko sie jego trzymac w trakcie developmentu.

    OdpowiedzUsuń
  2. Hej, również odradzam węgierską... czytelność kodu strasznie na tym cierpi. A gdy mamy do zaimplementowania większy kawałek kodu, o skomplikowanej logice, to przeanalizowanie poprawności tego, co właśnie napisaliśmy jest istną masakrą o.O

    OdpowiedzUsuń