Комментарии при написании программы.

Новый комментарий
[Удален]  
извините если вопрос поднимался,проблемка такая пишеш скрипт пошагово строк через 500 начинаеш забывать чего написал вначале начинаеш ползать по коду(плюсиков сварачивающих функции по скобкам в эдиторе нету к сожелению)если по логике писать то таже история с ползаньем, к одной функции другие 20 обращаются:-)может кто подскажет как правильно выстраивать структуру ну или линк кинте де почитать
 
skywoker:
извините если вопрос поднимался,проблемка такая пишеш скрипт пошагово строк через 500 начинаеш забывать чего написал вначале начинаеш ползать по коду(плюсиков сварачивающих функции по скобкам в эдиторе нету к сожелению)если по логике писать то таже история с ползаньем, к одной функции другие 20 обращаются:-)может кто подскажет как правильно выстраивать структуру ну или линк кинте де почитать
Комментарии надо ставить, чтобы потом не вспоминать, о чем идет речь в том или ином куске алгоритма. Человеческая память - она ведь не резиновая.
[Удален]   
Start {
 
// Комментарий. Это вызов функции:
MyFunction();
 
return(0);
}
 
void MyFunction() {
Print("Твоя функция");
}
 

Это известная проблема. Общее её решение сводится к следующему.

1. Большие программы необходимо разбивать на части. Каждую логически завершённую часть нужно оформить в виде функции. Обычно такую отдельно взятую функцию (реже несколько) сохраняют в виде одного mqh файла, кот. включют в программу с помощью директивы #include. Постепенно из набора таких файлов складывается библиотека, а в дальнейшем программирование сводится к поиску новых алгоритмов, при реализации кот. используются библиотечные файлы.

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

3. Стремиться не допускать в одной функции более 200 строк. Исключение могут составлять функции - носители однотипной информации, например, строки тектов выводимых сообщений.

4. Обязательно писать построчный комментарий. В каждой строке.

5. Разделять логически завершённые небольшие фрагменты горизонтальными линиями-комментариями, используя разную "жирность", например, ----, ====, жжжж и пр.

Однажды начав это делать, вы легко избавитесь от раздражающего скролирования по длинному тексту. К использованию библиотек тоже очень легко привыкнуть. Полагается, что следование этим советам высвободит не менее 50% времени и позволит избавиться от 90% негативных эмоций.

Вот не самый лучший образец. Понимать там ничего не надо, просто посмотрите оформление. Одна из моих программ содержит ок. 200 подобных функций различного назначения.

Файлы:
ag_torg_win_mod_ot.mqh  9 kb
 
SK. писал (а):

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

Да нет тут никакой проблемы, кроме одной единственной - лени некоторых "программеров-прожектеров" вставлять комментарии.
 
Reshetov:
SK. писал (а):

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





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




Рад что Вас "разбанили" на форуме.
Да коменты это вещь. И функции тоже штука очень полезная.
[Удален]  
SK. спасибо..
Новый комментарий