О стилистике при оформлении исходников, для начинающих и не только Опции

[rezident]

#define dataflag (1<<6)

Не в тему, но... есть устоявшееся правило: макросы принято обозначать заглавными буквами, а переменные и функции прописными или сочетанием заглавных и прописных. Так проще воспринимается текст исходника. В приложении русскоязычный перевод Application Note (AN-2000) "Стандарт кодирования на Си", от Micrium, Inc.

Поскольку невольно мое сообщения послужило началом своего рода оффтопка, то выделил подветку из http://electronix.ru/forum/index.php?showtopic=72745 в отдельную тему.

Сообщение отредактировал rezident - Feb 13 2010, 19:58

Прикрепленные файлы

 micrium_an_2000_rus.pdf ( 166.36 килобайт ) Кол-во скачиваний: 1408

 

[zltigo]

Слив засчитан

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

Ах вот уже "в любом редакторе"

Да, в любом. Любом, редакторе а не форматере. Не только имеющемся у Вас (и у меня) достойнейшем редакторе SlickEdit способном заниматься кроме функций редактирования еще и достаточно приличным ПЕРЕформатированием индентов в написанном через анус исходнике.

а в исходниках, которые приходится читать - сплошь и рядом.

Забивание табуляций пробелами решает эту проблему при попытке сменить индент? Нет? Тогда какие еще
"проблемы" с табуляцией, которые решаются ее тупой заменой на пробелы? Одну единсвенную - если кто-то скопипастит во что-нибудь типа простейшего форумого вьювера исходник. Плюсы перечислил ранее, пути обхода проблем с запробеленными исходниками знаю и пользуюсь, но "расслабляться и получать удовольствие" от сношения с загаженными пробелами исходниками не собираюсь. Замена табуляций пробелами операция примитивнейшая и редко какой редактор не выполняет ее АБСОЛЮТНО корректно на полном автомате в отличии от обратной операции. Что еще?

[Alex B._]

Забивание табуляций пробелами решает эту проблему при попытке сменить индент?

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

Тогда какие еще "проблемы" с табуляцией, которые решаются ее тупой заменой на пробелы?

Это я у вас спрашиваю, какие проблемы с пробелами. Не переводите стрелки. Пока услышал только какие-то надуманные и эмоциональные аргументы.
Я на днях в одном репозитории SVN через websvn ковырялся - тихий ужас. В движке размер табов устанавливается, естественно для всех файлов репозитория (причем, понятное дело, админом). Ну а внутри табы и 4 и 2 и даже (OMG!) 3 пробела. Пришлось плюнуть, извлекать и переформатировать. Дураку ясно преимущество пробелов в этом случае.

[zltigo]

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

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

[MrYuran]

Emacs/Vim/Pn/SlickEdit/Eclipse/C::B не предлагать

SciTE - русский потомок Scintill'-ы
Скриптоязык там правда LUA, но он написан на си, так что с натяжкой можно считать...

[Alex B._]

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

Глуповато выглядит переходить в споре на личности и цепляться к фразам. Хе, не ожидал от вас такого =)

[Злодей]

"Не используйте эмоции в комментариях." - по мне замечание.

[zltigo]

"Не используйте эмоции в комментариях."

Тоже не факт . Я вот несколько недель назад закомментировал несколько сот строк исходника с мутью от Microchip. И написал краткий, но исчерпывающий, и доходчивый комментарий на русском (кодировка WIN1251, кстати, прекрасный повод для обсуждения, какую использовать ).

[aaarrr]

Глуповато выглядит переходить в споре на личности и цепляться к фразам. Хе, не ожидал от вас такого =)

Хе-хе. А попытки уязвить собеседника фразочками типа "вкусовщина", "не барское дело", "слив засчитан", думаете, выглядят умно и тонко?

кодировка WIN1251, кстати, прекрасный повод для обсуждения, какую использовать

Да-да, в FAR'е-то по умолчанию DOS

[Dog Pawlowa]

Прокомментируйте еще плз.
Рекомендация использовать собственные typedef с обязательным указанием signed/unsigned. В принципе логично.
Но sprintf требует указатель на буфер родного типа char.
Как решается эта коллизия?
В сотне мест делать преобразование типа или запрещать предупреждение?

[zltigo]

Да-да, в FAR'е-то по умолчанию DOS

Да, ибо консоль, но плагины разные есть.
В принципе 866 AKA "альтернативная" самая разумная кодировка, что-бы не говорили юниксоиды и уж тем более микрософт. Но тут уж я "сдался" и последние годы по умолчанию, если вдруг кирилица нужна, пользую 1251, хотя в редактор встроил и распознавание и переключение OEM/ANSI кодовых страниц. Разнообразные перекодировки тоже имеются.

Но sprintf требует указатель на буфер родного типа char.

Зачем-же ему фигню какую-то другого типа подсовывать, если с текстами работаете? Да и сам sprintf() штука не слишком незаменимая, дабы его в сотнях мест пользовать. Скорее всего Вам vfprintf(),vprintf(),vspritf() требуются.

[sigmaN]

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

Правильно ли я понял, что при отображении редактор способен заменить каждый символ табуляции определенным кол-вом пробелов?
Программист ставит скобку { ентер и таб. Ставит ещё одну { снова ентер и таб.... от начала строки табов с каждым таким разом становится всё больше, каждый таб при выводе на экран заменяется заданным кол-вом символов пробелов - этим с обеспечивается отступы...

Но ведь не зря же кому-то пришла эта мысль с пробелами. Это тупость, которая якобы заставляет все исходники выглядеть одинаково на всех машинах?

Ааа не проще ли в стандарте кодирования для компании прописать размер табуляции - 4 символа. Кто не настроил свой редактор правильно - тот дурак. А может и не дурак, может ему привычнее наблюдать исходники с tab=2символа. Зато он что-то накодит там(используя именно табы) а другой откроет у себя с настройками tab=4 и будет видеть его код но уже в привычном для себя виде.. ИМХО вообще сказочно получается.
Или чего-то я не понял пока в этой жизни?

[aaarrr]

Правильно ли я понял, что при отображении редактор способен заменить каждый символ табуляции определенным кол-вом пробелов?

Ну, если только это не "блокнот"

Но ведь не зря же кому-то пришла эта мысль с пробелами. Это тупость, которая якобы заставляет все исходники выглядеть одинаково на всех машинах?

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

[_Pasha]

SciTE - русский потомок Scintill'-ы
Скриптоязык там правда LUA, но он написан на си, так что с натяжкой можно считать...

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

[sigmaN]

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

Ну тогда вопрос решен! Не пользоваться блокнотом и не использовать пробелы там, где должна быть табуляция )

[ReAl]

А пример ваш не совсем честный. Если есть справа комментарии, то они сползут все

натюрлих, блин...
Попробовал как-то в Notepad++ включить пропорциональный шрифт и посмотреть так исходники. Довольно приятственно выглядит сам текст программы, даже не ожидал.
Из-за "узкого" пробела лучше переставить TAB=8, так как 4 начинають выглядеть как 2 :-)
Одно откровенно паршиво - независимот от установки TAB при переходе к пропорциональному шрифту разбегаются эти комментарии справа, отступы между типами и именами, например, при объявлении структур (точно так же, как они разбегаются при изменении TAB)

Можно подровнять табуляциями же - но тогда ужасно выглядит, если открыть в другом редакторе, в котором моноширинный шрифт :-)