| САМОУЧИТЕЛИ И УЧЕБНИКИ. БЕСПЛАТНЫЕ УЧЕБНЫЕ МАТЕРИАЛЫ.
САМОУЧИТЕЛИ И УЧЕБНИКИ

САМОУЧИТЕЛИ

УЧЕБНИКИ 

Панель навигации
 
ГлавнаяГлавная
Личный кабинетЛичный кабинет
Самоучители и учебникиСамоучители и учебники
КонтактыКонтакты
Скачать самоучители и учебникиСкачать самоучители и учебники
Интересные статьиИнтересные статьи
РекомендоватьРекомендовать
Лента новостей
 


Рекомендуем
 
 

Наши опросы
 
Был ли полезен Вам наш сайт?

Да, весьма полезен.
Да, я нашел кое-что полезное для себя.
Нет, все это старо как мир.
Пока еще не решил.


Результаты
Другие опросы

Всего голосов: 3302
 

  

стиль

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

вильям странк, элвин б. уайт. элементы стиля

приводимый фрагмент кода взят из большой программы, написанной много лет назад:

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

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

начнем мы с непривычного — с обсуждения стиля в программировании. чем лучше у вас стиль, тем проще читать ваши программы вам самим и другим программистам; хороший стиль просто необходим для хорошего программиста. мы начинаем со стиля, чтобы в дальнейшем вы обращали на него внимание во всех примерах.

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

принципы хорошего стиля программирования состоят вовсе не в наборе каких-то обязательных правил, а в здравом смысле, исходящем из опыта. код должен быть прост и понятен: очевидная логика, естественные выражения, использование соглашений, принятых в языке разработки, осмысленные имена, аккуратное форматирование, развернутые комментарии, а также отсутствие хитрых трюков и необычных конструкций. логичность и связность необходимы, потому что другим будет проще читать код, написанный вами, а вам, соответственно, — их код, если все будут использовать один и тот же стиль. детали могут быть продиктованы местными соглашениями, требованиями менеджмента или самой программой, но даже если это не так, то лучше всего подчиняться наиболее распространенным соглашениям. мы в своем повествовании будем придерживаться стиля, использованного в книге "язык программирования с" с некоторыми поправками для c+ + и java.

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

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

для того чтобы вы могли без труда отличить хорошие примеры от плохих, мы будем начинать строки сомнительного кода со знака вопроса, как, например, в этом фрагменте (помните — все фрагменты взяты из реальных программ):

что может быть спорным в этих макроопределениях? а вы представьте себе изменения, которые необходимо будет внести в программу, если массив из twenty (двадцати) элементов понадобится увеличить. нужно по меньшей мере заменить все имена на более осмысленные, указывающие на роль данного значения в программе:


 

 
 
XD-3D_HD_BLC
User Info
 


Добро пожаловать,
Гость

Регистрация или входРегистрация или вход
Потеряли пароль?Потеряли пароль?

Логин:
Пароль:
Код:Секретный код
Повторить:

Сейчас онлайн
ПользователейПользователей: 0
ГостейГостей: 16
ВсегоВсего: 16
 

XD-3D_HD_BLC
Наши опросы
 
Нужен ли форум на сайте?

Да
Нет
Не знаю
Мне все равно


Результаты
Другие опросы

Всего голосов: 156
Комментарии: 2
 

XD-3D_HD_BLC
На развитие
 
Просто нажмите на кнопку

 


Design copyright by Breeze





Генерация страницы: 0.030 сек. и 27 запросов к базе данных за 0.004 сек.
Web site engine code is Copyright © 2006 by SLAED CMS. All rights reserved.