Давайте введем единый стандарт на оформление текста программ...

← →
Goida © (2004-05-14 23:12) [0]

Меня на эту мысль натолкнула одна из соседних веток.
Вот например, так писать не правильно:
if true then begin ... end else begin ... end;
А правильно так:
if TRUE then begin ... end else begin ... end;
Сразу видно где что, что к чему... И еще можно по поводу обзавания переменных. Типа венгерской нотации. Все конечно ей пользутся, но это выглядит ужасно. Например, переменная типа TLabel:
- lVar
- labelVar
- VarLabel
и пр.
Договориться и жестко придерживаться префиксов в названиях.
Так же и константами и переменными, для различения их. Скажем, константы пишем только большими буквами, а переменные - только не одними большими.
Что думаете?

← →
Sergey Masloff (2004-05-14 23:16) [1]

Goida © (14.05.04 23:12)
1) Во первых в любой команде и так есть стандарт.
2) Во вторых твой вариант ужасен
3) С какого фига я буду придерживаться стандарта предложенного каким-то Goida © а ты - предложенного не менее каким-то Sergey Masloff (tm)

← →
default © (2004-05-14 23:16) [2]

а как же свобода выбора?

← →
Vasya.ru (2004-05-14 23:19) [3]

По этой теме много статей "о хорошем стиле программирования" написано.
> А правильно так:
> if TRUE
> then begin
> ...
> end
> else begin
> ...
> end;

А почему не так?
If TRUE Then
Begin
...
End
Else
Begin
...
End;
Тоже легко читается

← →
Игорь Шевченко © (2004-05-14 23:22) [4]

> Вот например, так писать не правильно:
>
> if true then begin
> ...
> end else begin
> ...
> end;

Да ? Странно, уже 9 лет так пишу на Delphi, ни разу не слышал, что это неправильно. Керниган и Ричи (а это их стиль) вообще-то очень неглупыми людьми были...

> Давайте введем единый стандарт на оформление текста программ...
>

Давайте. Как в VCL, у всех есть, ничего объяснять не надо. У Тейксейры и Пачеко этому самому стандарту целая 6-ая глава посвящена в книге "Delphi 5, руководство разработчика".
Согласен ?

← →
Style © (2004-05-14 23:23) [5]

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

← →
Goida © (2004-05-14 23:24) [6]

Вы плохо читаете? Я же не говорю ПРИНИМАЙТЕ МОЙ СТАНДАРТ. :( Я сказал: давайте разработаем. Понятно, что у каждой команды есть свои стандарты, но нужно думать о взаимодействии с другими людьми. Придет, например, новичек. До этого он работал у других и у них был другой стандарт. Теперь ему нужно будет привыкать к вашему, что займет какое-то время и снизит его производительность.

← →
Goida © (2004-05-14 23:29) [7]

> А почему не так?
> If TRUE Then
> Begin
> ...
> End
> Else
> Begin
> ...
> End;

Почему Я так не пишу.
Потому что с заглавной пишу идентификатора, а это служебные слова. Выделение then и else позволяет лучше их видеть и зрительно разбивает на две части код лучше, чем другие варианты.

← →
Игорь Шевченко © (2004-05-14 23:30) [8]

Goida © (14.05.04 23:24)

Цитата:

"Благодаря использованию единого стиля написанные разными программистами программы станут для всех понятными и удобочитаемыми.
....
Однако мы не рекомендуем слишком сильно отклоняться от стандартов, применяемых разработчиками фирмы Borland. Суть в том, что, если в вашу команду придет новый программист, вероятнее всего он будет знать именно стандарты фирмы Borland"

Ку ?

← →
Style © (2004-05-14 23:31) [9]

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

Лажа это все, ни кто не будет писать под единым стандартом...
Более того менять свои принципы написания кода. ИМХО - если и делать такой "стандарт", то только на уровне редактора кода Delphi, где бы жестко устанавливались определенные правила (ну возможно были бы варианты этих правил для выбора)...
Например написал ты

const
value = 100;

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

← →
Goida © (2004-05-14 23:32) [10]

> if true then begin
> > ...
> > end else begin
> > ...
> > end;
>
>
> Да ? Странно, уже 9 лет так пишу на Delphi, ни разу не слышал,
> что это неправильно

А если тебе понадобится прокоментировать условие? Понимаю, можно напливать на пару лишних кликов по клаве, но ведь можно предусмотреть еще в самом начале такой вариант?

← →
Goida © (2004-05-14 23:35) [11]

> Лажа это все, ни кто не будет писать под единым стандартом...
> Более того менять свои принципы написания кода

Это уже зависит от качеств человека. Смог себя заставить, значит и проект сможешь написать. А если такую мелочь не можешь себя заставить делать, то стоит ли тебе проект доверять? Не так ли? Или рассуждение не верное?

← →
Игорь Шевченко © (2004-05-14 23:38) [12]

Goida © (14.05.04 23:32)

> А если тебе понадобится прокоментировать условие?

А зачем его комментировать ? (Я серьезно)

← →
Gero © (2004-05-14 23:39) [13]

> Я сказал: давайте разработаем

Поздно. Это уже сделали до нас.

---
Все вышесказанное воспринимать как ИМХО.

← →
default © (2004-05-14 23:40) [14]

Goida © (14.05.04 23:35) [11]
согласись главное условие - это несплошно код
а кто работает в командах привыкнут к стилю друг друга быстро

← →
Style © (2004-05-14 23:43) [15]

> Не так ли? Или рассуждение не верное?

Не согласен...
Главное, что нужно - это придерживаться тех правил которые зрительно можно заметить в исходниках VCL, т.е. в коде Borland;
И если код вполне дополнен комментариями, то ИМХО этого достаточно для того, чтобы работать в команде. Все остальное - это придирки со стороны руководства.
А если ты начинаешь работать в новом уже существующем проекте, то рано или поздно, тебе все равно придется ознакамливаться с принципами этого проекта, с модулями, основными классами, функцими и т.д.

← →
Игорь Шевченко © (2004-05-14 23:43) [16]

> а кто работает в командах привыкнут к стилю друг друга быстро

Гораздо быстрее они привыкнут к ЕДИНОМУ стилю. Особенно из-под палки.

← →
Goida © (2004-05-14 23:43) [17]

> Игорь Шевченко

В моем примере не зачем. Но бывают разные условия: составные, с приминением каких-то собственных идентификаторов... Хотя я понял: ты не думаешь о последрвателях и о будущем. Представь, попросят тебя через 10 лет поправить прогу, а ты уже 10 других проектов написал и напрочь забыл о какой проге тебе говорят (наврядли забудешь, ну ладно). Так вот посмотрев код, ты подумаешь: и почему я не коментировал его тогда? Или не подумаешь?

← →
Mihey © (2004-05-14 23:44) [18]

Была такая мода в 1980-е - всё с большой буквы писать.

← →
Goida © (2004-05-14 23:45) [19]

> default © (14.05.04 23:40) [14]
> Goida © (14.05.04 23:35) [11]
> согласись главное условие - это несплошно код
> а кто работает в командах привыкнут к стилю друг друга быстро

С этим согласен.

← →
Goida © (2004-05-14 23:46) [20]

> Style © (14.05.04 23:43) [15]

А мне кажется мы состоим из мелочей.

← →
OlegGashev © (2004-05-14 23:46) [21]

Borland придерживается два стиля комментирования условия

if true then //comment ....

{comment} if true then ....

← →
Style © (2004-05-14 23:47) [22]

Помница была у меня интересная книга
Ален Голуб, "Правила программирования C&C++", называется.
Вот там он хорошо основные правила писал.

← →
Goida © (2004-05-14 23:48) [23]

> Mihey © (14.05.04 23:44) [18]

Да, я тоже модничал так. Хотя это было в 90х...

← →
default © (2004-05-14 23:49) [24]

Игорь Шевченко © (14.05.04 23:43) [16]
я имел ввиду чтение кода, писать, конечно, каждый будет по-своему

← →
Игорь Шевченко © (2004-05-14 23:50) [25]

> Хотя я понял: ты не думаешь о последрвателях и о будущем.

Не забывай добавлять IMHO, пожалуйста.

> Представь, попросят тебя через 10 лет поправить прогу, а
> ты уже 10 других проектов написал и напрочь забыл о какой
> проге тебе говорят (наврядли забудешь, ну ладно). Так вот
> посмотрев код, ты подумаешь: и почему я не коментировал
> его тогда? Или не подумаешь?

Ты мой код, прости, видел ? Скорее всего, не подумаю.

hint: посмотри, много ли условий прокомментировано в исходниках VCL.

← →
Goida © (2004-05-14 23:51) [26]

> OlegGashev © (14.05.04 23:46) [21]

Мне почему-то кажется, что эти модули писались разными отделами одного Борланда :))

← →
Goida © (2004-05-14 23:54) [27]

> Не забывай добавлять IMHO

Я думаю это и так понятно.

> посмотри, много ли условий прокомментировано в исходниках
> VCL

Ты просто ответь: стоит ли коментировать так, что бы другому програмеру стало понятно что происходит в твоем коде через 5 минут или не стоит?

← →
OlegGashev © (2004-05-14 23:54) [28]

Goida © (14.05.04 23:51) [26]
Я просмотрел только comctrls.pas.

Разница в оформлении исходников наблюдается также у Микрософта. При чем, очень заметная разница.

← →
Goida © (2004-05-14 23:56) [29]

> Ты мой код, прости, видел ? Скорее всего, не подумаю

Ты бери в общем. Мы ведь не тебя конкретно обсуждаем.

← →
Goida © (2004-05-14 23:57) [30]

> OlegGashev

Но это ведь не значит, что это правильно. Плохо все это :(

← →
Игорь Шевченко © (2004-05-14 23:57) [31]

> стоит ли коментировать так, что бы другому програмеру стало
> понятно что происходит в твоем коде через 5 минут или не
> стоит?

Я отвечу по-другому. Код с самого начала надо писать так, чтобы без комментариев или с минимумом их было понятно, что в нем происходит, и другому программисту через 5 минут, и тебе самому через полгода. Если через полгода понятно, то и через 10 лет будет понятно.
Опять же, советую обратиться к исходникам VCL, как к образцу.

ЗЫ: Я чту заповеди святого Мартина :)

← →
OlegGashev © (2004-05-14 23:59) [32]

Goida © (14.05.04 23:57) [30]
Если будет директива придерживаться такого-то стандарта, будешь придерживаться, иначе будут бить по пальцам. :-)

← →
Goida © (2004-05-15 00:04) [33]

Ладно, все понятно. Будем писать так как пишем :) Это наилучший вариант :) А когда начнут бить по пальцам, тогда стоит опять поднять эту тему.

← →
Игорь Шевченко © (2004-05-15 00:06) [34]

Goida © (14.05.04 23:56)

А если в общем, тогда что брать ?

Исходники VCL или исходники Автосхемы Дмитрия О ?

Это, извини, две огромные разницы.
Давай тогда договоримся о том, что мы рассматриваем, как требующее подведения под стандарт.

← →
Goida © (2004-05-15 11:43) [35]

> Игорь Шевченко © (15.05.04 00:06) [34]

> Исходники VCL или исходники Автосхемы Дмитрия О ?

Я не призываю брать что-то за основу. Можно и без неё. Неужели не понятно, что можно договориться всем до чего-то одного. Предложить варианты, проголосовать за него. А потом придерживаться выбранного варианта в обязательном порядке. Что-то типа кодекса чести у программиста. Понятно, что можно будет и по другому оформлять тексты, но это будет лишь говорить о черте характера самого программиста. А там уж работодателю принимать решение.
Я считаю, что нужно разработать стандарт. А на основе чего он будет - это дело десятое. Главное, чтобы он поддерживался большинством.

← →
Nikolay M. © (2004-05-15 11:59) [36]

http://delphi.vitpc.com/asp/viewitem.asp?UrlItem=/article/coderules.htm
А можно еще бесконечное число таких стандартов придумать, которые будут различаться количеством пробелов перед операторами. И что, после Автосхема станет хорошей программой?

ПС
"Разруха - она в головах" (с).

← →
Иксик © (2004-05-15 12:13) [37]

http://community.borland.com/soapbox/techvoyage/article/1,1795,10280,00.html
Object Pascal Style Guide
This article documents a standard style for formatting Delphi code. It is based on the conventions developed by the Delphi team.

← →
Игорь Шевченко © (2004-05-15 12:30) [38]

> Я считаю, что нужно разработать стандарт. А на основе чего
> он будет - это дело десятое. Главное, чтобы он поддерживался
> большинством.

Уже все разработано, я (и не только я) уже который пост об этом твержу. Им и рекомендуется пользоваться.

← →
Goida © (2004-05-15 12:52) [39]

> Nikolay M. © (15.05.04 11:59) [36]

Вот это да!!! Да я так и пишу, за исключением пары моментов! Ну раз мой стиль письма признан, тогда я спокоен :)

А вообше тему завел об этом, потому что пришлось разбирать текст предшественнков. Такое ощущение, что понятие о стиле им не ведомо было. Ну так все нагорожено, так захламлено, что 1/4 времени расставлял коментарии и служемные слова... Все таки 4 года до меня писали...

← →
Nikolay M. © (2004-05-15 16:11) [40]

> 1/4 времени расставлял коментарии и служемные слова... Все
> таки 4 года до меня писали...

А тот, кто будет это разгребать после тебя, тоже, наверное, будет материться и постить сюда предложения о "правильном" форматировании и оформлении :)

← →
Митяй © (2004-05-15 17:09) [41]

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

← →
Goida © (2004-05-17 12:01) [42]

> Nikolay M.

Поверь мне - НЕТ. Хочешь, я тебе часть какого-нибкдь своего текста покажу, чтобы ты убедился?

← →
Sergp © (2004-05-17 12:08) [43]

> Вот например, так писать не правильно:

позвольте компилятору решать что правильно а что неправильно.

:-)))

← →
Nikolay M. © (2004-05-17 12:10) [44]

> Goida © (17.05.04 12:01) [42]

Зуб даешь, что после тебя не придет человек, который с матом будет begin править на BEGIN?
:)
А такие люди существуют...

← →
Dmitriy O. © (2004-05-17 12:19) [45]

предлагаю исключить форматирование кода. Ни каких отступов и леснок все выравнивать по левому краю. Весь текст кода с маленькой буквы. Ни каких загавных букв. Минимум комментариев. коментарии только там где действительно необходимо. Использовать для понимания такого кода Блок-Схему по моему стандарту.

← →
Паниковский © (2004-05-17 12:22) [46]

Стадартов уже киллограммы! В каждой конторе как правило свой. Зачем лисопед по новой изобретать?

← →
Goida © (2004-05-17 12:34) [47]

> Nikolay M.

:))) Нет, зуб оставля при себе :)

> Dmitriy O.

Это уже мания величия :)

> Паниковский

Так разговори начился с того, чтобы во всех конторах писали одинакого. Это облегчит жизнь программистов...

← →
Игорь Шевченко © (2004-05-17 12:35) [48]

Dmitriy O. © (17.05.04 12:19)

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

"Навстречу этим перспективам
На кой нам хрен переть вперед ?
Каким и как презервативом
Предохранить от вас народ?"

(с)

← →
Dmitriy O. © (2004-05-17 12:38) [49]

> "Навстречу этим перспективам
> На кой нам хрен переть вперед ?
> Каким и как презервативом
> Предохранить от вас народ?"
Ж:))) Ну вы и опустили народ ! Этож надо ! не ужели так все плохо и неизбежно что остается тока о контрацепции думать ! :)))

← →
Vlad © (2004-05-17 12:40) [50]

> Игорь Шевченко © (17.05.04 12:35) [48]
> Dmitriy O. © (17.05.04 12:19)
>
> До тех пор, пока твоя автосхема будет глючить, твой стандарт
> не годится.

И после этого - тоже. (ИМХО)

← →
Gero © (2004-05-17 12:41) [51]

> Dmitriy O. © (17.05.04 12:19)
> Ни каких отступов и леснок все выравнивать по левому краю

Зачем по левому краю?
Лучше уже все в одну строку писать.

← →
Vlad © (2004-05-17 12:45) [52]

> Gero © (17.05.04 12:41) [51]

> Лучше уже все в одну строку писать.

Ты чего, тогда капец автосхеме настанет ! Не выдержит

← →
Паниковский © (2004-05-17 12:45) [53]

Goida
Есть! Есть! Единый формат для написания программ на Паскале!!!!
Синтаксис называется!

Есть еще такое понятие как стиль например:

...
for count = 10 to x do begin
end;
...

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

Вот такие пирожки с катенками!

← →
Goida © (2004-05-17 12:51) [54]

> Паниковский

Так мы о стиле и кумекаем :) А изменит все можно. Только нужно этого ХОТЕТЬ.

← →
Vlad © (2004-05-17 12:53) [55]

> Есть еще такое понятие как стиль например:
>
> ...
> for count = 10 to x do begin
> end;

Я раньше тоже так писал, но потом глянул, а в VCL по-другому:
for count = 10 to x do
begin
....
end;
Вот и переучился. О чем не жалею.

← →
Игорь Шевченко © (2004-05-17 13:06) [56]

Vlad © (17.05.04 12:53)

Керниган и Ричи, когда обосновывали свой стиль
for count = 10 to x do begin
говорили, что чем меньше строк в функции, тем ее легче окинуть одним взглядом, без перелистывания.

← →
Vlad © (2004-05-17 13:12) [57]

> Игорь Шевченко © (17.05.04 13:06) [56]

Может быть, но мне в последнее время такой стиль немного режет глаз. Тем более, что экономим то всего одну строчку.
Ну это, как говорится, дело вкуса.

> Игорь Шевченко

Взглядом может ты и охватишь, только вот поймеш ли?... Не у всех ведь в глаз вставлен синтаксический анализатор :))

кстати ставить бегин в одной строке с командой мне тоже нравится
скажем
end else begin

Goida
"....Каждый пишет как он дышит...."
Песня
не мое

Гарантия процветания общества (ну и всего остального) - СТАБИЛЬНОСТЬ. А стабильности можно добиться, если все будут следовать какой-то одной идее. Так что выбирайте: или стабильность и единообразие, или разнообразие, но проблемы, связанные с ним.

Удалено модератором
Примечание: Дубль

>А стабильности можно добиться, если все будут следовать какой-то одной идее.

Идеи осуществления мировой революции ? Кто не следует - к стенке ?
Или следовать одной идее, но каждый своей ?

> Goida © (17.05.04 13:34) [63]

Самое печальное то, что введи ты хоть какие стандарты на написание кода, общество от этого процветать не будет

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

> Vlad

Да я не об обществе, в этом смысле. Я о том, что программистам будет легче понимать тексты друг друга...

> Johnmen © (17.05.04 13:41) [64]

Ты говоришь о крайностях, к которым никто не стремится. То, что ты описал - это не стабильность.

>Goida © (17.05.04 13:49) [67]
>То, что ты описал - это не стабильность.

Вот ыменно. Всеобщее следование идеи и стабильность суть разные вещи...

> Johnmen

Я говорю о всеобщейм следовании одной цели в рамках стабильности. Неужели не понятно? :)

> Goida © (17.05.04 13:49) [67]
> Да я не об обществе, в этом смысле. Я о том, что программистам
> будет легче понимать тексты друг друга...

Я не вижу особых сложностей, читая код VCL от Borland, также я не вижу сложностей читая код разработчиков сторонних компонент, даже когда стиль отличается. Главное - в обоих случаях код написан профессионально.
Зато я вижу сложности, читая код кое-какой программы, которую тут принято высмеивать. И самое интересное, пусть этот код будет написан по всем стандартам, но легче читаться от этого не будет.
IMHO.

Я предлагаю проще. Постите кто как хочет. Но поставьте на сайт форматер кода Паскаля. :-)

---
А что, я серьезно.

← →
serge35 (2004-05-17 16:10) [72]

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

> Лучше бы разработали один язык программирования на все случаи
> жизни.

С

← →
serge35 (2004-05-17 16:48) [74]

И как будет выглядеть SQL-запрос на С ?

> serge35 (17.05.04 16:48) [74]
> И как будет выглядеть SQL-запрос на С ?

Как обычная строковая переменная, которую затем передадим библиотеке того или иного DB-движка

а как же Дмитрий Олегович?

Мы же оставим его со своими блок схемами без работы !!!

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

Удалено модератором
Примечание: Дубль

> Goida © (17.05.04 13:33) [62]
> Гарантия процветания общества (ну и всего остального) -
> СТАБИЛЬНОСТЬ. А стабильности можно добиться, если все будут
> следовать какой-то одной идее. Так что выбирайте: или стабильность
> и единообразие, или разнообразие, но проблемы, связанные
> с ним.

Стабильность в данном случае обманчива, и попахивает прокоммунистическими происками. Был уже один, да и не один господин, который пытался увлечь народ одной идеей, конец весьма плачевный...
А вот я считаю, что как раз благодаря своей нестабильности, человечество и идёт вперёд в своём развитии, иначе и по сей день бы сидели на "Фортране", вот где была бы стабильность!!!

> попахивает прокоммунистическими происками

Это комплимент или оскорбление ?

Была уже похожая ветка. Я там про дельфорекс сказал. Мое мнение таково: Зачем тратить время на оформление, если можно забдуматься над непосредственно кодом, а красявости и форматирование кодяры навесить на специально обученные проги? я вот уже несколько месяцев пользуюсь и мне оно нравиться. Кто бы мне свой код не принес - он по нажатию одной комбинации приводится к удобному мне виду. Главное, чтоб там комментариев не много было, а как то раз оно изза них неправильно обработалось...

Клиника доктора Кодера.

Единый стандарт по оформлению программ есть в ГОСТ"е и ISO!!!!

Давайте введем единый стандарт на оформление текста программ... Найти похожие ветки