VPF::как вы подбираете идентификаторы

setq

Дата 23.4.2003, 20:23 (ссылка)

(голосов: 0)

Загрузка ...

Unregistered

какой нотацией вы пользуетесь при описании имён переменных и классов? как вы относитесь к ограничениям, которые накладывает конкретный язык на 1) длину идентификаторов 2) регистр букв 3) наличие специальных символов и т.д.? какой по-вашему процент в читабельность кода привносят удачно подобранные идентификаторы? но главный вопрос - первый.

dr.ZmeY

Дата 23.4.2003, 22:21 (ссылка)

(нет голосов)

Загрузка ...

Политолог

Профиль
Группа: Участник Клуба
Сообщений: 3892
Регистрация: 26.3.2002
Где: ..::STALINGRAD::. .

Пишу латинскими буквами имя переменной иил класса на русском, если это временная переменная, то это обычно Tmp, если это некий коэффициент, то koef... и т.д.

--------------------

Мой блог в ЖЖ

Chingachguk

Дата 24.4.2003, 09:57 (ссылка)

(нет голосов)

Загрузка ...

Эксперт

Профиль
Группа: Участник Клуба
Сообщений: 1232
Регистрация: 25.3.2002
Где: Москва

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

Цитата

...
; Инициализируем массив данных WorkArea, в котором будет хранится информация
; о состоянии программ - заражена / нет
; Определим размер массива
; В одной корневой директории логического диска содержится директорий:
; LocDirs ^ ( DirsLevel + 1 ) - 1
; ( ------------------------------- ) = DirsPerRootDir
; LocDirs - 1
; ( Включая директорию корня - плюс 1)
;
mov cx,DirsLevel ; cx = DirsLevel - уровень вложенности
mov ax,LocDirs ; ax = LocDirs - количество директорий
mov bx,LocDirs ; bx = LocDirs - количество директорий
@GetPower: ; Возведем в степень
mul bx
loop @GetPower
dec ax ; ax = LocDirs ^ ( DirsLevel + 1 ) - 1
dec bx ; bx = LocDirs - 1
xor dx,dx
div bx ; ax = всего директорий в корневой директории,
mov DirsPerRootDir,ax ; включая ее саму
mov bx,ExecutableProgs ; bx = Число выполняемых программ в директории
mul bx ; ax = Число программ в корневом каталоге
mov bx,DirsPerDrive ; bx = Число корневых директорий на диске
mul bx ; ax = Число программ на 1 диске
mov bx,DriveNumber ; bx = Число логических дисков
mul bx ; ax = Число программ на всех дисках
mov TotalPrograms,ax ; Запомним число всех программ на всех дисках

--------------------

I don't like the drugs (but the drugs like me). M.Manson.

neutrino

Дата 24.4.2003, 12:01 (ссылка)

(нет голосов)

Загрузка ...

Gothic soul

Профиль
Группа: Модератор
Сообщений: 3041
Регистрация: 25.3.2002
Где: Верхняя Галилея, Кармиэль

В ассемблере я всегда делаю названия переменных и функций как можно короче

Вот так, это видимо потому, что кроме как коротеньких программ и функций в я.в.у. я нигде его не применяю. Целые программы на нем я не пишу.

--------------------

The truth comes from within ...

Покойся с миром, Vit

man2002ua

Дата 24.4.2003, 16:53 (ссылка)

(нет голосов)

Загрузка ...

Опытный

Профиль
Группа: Участник Клуба
Сообщений: 943
Регистрация: 12.11.2002
Где: Киев

В мелких программках - два-три символа и все константы - в виде чисел

.
На прошлой работе при дописывании драйвера (добавлял режим скрин-сейвера), мой руков. проекта долго матерился, когда увидел, что нет ни одной символьной константы - я ему потом объяснял, что мне мне их проще в голове хранить, чем тратить время на описание и поотм вспоминать, как же оно звучит

--------------------

"Нет ничего более постоянного, чем временное"

Alex101

Дата 24.4.2003, 17:05 (ссылка)

(нет голосов)

Загрузка ...

Опытный

Профиль
Группа: Участник Клуба
Сообщений: 891
Регистрация: 8.4.2002
Где: Москва

Сначала пишу сущность, потом конкретизирую, например, количество ответов - AnswerNumber, или answer_number. Константы - большими буквами, например: GRAPHICS_SEGMENT.
Если временная переменная, то сначала tmp_.
Кнопки называю проще - Ok, Cancel, Delete и т.д.

--------------------

С уважением, А. Фролов.

DENNN

Дата 24.4.2003, 17:13 (ссылка)

(нет голосов)

Загрузка ...

Эксперт

Профиль
Группа: Участник Клуба
Сообщений: 3878
Регистрация: 27.3.2002
Где: Москва

А я сколько не пытался себя заставить пользоваться венгерской нотацией, все равно выходит так, как сказал Alex101. Те функции, смысл которых со временем подзабывается, называю и описываю подробно, а остальное по возможности сокращаю - слишком неудобно читать код, когда имена переменных раздуты а строка вылазит за экран.

Baa

Дата 25.4.2003, 10:13 (ссылка)

(нет голосов)

Загрузка ...

Эксперт

Профиль
Группа: Экс. модератор
Сообщений: 2639
Регистрация: 12.4.2002
Где: Москва

Пользуюсь венгерской натацией... очень удобно, кстати

(префексы помогают ориентироваться в огромных программах)
А при обзывании переменных токо логическим смыслом

Код


typedef struct tagGameBoard {
  char szGameBoardName[30];
  HWND hGameBoardWindow;
  bool bOnMouseDown;
	} GAMEBOARD, *LPGAMEBOARD;

--------------------

"Duty is everything; the greatest of joys, the deepest of sorrows" Aribeth de Tylmarande

desyatnik

Дата 26.4.2003, 21:35 (ссылка)

(нет голосов)

Загрузка ...

Бывалый

Профиль
Группа: Участник
Сообщений: 161
Регистрация: 13.8.2002
Где: Мичуринск

Если нет большого опыта в венгерской нотации, префиксы быстро начинают путаться. Да и в конце концов - типизация на что? Я предпочитаю Адский подход к именованию - никаких сокращений, между словами - знак подчёркивания, каждое слово - с большой буквы. Набирать немного долго

, но зато как читается... Например:

Код


typedef struct {
 char Game_Board_Name [30];
 HWND Game_Board_Window;
 bool On_Mouse_Down;
} Game_Board, *Game_Board_P;

--------------------

WBR, Dejrgris

acp

Дата 26.4.2003, 22:19 (ссылка)

(нет голосов)

Загрузка ...

Опытный

Профиль
Группа: Участник
Сообщений: 389
Регистрация: 4.2.2003
Где: Владимир

1. Процедуры/функции называю длинными именами, с помошью которых можно понять суть. Причём при объявлении всегда пишу комментарий (небольшой).

Пример из недавнего

Код

function NeedPostProcessing : boolean; forward;

Функции не требуется вызывать часто, поэтому их можно обозвать и "длинно".

2. Переменные. Стараюсь называть кратко, но понятно. Т.к. переменные часто надо писать.
Вот например выше было написано - AnswerNumber. Я бы эту переменную назвал бы AnsCount. Но опять же зависит от случая. Т.е. если переменная какая-то глобальная, то называть её нужно понятнее (и соответственно длинней)

3. Константы - длинные. За редким исключением типа cCRLF. Константы - единственное исключение, для которых пишу префикс "c".

Это сообщение отредактировал(а) acp - 26.4.2003, 22:20

0 Пользователей читают эту тему (0 Гостей и 0 Скрытых Пользователей)
0 Пользователей:
« Предыдущая тема \| Флейм \| Следующая тема »