Рекомендации .NET: почему исключение для двухбуквенных аббревиатур? - PullRequest
6 голосов
/ 27 апреля 2009

Руководства по проектированию Microsoft's Framework, среди прочего, определяют следующее:

"Прописывать оба символа двухсимвольных сокращений, кроме первое первое слово идентификатора в верблюжьей клетке "

Таким образом, существует исключение, определенное для аббревиатур, которые состоят только из двух букв, поскольку аббревиатуры с тремя или более буквами "правильно" в верблюжьей или паскальской оболочке.

Вопрос в следующем: Почему есть исключение, т. Е. В чем его обоснование? Я не мог получить объяснения из книги ФДГ или блогов Абрамса и Квалины.

Ответы [ 5 ]

1 голос
/ 27 апреля 2009

Почему? Эта штука - это просто соглашение (для улучшения читабельности), а не наука!

1 голос
/ 27 апреля 2009

Они говорят, что если первая часть идентификатора покрыта верблюжьей оболочкой, вы должны оставить ее в верблюжьей оболочке, а не использовать заглавные буквы только потому, что это аббревиатура. Это потому, что для вас более важно иметь возможность сказать, что, например (а это прямо из рассматриваемой книги, которую я люблю, кстати), вы имеете дело с параметром.

Что касается того, почему вы пишете заглавными буквами двухсимвольную аббревиатуру, а не трехбуквенную, мне лично не нужно знать, что такое крайние случаи, потому что мне нравится их эстетика.

Например, я определенно предпочитаю это:

XmlDocument 

За это:

XMLDocument

Для меня, последний слегка пахнет 1982 года. И это немного больно.

Это только я, конечно. :)

0 голосов
/ 27 апреля 2009

В случае верблюда (где первое слово все в нижнем регистре), вам нужно явное исключение из обычного исключения двухбуквенной аббревиатуры для заглавных букв первой буквы).

В противном случае было бы два противоречивых правила:

  • Двухбуквенные сокращения имеют заглавные буквы.
  • Первое слово / аббревиатура от имени в верблюжьем корпусе ниже.
0 голосов
/ 27 апреля 2009

Microsoft .NET действительно непоследователен в отношении имен. Честно говоря, упомянутая вами книга полна таких исключений.

Полагаю, пользовательский интерфейс выглядит лучше, чем пользовательский. Но Id выглядит лучше, чем ID ...

0 голосов
/ 27 апреля 2009

Потому что MS выглядит намного лучше, чем MS ...

Серьезно, смысл этих правил состоял в том, чтобы избавиться от именования таких вещей, как CALTextBox. Где CAL является аббревиатурой для компании. Команда разработчиков языка чувствовала, что «CAL» пахло слишком сильно, как сильно оскорбленная (и мало понятная) венгерская нотация, которую большинство программистов просто не могут понять.

Поэтому они пошли на небольшую тираду, чтобы избавить мир программирования от этого дерьма. Это одно из правил, пытающихся его кодифицировать.

...