powered by simpleCommunicator - 2.0.51     © 2025 Programmizd 02
Форумы / WinForms, .Net Framework [игнор отключен] [закрыт для гостей] / Заголовочные файлы и С#
81 сообщений из 81, показаны все 4 страниц
Заголовочные файлы и С#
    #39529011
otars
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Гость
Интересует вопрос,а что собственно можно использовать в `C#` как альтернативу заголовочным файлам(C++).

Ведь на `C++` в отдельные файлы выносятся прототипы функций,рабочий код и тем самым создаётся читабельность огромного кода и его структурированность.

А вот как быть с `C#`?
Мной лично к сожалению не найдено явных примеров,которые бы указывали что заголовочные файлы и `C#` могут взаимодействовать.

Поиск по форуму пока не даёт результатов.
...
Рейтинг: 0 / 0
Заголовочные файлы и С#
    #39529012
Фотография Изопропил
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
otarsА вот как быть с `C#`?
так же как и в Java - никак
...
Рейтинг: 0 / 0
Заголовочные файлы и С#
    #39529013
Фотография Petro123
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
otars,
делаем так:
- 3 раза символ /
- автоматом появится комментарий
- я лично убираю параметры что там есть и оставляю только коммент
- заполняем строку чем хотим. Хоть заголовками))
- потом при открытии файла Ctrl+M+O
и видим аналог твоих заголовочных.
ЗЫ.
Кто то делает серфинг через дерево классов, но я никак не могу привыкнуть. Только сразу в простыни кода ориентируюсь.
...
Рейтинг: 0 / 0
Заголовочные файлы и С#
    #39529054
Фотография hVostt
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
otars,

Заголовочные файлы в C# не нужны, так как скомпилированные сборки содержат всю информацию о типах внутри.

Заголовочные файлы в C++ нужны не для того, чтобы создавать читабельность и структуированность. Если не смогли освоить С++, то не надо пытаться сравнивать его с другими языками.

Начните с бейсика для начала.
...
Рейтинг: 0 / 0
Заголовочные файлы и С#
    #39529055
Фотография hVostt
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
Petro123- я лично убираю параметры что там есть и оставляю только коммент

Огромное упущение.


Petro123- потом при открытии файла Ctrl+M+O

Это прекрасно работает и без комментариев.


Petro123Кто то делает серфинг через дерево классов, но я никак не могу привыкнуть. Только сразу в простыни кода ориентируюсь.

Мы пишем полную документацию к коду, описываем также все параметры и возврат, делаем короткое и полное описание, вставляем примеры в комментарии, также описываем возможные исключения. Потом при сборке генерится документация и выкладываеся в вики автоматом. 100% покрытие кода (публичного) документацией — обязательное железное требование. Ещё ни разу не пожалели об этом. Колоссальный профит при командной разработке. Рекомендую.
...
Рейтинг: 0 / 0
Заголовочные файлы и С#
    #39529069
Фотография Petro123
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
hVosttЭто прекрасно работает и без комментариев.
Ты же за них )))
hVosttМы пишем полную документацию к коду,
Документация отдельная песня. Её делают при коробочных продуктах. Я писал об обозреваемости простыни кода.
-----
"Сложнее всего в мире достигнуть простоты. Это крайняя граница опыта, и последнее усилие гения"
Г.Санд.
...
Рейтинг: 0 / 0
Заголовочные файлы и С#
    #39529073
Фотография hVostt
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
Petro123Документация отдельная песня. Её делают при коробочных продуктах. Я писал об обозреваемости простыни кода.

Какая разница какой там продукт, коробочный или нет?
...
Рейтинг: 0 / 0
Заголовочные файлы и С#
    #39529083
Фотография Petro123
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
hVosttКакая разница какой там продукт, коробочный или нет?
- в коробочном тебе приказано описывать параметры в 30 строк перед каждым методом
- в не коробочном это решается в самой фирме корпоративными правилами.
Нафига мне описывать параметр в
SetParameters(Stream stream)
DataSet GetDataSet(......
Вопрос риторический.
...
Рейтинг: 0 / 0
Заголовочные файлы и С#
    #39529116
Фотография hVostt
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
Petro123Вопрос риторический.

Вопрос ни разу не риторический. Чтобы понять, что конкретно твой GetDataSet делает, мне надо подробно изучить код этого метода. Понять, надо ли обрабатывать какие-то исключения, может ли он возвратить мне null, в каких условиях его можно использовать, как и когда его надо вызывать, а когда нельзя.

Ээх..
...
Рейтинг: 0 / 0
Заголовочные файлы и С#
    #39529128
Фотография skyANA
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
Petro123hVosttКакая разница какой там продукт, коробочный или нет?
- в коробочном тебе приказано описывать параметры в 30 строк перед каждым методом
- в не коробочном это решается в самой фирме корпоративными правилами.
Нафига мне описывать параметр в
SetParameters(Stream stream)
DataSet GetDataSet(......
Вопрос риторический.
И вот открываешь код, написанный в 2010-м году тем, кто уже не работает в компании, и вспоминаешь его добрым словом
...
Рейтинг: 0 / 0
Заголовочные файлы и С#
    #39529133
Фотография Алексей К
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
otarsВедь на `C++` в отдельные файлы выносятся прототипы функций,рабочий код и тем самым создаётся читабельность огромного кода и его структурированность.И хвала авторам C# за то, что не стали тянуть этот маразм из C++.
...
Рейтинг: 0 / 0
Заголовочные файлы и С#
    #39529136
Фотография Алексей К
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
hVostt100% покрытие кода (публичного) документацией — обязательное железное требование.
Код: c#
1.
2.
3.
4.
5.
public class Person
{
    // Фамилия.  <<---------- Кому нужен такой комментарий? Он только засоряет код.
    public string LastName;
}


Хорошему коду комментарии не нужны. Плохому коду комментарии вряд ли помогут.
Показательный пример: "Это мост".
...
Рейтинг: 0 / 0
Заголовочные файлы и С#
    #39529139
Фотография Алексей К
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
Petro123Нафига мне описывать параметр в
SetParameters(Stream stream)
DataSet GetDataSet(......++
...
Рейтинг: 0 / 0
Заголовочные файлы и С#
    #39529140
Фотография Petro123
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
Вы с позиции начальства говорите), а я с позиции программиста).
Код в коде должен быть понятен программисту, а не вам)).
Есть вилка максималистов. На соседней ветке чел весь код увешал комметами. И есть те, кто вообще не ставит. Я посередине)
Разумная достаточность. (С)
Про обозреваемость кода:
- кто при открытии кода лезет не в файл, а в обозреватель классов?
- почему ide не группирует вместе public/private?
- почему по умолчанию новый метод она ставит internal?
...
Рейтинг: 0 / 0
Заголовочные файлы и С#
    #39529141
Фотография Petro123
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
Алексей КotarsВедь на `C++` в отдельные файлы выносятся прототипы функций,рабочий код и тем самым создаётся читабельность огромного кода и его структурированность.И хвала авторам C# за то, что не стали тянуть этот маразм из C++.
Эти файлы вроде есть кстати, только генерируются и не видны. Выскакивают на F12 иногда.
...
Рейтинг: 0 / 0
Заголовочные файлы и С#
    #39529142
Фотография Petro123
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
skyANAкод, написанный в 2010-
Чаще достают оттуда короткие переменные, чтобы код понять.
...
Рейтинг: 0 / 0
Заголовочные файлы и С#
    #39529149
Фотография hVostt
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
Алексей КХорошему коду комментарии не нужны.

Подобный инфантильный бред устал уже слышать.
Ну давай посмотрим на твой «хороший код»:

Код: c#
1.
2.
3.
4.
5.
public class Person
{
    // Фамилия.  <<---------- Кому нужен такой комментарий? Он только засоряет код.
    public string LastName;
}



Ты прав, такой комментарий никому не нужен, потому что он не отвечает ни на один из следующих вопросов:

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

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

Ладно, если с фамилией действительно всё может быть понятно, настолько часто она встречается, то как быть с другими частями? Всё ли настолько прозрачно или просто программист возомнил, что он пишет «хороший код». Главное никому его не показывать
...
Рейтинг: 0 / 0
Заголовочные файлы и С#
    #39529150
Фотография hVostt
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
Алексей К,

Ну и поле вместо свойства.. Уже как бы намекает насколько этот код «хорош» ))
...
Рейтинг: 0 / 0
Заголовочные файлы и С#
    #39529156
Фотография Алексей К
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
Petro123Алексей Кпропущено...
И хвала авторам C# за то, что не стали тянуть этот маразм из C++.
Эти файлы вроде есть кстати, только генерируются и не видны. Выскакивают на F12 иногда.Генерируются по данным рефлекшена. Тут главное, что вручную их писать не надо.
...
Рейтинг: 0 / 0
Заголовочные файлы и С#
    #39529157
Фотография Алексей К
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
hVosttЛадно, если с фамилией действительно всё может быть понятно, настолько часто она встречается, то как быть с другими частями? Всё ли настолько прозрачно или просто программист возомнил, что он пишет «хороший код». Главное никому его не показывать Я не говорю, что комментарии вообще не нужны. Они нужны, если есть какие-то неочевидные особенности. Но писать комментарии во всех очевидных местах, это маразм.
...
Рейтинг: 0 / 0
Заголовочные файлы и С#
    #39529158
Фотография skyANA
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
Алексей КhVosttЛадно, если с фамилией действительно всё может быть понятно, настолько часто она встречается, то как быть с другими частями? Всё ли настолько прозрачно или просто программист возомнил, что он пишет «хороший код». Главное никому его не показывать Я не говорю, что комментарии вообще не нужны. Они нужны, если есть какие-то неочевидные особенности. Но писать комментарии во всех очевидных местах, это маразм.
И в чём же маразм, если комментарии действительно полезные? :)
...
Рейтинг: 0 / 0
Заголовочные файлы и С#
    #39529159
Фотография Алексей К
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
hVosttНу и поле вместо свойства.. Уже как бы намекает насколько этот код «хорош» ))Это говорит о том, что автор знает, где нужно применять свойства, а где нет, вместо тупого написания свойств везде.

зы: Мне немного жаль "твоих" программистов. :-)
...
Рейтинг: 0 / 0
Заголовочные файлы и С#
    #39529160
Фотография Алексей К
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
skyANAАлексей Кпропущено...
Я не говорю, что комментарии вообще не нужны. Они нужны, если есть какие-то неочевидные особенности. Но писать комментарии во всех очевидных местах , это маразм.
И в чём же маразм, если комментарии действительно полезные? :)Ну мне добавить нечего. Вроде чётко и ясно обозначил свою позицию. Выделю навсякий.
...
Рейтинг: 0 / 0
Заголовочные файлы и С#
    #39529161
Фотография hVostt
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
Алексей КЭто говорит о том, что автор знает, где нужно применять свойства, а где нет, вместо тупого написания свойств везде.

зы: Мне немного жаль "твоих" программистов. :-)

Может пояснишь? Я свою позицию легко могу пояснить: свойства поддерживаются как контракт всеми современными библиотеками, поля нет, не всеми, потому что поля это не контракт. Свойства можно сделать виртуальными, сделать private/internal set, с полями не получится.

Использовать поля только приватными членами или только в структурах, это не религия, а обоснованное решение, с которым солидарно абсолютное большинство разработчиков.
...
Рейтинг: 0 / 0
Заголовочные файлы и С#
    #39529162
Фотография hVostt
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
Алексей КЯ не говорю, что комментарии вообще не нужны. Они нужны, если есть какие-то неочевидные особенности. Но писать комментарии во всех очевидных местах, это маразм.

Ну и в чём проблема, написать чёртов комментарий, даже если как тебе кажется всё довольно очевидно? Я вот честно тебе говорю, встречал чуваков, которые реально задавались вопросом: что это ещё за «последнее имя» такое? Многие люди уверены, что все остальные должны думать именно так как они.
...
Рейтинг: 0 / 0
Заголовочные файлы и С#
    #39529163
Фотография skyANA
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
Алексей К,

вот как понятнее, так:
Код: c#
1.
2.
3.
public class AutoIndentWriter : IStringTemplateWriter
{
    protected int charPosition;


или так:
Код: c#
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
/// <summary>
/// Essentially a char filter that knows how to auto-indent output
/// by maintaining a stack of indent levels. I set a flag upon newline
/// and then next nonwhitespace char resets flag and spits out indention.
/// The indent stack is a stack of strings so we can repeat original indent
/// not just the same number of columns (don't have to worry about tabs vs spaces then).
/// 
/// Anchors are char positions (tabs won't work) that indicate where all
/// future wraps should justify to. The wrap position is actually the
/// larger of either the last anchor or the indentation level.
/// 
/// This is a filter on a Writer.
/// 
/// It may be screwed up for '\r' '\n' on PC's.
/// </summary>
public class AutoIndentWriter : IStringTemplateWriter
{
    /// <summary>
    /// Track char position in the line (later we can think about tabs).
    /// Indexed from 0. We want to keep <![CDATA[charPosition <= lineWidth]]>.
    /// This is the position we are *about* to write not the position last written to.
    /// </summary>
    protected int charPosition;


?
...
Рейтинг: 0 / 0
Заголовочные файлы и С#
    #39529164
Фотография hVostt
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
Алексей КНу мне добавить нечего. Вроде чётко и ясно обозначил свою позицию. Выделю навсякий.


Ты забыл добавить, очевидных для кого ? Для тебя? :) А если весь свой код ты считаешь очевидным и хорошим, то зачем комментарии?

Это стандартная и со временем прогрессирующая болезнь программистов-одиночек. Эээх..
...
Рейтинг: 0 / 0
Заголовочные файлы и С#
    #39529170
Фотография Petro123
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
Господа максималисты, начальники. Вы не ответили на вопрос.
Вы серфинг по файлу делаете через что?
Если через окно в ide обозреватель, тогд понятно.
Я смотрю не через него, а сам файл глазками.
И комментарии ещё пока не контракты.
...
Рейтинг: 0 / 0
Заголовочные файлы и С#
    #39529175
Фотография Petro123
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
hVosttТы забыл добавить, очевидных для кого ? Для тебя? :)
Заставить писать много ума не надо. Найти разумную границу, надо ума поболее.
...
Рейтинг: 0 / 0
Заголовочные файлы и С#
    #39529191
Фотография skyANA
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
Petro123Господа максималисты, начальники. Вы не ответили на вопрос.
Вы серфинг по файлу делаете через что?
Если через окно в ide обозреватель, тогд понятно.
Я смотрю не через него, а сам файл глазками.
И комментарии ещё пока не контракты.
Сёрфинг по файлу? Да по разному: Ctrl + F12 (ReSharper), Ctrl + M + O, в Sublime, в FAR, в Notepad++, в Visual Studio Code...
...
Рейтинг: 0 / 0
Заголовочные файлы и С#
    #39529193
Фотография skyANA
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
Petro123hVosttТы забыл добавить, очевидных для кого ? Для тебя? :)
Заставить писать много ума не надо. Найти разумную границу, надо ума поболее.
Ну ну, и в итоге комментарии не пишутся совсем :)
...
Рейтинг: 0 / 0
Заголовочные файлы и С#
    #39529194
Фотография hVostt
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
Petro123,

Самый быстрый в мире сёрфинг Ctrl+T, Ctrl+T+T, Ctrl+T+T+T от решарпера.

Ctrl+M+O, Navigate To, Go To... И так далее.

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

И да, кстати. Даже взять этот упоротый пример от Алексея про «LastName» и как ему почему-то кажется бесполезный комментарий «Фамилия», человек в поиске по "Фамилия" найдёт все классы, где упоминается эта фамилия, а унылый говно «хороший» код Алексея пролетает как фанера над Парижем.
...
Рейтинг: 0 / 0
Заголовочные файлы и С#
    #39529195
Фотография hVostt
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
Petro123hVosttТы забыл добавить, очевидных для кого ? Для тебя? :)
Заставить писать много ума не надо. Найти разумную границу, надо ума поболее.

Какая разумная граница? В чём проблема написать чёртов комментарий, если ты знаешь что пишешь. Если сам не знаешь, то комментарии конечно будут лишь в тягость..
...
Рейтинг: 0 / 0
Заголовочные файлы и С#
    #39529198
Фотография Алексей К
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
hVosttАлексей КЭто говорит о том, что автор знает, где нужно применять свойства, а где нет, вместо тупого написания свойств везде.

зы: Мне немного жаль "твоих" программистов. :-)

Может пояснишь? Я свою позицию легко могу пояснить: свойства поддерживаются как контракт всеми современными библиотеками, поля нет, не всеми, потому что поля это не контракт. Свойства можно сделать виртуальными, сделать private/internal set, с полями не получится.Есть масса случаев, когда поле при необходимости безболезненно преобразуется в свойство. Краткость описания полей привлекает всех нормальных людей. Этот вопрос уже обсуждался, не пойму, к чему ты его поднял.

hVosttИспользовать поля только приватными членами или только в структурах, это не религия, а обоснованное решение, с которым солидарно абсолютное большинство разработчиков.Миллионы леммингов не могут ошибаться. С другой стороны, какие к ним могут быть претензии, их так воспитали.
...
Рейтинг: 0 / 0
Заголовочные файлы и С#
    #39529199
Фотография Алексей К
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
hVosttНу и в чём проблема, написать чёртов комментарий, даже если как тебе кажется всё довольно очевидно?Ну я же выше писал, что он банально мешает. Не говоря уже о бесполезно потраченном времени на его написание.
...
Рейтинг: 0 / 0
Заголовочные файлы и С#
    #39529201
Фотография Petro123
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
skyANAPetro123пропущено...

Заставить писать много ума не надо. Найти разумную границу, надо ума поболее.
Ну ну, и в итоге комментарии не пишутся совсем :)
)))) не. Я за такое ругаю.
Мне бы подошла студия, где они автоматом скрываются и не мешают.
...
Рейтинг: 0 / 0
Заголовочные файлы и С#
    #39529203
Фотография Petro123
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
hVosttсёрфингспс. Попробую
...
Рейтинг: 0 / 0
Заголовочные файлы и С#
    #39529206
Фотография hVostt
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
Алексей КЕсть масса случаев, когда поле при необходимости безболезненно преобразуется в свойство. Краткость описания полей привлекает всех нормальных людей. Этот вопрос уже обсуждался, не пойму, к чему ты его поднял.

Алексей КМиллионы леммингов не могут ошибаться. С другой стороны, какие к ним могут быть претензии, их так воспитали.

Убойный аргумент: «всех нормальных людей» особенно хорошо контрастирует с «леммингами» )))
...
Рейтинг: 0 / 0
Заголовочные файлы и С#
    #39529211
Фотография Petro123
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
skyANAАлексей К,

вот как понятнее, так:
Код: c#
1.
2.
3.
public class AutoIndentWriter : IStringTemplateWriter
{
    protected int charPosition;



или так:
Код: c#
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
/// <summary>
/// Essentially a char filter that knows how to auto-indent output
/// by maintaining a stack of indent levels. I set a flag upon newline
/// and then next nonwhitespace char resets flag and spits out indention.
/// The indent stack is a stack of strings so we can repeat original indent
/// not just the same number of columns (don't have to worry about tabs vs spaces then).
/// 
/// Anchors are char positions (tabs won't work) that indicate where all
/// future wraps should justify to. The wrap position is actually the
/// larger of either the last anchor or the indentation level.
/// 
/// This is a filter on a Writer.
/// 
/// It may be screwed up for '\r' '\n' on PC's.
/// </summary>
public class AutoIndentWriter : IStringTemplateWriter
{
    /// <summary>
    /// Track char position in the line (later we can think about tabs).
    /// Indexed from 0. We want to keep <![CDATA[charPosition <= lineWidth]]>.
    /// This is the position we are *about* to write not the position last written to.
    /// </summary>
    protected int charPosition;



?
Вот вот.
У меня методы размер с экран и треть отдать под описание что я делал?
))
...
Рейтинг: 0 / 0
Заголовочные файлы и С#
    #39529212
Фотография Petro123
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
В обшем, пусть будет автоскрытие, формат json, и кнопка Убрать из проекта. )))
Это будет в VS2018
...
Рейтинг: 0 / 0
Заголовочные файлы и С#
    #39529213
Roman Mejtes
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
частенько комментирую чужой код и делаю + теги документации, так как проекты все большие, комментариев 0 и разобраться в этом говнокоде без комментариев нормально невозможно. Тем более, что когда система уже работает нужно четко понимать, что и где меняешь :( а ко многим проектам которые мне достались, даже хоть какой то документации нет :(
Первое чему нужно учиться в программировании, писать код лаконично и понятно, код должен быть хорошо прокомментирован, не каждый "шаг", а основная информация максимально коротко. И имена нужно нормальные давать используя чёткую терминологию.
Вот чего бы хотелось от того кода, с которым приходится работать, после того, как берешь чужой проект и если не хочешь, чтоб тебя поминали лихим словом ) после увольнения :)

заголовочные файлы не нужны, всю информацию, про которую пишет автор, можно получить по F12 (переход на реализацию), включая текст документации и другие метаданные
...
Рейтинг: 0 / 0
Заголовочные файлы и С#
    #39529217
Фотография Алексей К
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
skyANAАлексей К,

вот как понятнее, так:
Код: c#
1.
2.
3.
public class AutoIndentWriter : IStringTemplateWriter
{
    protected int charPosition;


или так:
Код: c#
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
/// <summary>
/// Essentially a char filter that knows how to auto-indent output
/// by maintaining a stack of indent levels. I set a flag upon newline
/// and then next nonwhitespace char resets flag and spits out indention.
/// The indent stack is a stack of strings so we can repeat original indent
/// not just the same number of columns (don't have to worry about tabs vs spaces then).
/// 
/// Anchors are char positions (tabs won't work) that indicate where all
/// future wraps should justify to. The wrap position is actually the
/// larger of either the last anchor or the indentation level.
/// 
/// This is a filter on a Writer.
/// 
/// It may be screwed up for '\r' '\n' on PC's.
/// </summary>
public class AutoIndentWriter : IStringTemplateWriter
{
    /// <summary>
    /// Track char position in the line (later we can think about tabs).
    /// Indexed from 0. We want to keep <![CDATA[charPosition <= lineWidth]]>.
    /// This is the position we are *about* to write not the position last written to.
    /// </summary>
    protected int charPosition;


? Вероятно, есть смысл показать весь класс. Тогда будет о чём поговорить.
...
Рейтинг: 0 / 0
Заголовочные файлы и С#
    #39529218
Фотография skyANA
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
Алексей КskyANAАлексей К,

вот как понятнее, так:
Код: c#
1.
2.
3.
public class AutoIndentWriter : IStringTemplateWriter
{
    protected int charPosition;



или так:
Код: c#
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
/// <summary>
/// Essentially a char filter that knows how to auto-indent output
/// by maintaining a stack of indent levels. I set a flag upon newline
/// and then next nonwhitespace char resets flag and spits out indention.
/// The indent stack is a stack of strings so we can repeat original indent
/// not just the same number of columns (don't have to worry about tabs vs spaces then).
/// 
/// Anchors are char positions (tabs won't work) that indicate where all
/// future wraps should justify to. The wrap position is actually the
/// larger of either the last anchor or the indentation level.
/// 
/// This is a filter on a Writer.
/// 
/// It may be screwed up for '\r' '\n' on PC's.
/// </summary>
public class AutoIndentWriter : IStringTemplateWriter
{
    /// <summary>
    /// Track char position in the line (later we can think about tabs).
    /// Indexed from 0. We want to keep <![CDATA[charPosition <= lineWidth]]>.
    /// This is the position we are *about* to write not the position last written to.
    /// </summary>
    protected int charPosition;



? Вероятно, есть смысл показать весь класс. Тогда будет о чём поговорить.
Зачем тебе весь класс?
...
Рейтинг: 0 / 0
Заголовочные файлы и С#
    #39529219
Фотография Алексей К
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
skyANAАлексей Кпропущено...
Вероятно, есть смысл показать весь класс. Тогда будет о чём поговорить.
Зачем тебе весь класс?
...
Рейтинг: 0 / 0
Заголовочные файлы и С#
    #39529222
Фотография skyANA
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
Алексей КskyANAпропущено...

Зачем тебе весь класс?
Дай угадаю: ты хочешь просмотреть весь код класса, чтобы понять, за что тот отвечает, так?
...
Рейтинг: 0 / 0
Заголовочные файлы и С#
    #39529227
Фотография hVostt
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
skyANAДай угадаю: ты хочешь просмотреть весь код класса, чтобы понять, за что тот отвечает, так?

Алексей не только писать комменты не любит, но и читать
...
Рейтинг: 0 / 0
Заголовочные файлы и С#
    #39529228
Фотография Petro123
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
hVosttСамый быстрый в мире сёрфинг Ctrl+T, Ctrl+T+T, Ctrl+T+T+T от решарпера.

Ctrl+M+O, Navigate To, Go To... И так далее.
Тьфу на тебя, нету у меня решарпера)))))
...
Рейтинг: 0 / 0
Заголовочные файлы и С#
    #39529229
Фотография Алексей К
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
skyANAАлексей Кпропущено...

Дай угадаю: ты хочешь просмотреть весь код класса, чтобы понять, за что тот отвечает, так?Ну дай хотя бы публичный контракт класса. Может мне повезёт, и я пойму всё из контракта, не заглядывая вовнутрь.
...
Рейтинг: 0 / 0
Заголовочные файлы и С#
    #39529234
Фотография skyANA
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
Petro123hVosttСамый быстрый в мире сёрфинг Ctrl+T, Ctrl+T+T, Ctrl+T+T+T от решарпера.

Ctrl+M+O, Navigate To, Go To... И так далее.
Тьфу на тебя, нету у меня решарпера)))))Покликай правой кнопкой мыши и посмотри комбинации клавиш.
...
Рейтинг: 0 / 0
Заголовочные файлы и С#
    #39529261
Фотография Petro123
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
skyANAPetro123пропущено...

Тьфу на тебя, нету у меня решарпера)))))Покликай правой кнопкой мыши и посмотри комбинации клавиш.
Алексей К, тебе ответил.
Обозреватель структуры WPF появился в 2015upd3. Почти тоже самое но не то есть в WinForms.
Даже в ворде Это есть )))))
...
Рейтинг: 0 / 0
Заголовочные файлы и С#
    #39529283
Фотография skyANA
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
Petro123skyANAпропущено...
Покликай правой кнопкой мыши и посмотри комбинации клавиш.
Алексей К, тебе ответил.
Обозреватель структуры WPF появился в 2015upd3. Почти тоже самое но не то есть в WinForms.
Даже в ворде Это есть )))))
?
...
Рейтинг: 0 / 0
Заголовочные файлы и С#
    #39529294
Фотография Petro123
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
skyANA?
Word меню, 5 режимов просмотра документа.
Аналогия понятна?
У нас только один.
...
Рейтинг: 0 / 0
Заголовочные файлы и С#
    #39529314
Addx
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
skyANAАлексей К,

вот как понятнее, так:
Код: c#
1.
2.
3.
public class AutoIndentWriter : IStringTemplateWriter
{
    protected int charPosition;


или так:
Код: c#
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
/// <summary>
/// Essentially a char filter that knows how to auto-indent output
/// by maintaining a stack of indent levels. I set a flag upon newline
/// and then next nonwhitespace char resets flag and spits out indention.
/// The indent stack is a stack of strings so we can repeat original indent
/// not just the same number of columns (don't have to worry about tabs vs spaces then).
/// 
/// Anchors are char positions (tabs won't work) that indicate where all
/// future wraps should justify to. The wrap position is actually the
/// larger of either the last anchor or the indentation level.
/// 
/// This is a filter on a Writer.
/// 
/// It may be screwed up for '\r' '\n' on PC's.
/// </summary>
public class AutoIndentWriter : IStringTemplateWriter
{
    /// <summary>
    /// Track char position in the line (later we can think about tabs).
    /// Indexed from 0. We want to keep <![CDATA[charPosition <= lineWidth]]>.
    /// This is the position we are *about* to write not the position last written to.
    /// </summary>
    protected int charPosition;


?

Встает вопрос.
Если вы не можете написать краткий, но исчерпывающий комментарий о том, что делает код, а не как написан, в состоянии ли вы написать сам такой код? Понимаете ли вы, зачем он нужен, логику создания данного класса, его методов и свойств?
А так в комментарий еще можно написать свои размышления на эту тему, где и зачем его использовали, ну и пару анекдотов, чтоб не скучно было ))
...
Рейтинг: 0 / 0
Заголовочные файлы и С#
    #39529358
Ролг Хупин
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
Petro123Вы с позиции начальства говорите), а я с позиции программиста).
Код в коде должен быть понятен программисту, а не вам)).
Есть вилка максималистов. На соседней ветке чел весь код увешал комметами. И есть те, кто вообще не ставит. Я посередине)
Разумная достаточность. (С)
Про обозреваемость кода:
- кто при открытии кода лезет не в файл, а в обозреватель классов?
- почему ide не группирует вместе public/private?
- почему по умолчанию новый метод она ставит internal?


группа "Звери"
...
Рейтинг: 0 / 0
Заголовочные файлы и С#
    #39529382
Arm79
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
hVosttПотом при сборке генерится документация и выкладываеся в вики автоматом
Чем генерируете? Я пробовал SandCastle, но его выходной формат мне не понравился. Разбираться с настройкой своего формата не захотелось.
Petro123У меня методы размер с экран и треть отдать под описание что я делал?
А что, сворачивание не работает?
...
Рейтинг: 0 / 0
Заголовочные файлы и С#
    #39529396
Фотография Petro123
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
Arm79,
Работает, но хочется большего.
Целиком на документ Свернуть грёбаные комменты и показать только при клике мышкой.
Я 95 проц.времени код пишу, а не комменты читаю.
При свёрт и развёрт они вместе с кодом мешаются.
А в своём коде мне 1 строки достаточно.
Память не дырявая.
...
Рейтинг: 0 / 0
Заголовочные файлы и С#
    #39529409
schi
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
"люди, отказывающиеся писать комментарии, A) думают, что их код понятнее, чем мог бы быть, B) считают, что другие программисты гораздо сильнее интересуются их кодом, чем есть на самом деле, C) думают, что другие программисты умнее, чем есть на самом деле, D) ленятся или E) боятся, что кто-то другой узнает, как работает их код."

(МакКоннелл)
...
Рейтинг: 0 / 0
Заголовочные файлы и С#
    #39529413
Фотография Petro123
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
Arm79,
Кроме того подпроцедуры только появились?
Т.е. она у меня используется только один раз, а выглядит как полноценный коммент).
"Скажет перфекционист" )))
...
Рейтинг: 0 / 0
Заголовочные файлы и С#
    #39529414
Фотография Petro123
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
schi,
D) ленивый ))
...
Рейтинг: 0 / 0
Заголовочные файлы и С#
    #39529442
Arm79
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
Petro123Arm79,
Работает, но хочется большего.
Целиком на документ Свернуть грёбаные комменты и показать только при клике мышкой.
Я 95 проц.времени код пишу, а не комменты читаю.
При свёрт и развёрт они вместе с кодом мешаются.
А в своём коде мне 1 строки достаточно.
Память не дырявая.
Я с вами не соглашусь. Подход vHostt правильный. В summary писать необходимое описание, включая описание параметров, примеры вызовов и иные моменты. Да, видимость кода может это и понизит (хотя по мне это незначительный фактор, ведь всегда можно свернуть, и свертывание сохраняется), зато всегда можно снегерировать актуальную документацию. Этот момент разработчики упускают. А поддержка доки в актуальном состоянии в ручном режиме - это очень трудная задача.
...
Рейтинг: 0 / 0
Заголовочные файлы и С#
    #39529484
Фотография hVostt
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
Arm79Чем генерируете? Я пробовал SandCastle, но его выходной формат мне не понравился. Разбираться с настройкой своего формата не захотелось.

Собственный самописный генератор. Чёт тухловато на просторах на эту тему. SandCastle загнулся, остальное поделки так себе, даже DocFX фигня.
...
Рейтинг: 0 / 0
Заголовочные файлы и С#
    #39529490
Фотография Petro123
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
Arm79хотя по мне это незначительный фактор, ведь всегда можно свернуть, и свертывание сохраняется
И всё? Это решение вопроса?
Попробуйте C+M,P и потом C+M, L.
Главное чтобы вам потом документацию и акт подписывать.
Не нужно решать проблемы тонера в принтере и документации за счёт программиста.
...
Рейтинг: 0 / 0
Заголовочные файлы и С#
    #39529497
Фотография Petro123
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
Arm79,
Свертываемость кода должна быть независимой от комментов не только прицелом мышки.
Тогда всем будет хорошо.
...
Рейтинг: 0 / 0
Заголовочные файлы и С#
    #39529675
Фотография skyANA
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
AddxskyANAАлексей К,

вот как понятнее, так:
Код: c#
1.
2.
3.
public class AutoIndentWriter : IStringTemplateWriter
{
    protected int charPosition;



или так:
Код: c#
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
/// <summary>
/// Essentially a char filter that knows how to auto-indent output
/// by maintaining a stack of indent levels. I set a flag upon newline
/// and then next nonwhitespace char resets flag and spits out indention.
/// The indent stack is a stack of strings so we can repeat original indent
/// not just the same number of columns (don't have to worry about tabs vs spaces then).
/// 
/// Anchors are char positions (tabs won't work) that indicate where all
/// future wraps should justify to. The wrap position is actually the
/// larger of either the last anchor or the indentation level.
/// 
/// This is a filter on a Writer.
/// 
/// It may be screwed up for '\r' '\n' on PC's.
/// </summary>
public class AutoIndentWriter : IStringTemplateWriter
{
    /// <summary>
    /// Track char position in the line (later we can think about tabs).
    /// Indexed from 0. We want to keep <![CDATA[charPosition <= lineWidth]]>.
    /// This is the position we are *about* to write not the position last written to.
    /// </summary>
    protected int charPosition;



?

Встает вопрос.
Если вы не можете написать краткий, но исчерпывающий комментарий о том, что делает код, а не как написан, в состоянии ли вы написать сам такой код? Понимаете ли вы, зачем он нужен, логику создания данного класса, его методов и свойств?
А так в комментарий еще можно написать свои размышления на эту тему, где и зачем его использовали, ну и пару анекдотов, чтоб не скучно было ))
Могли бы и погуглить AutoIndentWriter .
Неужели зайдя на страницу по ссылке у Вас складывается впечатление, что информация избыточна?
...
Рейтинг: 0 / 0
Заголовочные файлы и С#
    #39529676
Фотография skyANA
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
schi"люди, отказывающиеся писать комментарии, A) думают, что их код понятнее, чем мог бы быть, B) считают, что другие программисты гораздо сильнее интересуются их кодом, чем есть на самом деле, C) думают, что другие программисты умнее, чем есть на самом деле, D) ленятся или E) боятся, что кто-то другой узнает, как работает их код."

(МакКоннелл)
+1
...
Рейтинг: 0 / 0
Заголовочные файлы и С#
    #39530121
Фотография hVostt
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
skyANAschi"люди, отказывающиеся писать комментарии, A) думают, что их код понятнее, чем мог бы быть, B) считают, что другие программисты гораздо сильнее интересуются их кодом, чем есть на самом деле, C) думают, что другие программисты умнее, чем есть на самом деле, D) ленятся или E) боятся, что кто-то другой узнает, как работает их код."

(МакКоннелл)
+1

F) сами нихрена не понимают что должен делать их код и как его правильно использовать, поэтому ничего написать внятного не в состоянии

а потом смеются над картинками про комментарии типа «это мост», ведь это им так близко
...
Рейтинг: 0 / 0
Заголовочные файлы и С#
    #39530316
Addx
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
skyANAAddxпропущено...


Встает вопрос.
Если вы не можете написать краткий, но исчерпывающий комментарий о том, что делает код, а не как написан, в состоянии ли вы написать сам такой код? Понимаете ли вы, зачем он нужен, логику создания данного класса, его методов и свойств?
А так в комментарий еще можно написать свои размышления на эту тему, где и зачем его использовали, ну и пару анекдотов, чтоб не скучно было ))
Могли бы и погуглить AutoIndentWriter .
Неужели зайдя на страницу по ссылке у Вас складывается впечатление, что информация избыточна?

Нет, конечно.
Я бы и от пары анекдотов не отказался)
Если серьезно, то чем больше документации, тем лучше, но требовать писать ее для каждого метода ...
Либо ты будешь заниматься только этим вместо разработки, либо сроки вырастут в несколько раз.
Чудес не бывает.
Впрочем, есть понятие публичной документации. Но у меня то же MSDN никак не проассоциируется с "комментариями к коду".
...
Рейтинг: 0 / 0
Заголовочные файлы и С#
    #39530394
Фотография hVostt
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
AddxЕсли серьезно, то чем больше документации, тем лучше, но требовать писать ее для каждого метода ...

Для каждого публичного метода, представляющего контракт. Также есть <inheritdoc />, который снижает болевой порог у людей, которым лень описывать одно и тоже.
...
Рейтинг: 0 / 0
Заголовочные файлы и С#
    #39530401
Фотография skyANA
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
AddxЕсли серьезно, то чем больше документации, тем лучше, но требовать писать ее для каждого метода ...
А я требовал?
Вроде как я задал вопрос: "И в чём же маразм, если комментарии действительно полезные?". И привёл кусок кода для иллюстрации.
...
Рейтинг: 0 / 0
Заголовочные файлы и С#
    #39530402
Фотография hVostt
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
AddxЛибо ты будешь заниматься только этим вместо разработки, либо сроки вырастут в несколько раз.
Чудес не бывает.

Без всякой демагогии скажу, что это абсолютная неправда. Создаешь новый публичный тип, сразу пишешь к нему доку, это помогает не только для сопровождения, но и для разработки, когда формируешь свои мысли текстом, организуешь сам процесс в голове. Можешь отвлечься и вернуться к коду, не копаясь в памяти, или тут же передать реализацию другому человеку, это очень хорошо связано с TDD, который тоже ругают «гении от мысли» :)
...
Рейтинг: 0 / 0
Заголовочные файлы и С#
    #39530409
Фотография hVostt
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
Addx,

Уже второй год покрываем код докой, и никакой просадки по срокам из-за комментариев не замечено. Зато замечено, что количество тупой коммуникации по типу «а для чего вот этот класс?? а для чего этот метод?? а где найти работу вот с этим??» снизилось практически до нуля. Бывает, что достаточно сказать название типа или метода, и этого достаточно, всё остальное там написано в комментах. Также выяснилось, что очень удобно искать код по русским комментариям, так иногда можно забыть название типа, свойства или метода, особенно если не ты его писал.
...
Рейтинг: 0 / 0
Заголовочные файлы и С#
    #39530411
Фотография Petro123
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
hVostt,
Еще есть технический писатель и кондишен.
Это снижает болевой порог и повышает ПРОИЗВОДИТЕЛЬНОСТЬ труда.
Счас актуальна эффективность).
...
Рейтинг: 0 / 0
Заголовочные файлы и С#
    #39530414
Фотография Petro123
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
hVosttСоздаешь новый публичный тип, сразу пишешь к нему доку,
А также Руководство пользователя, и юнит тесты.
...
Рейтинг: 0 / 0
Заголовочные файлы и С#
    #39530425
Фотография hVostt
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
Petro123hVostt,
Еще есть технический писатель и кондишен.
Это снижает болевой порог и повышает ПРОИЗВОДИТЕЛЬНОСТЬ труда.
Счас актуальна эффективность).

Ну есть тех. писатель, но у него много другой работы :)
...
Рейтинг: 0 / 0
Заголовочные файлы и С#
    #39530426
Фотография hVostt
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
Petro123hVosttСоздаешь новый публичный тип, сразу пишешь к нему доку,
А также Руководство пользователя, и юнит тесты.

Руководство пользователя, это не к разработчикам :)
Тем более, мы стараемся писать такие системы, где пользователю будет предложено выполнить его задачи при входе, без талмуда, зайди туда, щёлкни сюда, ещё раз щёлкни, «провались» и т.д. Такого нет :)
...
Рейтинг: 0 / 0
Заголовочные файлы и С#
    #39530443
Фотография skyANA
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
Petro123hVosttСоздаешь новый публичный тип, сразу пишешь к нему доку,
А также Руководство пользователя, и юнит тесты.
А ещё reliability, UX и немодерируемое тестирование :)
...
Рейтинг: 0 / 0
Заголовочные файлы и С#
    #39530449
Фотография LR
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
Отсутствие комментария - это своего рода комментарий о том, что ничего необычного/неожиданного/недоделанного/и т.п. нет. Т.е., есть комментарий - читай его, и это поможет правильно понять код, нет комментария - читай код, ибо в этом случае неправильно понять невозможно.
...
Рейтинг: 0 / 0
Заголовочные файлы и С#
    #39530453
Фотография Petro123
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
hVosttпровались
)))) LOL
...
Рейтинг: 0 / 0
Заголовочные файлы и С#
    #39530456
Фотография Petro123
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
LRОтсутствие комментария - это своего рода комментарий о том, что ничего необычного/неожиданного/недоделанного/и т.п. нет. Т.е., есть комментарий - читай его, и это поможет правильно понять код, нет комментария - читай код, ибо в этом случае неправильно понять невозможно.
)) я всегда предуреждаю: "райзе мин нет".
...
Рейтинг: 0 / 0
Заголовочные файлы и С#
    #39548276
Фотография LR
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
Вот наткнулся в исходниках System.Random на такой комментарий
Код: c#
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
/*==================================NextBytes===================================
      **Action:  Fills the byte array with random bytes [0..0x7f].  The entire array is filled.
      **Returns:Void
      **Arugments:  buffer -- the array to be filled.
      **Exceptions: None
      ==============================================================================*/
      public virtual void NextBytes(byte [] buffer){
        if (buffer==null) throw new ArgumentNullException("buffer");
        Contract.EndContractBlock();
        for (int i=0; i<buffer.Length; i++) {
          buffer[i]=(byte)(InternalSample()%(Byte.MaxValue+1)); 
        }
      }


Хотя, на самом деле, диапазон заполняемых значений [0..0xff]. А здесь это весьма принципиально.
Это к тому, что лучше уж отсутствие комментария, чем присутствие неправильного/вводящего в заблуждение.
...
Рейтинг: 0 / 0
Заголовочные файлы и С#
    #39548295
Roman Mejtes
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
LR,

Я видел в WPF сборку комментарий на ~50 строк, в нём была какая то диаграмма :) посмеялся знатно
...
Рейтинг: 0 / 0
81 сообщений из 81, показаны все 4 страниц
Форумы / WinForms, .Net Framework [игнор отключен] [закрыт для гостей] / Заголовочные файлы и С#
Целевая тема:
Создать новую тему:
Автор:
Закрыть
Цитировать
Найденые пользователи ...
Разблокировать пользователей ...
Читали форум (0):
Пользователи онлайн (0):
x
x
Закрыть


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