Гость
Целевая тема:
Создать новую тему:
Автор:
Форумы / Программирование [игнор отключен] [закрыт для гостей] / Какими должны бить правильные названия у переменных, функции, классов,.. / 18 сообщений из 18, страница 1 из 1
12.06.2012, 09:17
    #37834951
Sergey NV
Участник
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Какими должны бить правильные названия у переменных, функции, классов,..
Просьба к опытным и работающим в больших структурах программистам: Какими должны бить правильные названия у переменных, функции, классов, и.т.д.?

Уже довольно давно заметил, что одинаковые по сути функции и модули, со временем, называю по-разному. Это мешает. А каково другим разбираться в моем коде?

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

Вопрос не о форматировании(отступления и переносы) текста, а именно о правильном давании названий.
...
Рейтинг: 0 / 0
12.06.2012, 10:10
    #37834986
Edd.Dragon
Участник
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Какими должны бить правильные названия у переменных, функции, классов,..
Sergey NVУже довольно давно заметил, что одинаковые по сути функции и модули, со временем, называю по-разному.
А ты что, по многу раз пишешь одно и то же, не заглядывая в предыдущие версии?
...
Рейтинг: 0 / 0
12.06.2012, 10:10
    #37834987
Edd.Dragon
Участник
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Какими должны бить правильные названия у переменных, функции, классов,..
Или что имеется ввиду? Приведи примеры
...
Рейтинг: 0 / 0
12.06.2012, 10:57
    #37835024
Sergey NV
Участник
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Какими должны бить правильные названия у переменных, функции, классов,..
Edd.DragonИли что имеется ввиду? Приведи примеры

К примеру:
>5 недель назад:
Код: php
1.
function get_admin_editdel_block($parameters){return;}



>2 дня назад, немного усовершенствовал функцию, и изменил название:
Код: php
1.
function getAdmin_Block($type="edit", $parameters){return;}



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

Хочу как правильно. Надо навести порядок :-)
...
Рейтинг: 0 / 0
12.06.2012, 11:01
    #37835029
Sergey NV
Участник
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Какими должны бить правильные названия у переменных, функции, классов,..
я просто не знаю ни одного правила или стандарта наименований.
поетому бросаюсь из крайности в крайность(лучше так, а может так) - бардак, вообщем.
...
Рейтинг: 0 / 0
12.06.2012, 11:09
    #37835043
Abstraction
Участник
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Какими должны бить правильные названия у переменных, функции, классов,..
Sergey NV,

Можете почитать Макконнелла, "Совершенный код".
...
Рейтинг: 0 / 0
12.06.2012, 11:27
    #37835067
Sergey NV
Участник
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Какими должны бить правильные названия у переменных, функции, классов,..
AbstractionSergey NV,

Можете почитать Макконнелла, "Совершенный код".

спасибо. буду смотреть.
...
Рейтинг: 0 / 0
12.06.2012, 18:32
    #37835475
Zukora
Участник
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Какими должны бить правильные названия у переменных, функции, классов,..
Главное не дойти до маразма в названиях

peremennaya_ovechayushchaja_za_schetchik_vo_vneshnem_cukle:Integer;
peremennaya_ovechayushchaja_za_schetchik_vo_vnutrennem_cukle:Integer;

i,j:integer предпочтительней и понятней.
...
Рейтинг: 0 / 0
12.06.2012, 18:58
    #37835500
mayton
Участник
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Какими должны бить правильные названия у переменных, функции, классов,..
Sergey NVХочу как правильно. Надо навести порядок :-)
Нет совершенства в этом мире. В Pascal были красивые Begin.... End. Красота но регистр - нах-нах.
Когда я писал на С++ то придерживался Венгерской нотации lp_Str.... Потом достало. Длинно. Сократил. Потом
Java. Со своими рекомендациями+EJB (.setMyFuckenValue()). Освоил. Применял. Теперь я знаю
Oracle/PLSQL а там свои собственные DBMS_FUCKEN_PACKAGE.FUCKEN_CALLBACK(fucken_property=>...).

Вобщем it depends. Кури внутренние правила и договорённости какие
в моде у вас в организации. Заимствуй то что уже написано. Будешь
самовольничать - побьют и больно. Вот так вот.
...
Рейтинг: 0 / 0
12.06.2012, 22:04
    #37835591
Aklin
Участник
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Какими должны бить правильные названия у переменных, функции, классов,..
Sergey NV Просьба к опытным и работающим в больших структурах программистам: Какими должны бить правильные названия у переменных, функции, классов, и.т.д.?

Уже довольно давно заметил, что одинаковые по сути функции и модули, со временем, называю по-разному. Это мешает. А каково другим разбираться в моем коде?

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

Вопрос не о форматировании(отступления и переносы) текста, а именно о правильном давании названий.


google code style

почитай

самое вменяемое имхо
...
Рейтинг: 0 / 0
12.06.2012, 22:04
    #37835592
Aklin
Участник
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Какими должны бить правильные названия у переменных, функции, классов,..
AklinSergey NV Просьба к опытным и работающим в больших структурах программистам: Какими должны бить правильные названия у переменных, функции, классов, и.т.д.?

Уже довольно давно заметил, что одинаковые по сути функции и модули, со временем, называю по-разному. Это мешает. А каково другим разбираться в моем коде?

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

Вопрос не о форматировании(отступления и переносы) текста, а именно о правильном давании названий.


google code style

почитай

самое вменяемое имхо http://google-styleguide.googlecode.com/svn/trunk/cppguide.xml
...
Рейтинг: 0 / 0
12.06.2012, 22:44
    #37835611
Sergey NV
Участник
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Какими должны бить правильные названия у переменных, функции, классов,..
А по какому принципу даются названия, скажем, в csm joomla?
...
Рейтинг: 0 / 0
12.06.2012, 22:56
    #37835623
F#
F#
Гость
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Какими должны бить правильные названия у переменных, функции, классов,..
Sergey NVА по какому принципу даются названия, скажем, в csm joomla?

http://docs.joomla.org/Coding_style_and_standards
...
Рейтинг: 0 / 0
12.06.2012, 23:24
    #37835637
Edd.Dragon
Участник
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Какими должны бить правильные названия у переменных, функции, классов,..
Sergey NV>5 недель назад:
Код: php
1.
function get_admin_editdel_block($parameters){return;}



>2 дня назад, немного усовершенствовал функцию, и изменил название:
Код: php
1.
function getAdmin_Block($type="edit", $parameters){return;}




Во втором случае не понятно. Ты либо привыкни к getAdminBlock, либо к get_admin_block. Мешать два этих стиля в один обычно не принято.

В первом случае "editdel" - это что? Почему без дефиса и зачем оно вообще в названии? У тебя были и другие админ-блоки? Возможно вообще нужно выделить некоторые данные и функционал в отдельный класс? Чтобы было типа так:
AdminUI::getЧегоТоТам()
AdminBlocks::get........
Admin::get........


А так, get_admin_block и getAdminBlock - это и есть нормальные имена. Все, что эта функция делает должно быть достаточно легко понятно из ее кода + перед ней надо перечислить в коментарии список параметров или иные подобные пояснения, из которых будет ясно, что он может и del, и edit и т.д.

Когда будет набирать имя этой функции в коде где-то - IDE тебе попапнет не только параметры функции, а и коментарий перед ней. Так что, не надо пытаться впихнуть подсказки в имя переменной/функции. Так только привыкнешь, не пихать лишнего - тогда и перестанешь одно и тоже называть кардинально по-разному.
...
Рейтинг: 0 / 0
13.06.2012, 11:43
    #37836081
softwarer
Участник
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Какими должны бить правильные названия у переменных, функции, классов,..
Sergey NVВопрос не о форматировании(отступления и переносы) текста, а именно о правильном давании названий.
Тут есть два отдельных вопроса: правильное (осмысленное) именование и правильное (удобное, красивое) оформление названий. Первое - это "называй переменную TotalCount вместо T1", второе - "называй её TotalCount, totalCount, Total_Count или iTotalCount".

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

Что касается второго - есть некоторое количество сложившихся систем. Можно спорить, какие лучше, какие хуже, но основное - в рамках проекта стоит придерживаться одной системы. Критерий довольно прост: программист, задумавшийся, как называется метод, к примеру, "получить местоположение файла", должен без напряжения мысли и с высокой достоверностью "угадать" название, данное другим разработчиком.
...
Рейтинг: 0 / 0
13.06.2012, 14:55
    #37836425
ZyK_BotaN
Участник
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Какими должны бить правильные названия у переменных, функции, классов,..
мое првило ткое :
чем объект язык(функция, перемення, клсс, объект) - локольнее, тем короче нзвние.
чем глобольнее - тем длиннее нзвние
чем чще использется - тем короче нзвние
чем реже - тем длиннее нзвние
...
Рейтинг: 0 / 0
13.06.2012, 15:00
    #37836436
mayton
Участник
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Какими должны бить правильные названия у переменных, функции, классов,..
Еще надо не забывать про singular/plural. Ну к примеру

Код: java
1.
SergeyNVDocument[] sergeyNVDocuments;



Константы - заглавными буквами. Короткие переменные-счётчики циклов
можно делать как i,j,k...e.t.c.
...
Рейтинг: 0 / 0
13.06.2012, 16:24
    #37836588
kosh the best
Участник
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Какими должны бить правильные названия у переменных, функции, классов,..
Красиво emacs lisp функции называются
toggle-truncate-lines
view-emacs-news

Ну а вообще, все сразу видят, что не красиво, когда в разных частях программы то do_something, то doSomething, то DoSomething, а вот мне еще и не нравится когда не соблюдают порядок сказуемое-глагол, типа do_foo, а в другом месте уже bar_do.

И еще бесит, когда начинают "обсирать" венгерскую нотацию, не понимая того, для чего она была предназначена - чтобы закрыть некоторые места слабой типизации сишки. Ну то есть нельзя было понять, на что указывает char* - на строку в readonly памяти, на строку, завершенную нулем или это просто кусок бинарной памяти. Поэтому и пишем: PBYTE, PCHAR, PCSTR..
...
Рейтинг: 0 / 0
Форумы / Программирование [игнор отключен] [закрыт для гостей] / Какими должны бить правильные названия у переменных, функции, классов,.. / 18 сообщений из 18, страница 1 из 1
Найденые пользователи ...
Разблокировать пользователей ...
Читали форум (0):
Пользователи онлайн (0):
x
x
Закрыть


Просмотр
0 / 0
Close
Debug Console [Select Text]