Wybieranie nazw zmiennych, które są zgodne z regułami i konwencjami
- {liczbaMinut} minut
Deweloper oprogramowania powiedział kiedyś: "Najtrudniejszą częścią tworzenia oprogramowania jest nazywanie rzeczy." Nie tylko nazwa zmiennej musi być zgodna z pewnymi regułami składni, ale także powinna służyć do zwiększenia czytelności i zrozumienia kodu. To duże wymaganie dla jednego wiersza kodu!
Reguły nazw zmiennych
Istnieją pewne reguły nazewnictwa zmiennych wymuszane przez kompilator języka C#.
- Nazwy zmiennych mogą zawierać znaki alfanumeryczne i znak podkreślenia (_). Znaki specjalne, takie jak funt
#, kreska-, i znak$dolara są niedozwolone. - Nazwy zmiennych muszą zaczynać się od litery alfabetycznej lub podkreślenia, a nie liczby. Użycie znaku podkreślenia na początku nazwy zmiennej jest zwykle zarezerwowane dla pól prywatnych instancji. Link do dalszych informacji można znaleźć w podsumowaniu modułu.
- Nazwy zmiennych nie mogą być słowem kluczowym języka C#. Na przykład te deklaracje nazw zmiennych nie będą dozwolone:
float float;lubstring string;. - Nazwy zmiennych są rozróżniane pod względem wielkości liter, oznacza to, że
string MyValue;istring myValue;są dwiema różnymi zmiennymi.
Konwencje nazw zmiennych
Konwencje są sugestiami uzgodnionymi przez społeczność deweloperów oprogramowania. Chociaż możesz zdecydować się nie przestrzegać tych konwencji, są one tak popularne, że może to utrudnić innym deweloperom zrozumienie kodu. Należy ćwiczyć wdrażanie tych konwencji i uczynić je częścią własnych nawyków kodowania.
- Nazwy zmiennych powinny używać camel case, czyli stylu pisania, który zaczyna się małą literą, a każdy kolejny wyraz rozpoczyna wielką literą. Na przykład:
string thisIsCamelCase;. - Nazwy zmiennych powinny być opisowe i znaczące w aplikacji. Należy wybrać nazwę zmiennej reprezentującej rodzaj danych, które będą przechowywane (a nie typ danych). Na przykład:
bool orderComplete;, NIEbool isComplete;. - Nazwy zmiennych powinny zawierać jeden lub więcej całych wyrazów dołączonych razem. Nie używaj skrótów, ponieważ nazwa zmiennej może być niejasna dla innych osób, które czytają twój kod. Na przykład:
decimal orderAmount;, NIEdecimal odrAmt;. - Nazwy zmiennych nie powinny zawierać typu danych zmiennej. Możesz zobaczyć kilka porad, aby użyć stylu, takiego jak
string strMyValue;. To był popularny styl lat temu. Jednak większość deweloperów nie postępuje już zgodnie z tą radą i nie ma dobrych powodów, aby go nie używać.
W tym przykładzie string firstName; są zgodne wszystkie te reguły i konwencje, przy założeniu, że chcesz użyć tej zmiennej do przechowywania danych reprezentujących imię osoby.
Przykłady nazw zmiennych
Oto kilka przykładów deklaracji zmiennych (przy użyciu typowych typów danych):
char userOption;
int gameScore;
float particlesPerMillion;
bool processedCustomer;
Inne konwencje nazewnictwa
Reguły i konwencje opisane powyżej dotyczą zmiennych lokalnych. Zmienna lokalna to zmienna o zakresie w treści metody lub zmienna w aplikacji konsolowej, która używa instrukcji najwyższego poziomu (na przykład kodu w tym module).
Istnieją inne typy konstrukcji, których można używać w aplikacjach, a wiele z nich ma własne konwencje. Na przykład klasy są często używane w programowaniu w języku C# i mają skojarzone konwencje. Chociaż nie będziesz tworzyć klas w tym module, ważne jest, aby wiedzieć, że właśnie poznane konwencje nazewnictwa mieszczą się w większej strukturze nazewnictwa.