| Правила | Регистрация | Пользователи | Поиск | Сообщения за день | Все разделы прочитаны | Справка по форуму | Файлообменник | |
|
Поиск в этой теме |
|
||||
САПР Регистрация: 29.09.2011
СПб
Сообщений: 283
|
Мне кажется, этой фразой многие заинтересовались. Разъясните, как можно разобраться с чужим кодом, не зная функций?
__________________
На работе было скучно:shout: |
|||
|
||||
САПР Регистрация: 29.09.2011
СПб
Сообщений: 283
|
Ну так разберитесь с приведенным в примере кодом и расскажите, какие у него должны быть данные на входе, что должно быть на выходе, что этот код делает вообще, раз вы специалист
Было бы не плохо реконструировать вычислительный алгоритм, но это высший пилотаж
__________________
На работе было скучно:shout: |
|||
|
||||
САПР Регистрация: 29.09.2011
СПб
Сообщений: 283
|
Вот комментарии к этому лиспу:
;;;интерполяция бигармонической сплайн-поверхностью ;;;комплексные вычисления эмулируются списком (Re Im) ;;;обратная матрица находится методом Гаусса-Жордана ;;;e00 - заданные значения узлов по осям, список с тройками координат ;;;e01 - значения точки по осям, список с тройками координат, искомое - nil Легче стало? А раз вы, по собственным же словам, не специалист, тогда не беритесь рассуждать о том, в чем вы дилетант, как например, об одном из отличий грамотного кода от неграмотного, которое заключается в наличии построчных комментариев, или о сравнительной простоте адаптации чужой законченной функции по сравнению с написанием собственной новой.
__________________
На работе было скучно:shout: |
|||
|
||||
САПР Регистрация: 29.09.2011
СПб
Сообщений: 283
|
Приведенные комментарии достаточны для понимания работы законченной функции, чтобы использовать ее в дальнейшем, но это так И говорят вовсе не о необходимости писать построчные комментарии, а о необходимости документировать написанное, а это не одно и то же.
Естественно, я не буду учить вас писать оптимальный код, потому что вы по собственным же словам, еще и учебника не освоили И собственно, учебник вам поможет, хотя бы чтобы применительно к лиспу не упоминать подпрограммы.
__________________
На работе было скучно:shout: |
|||
|
||||
САПР Регистрация: 29.09.2011
СПб
Сообщений: 283
|
У нас, наверное, разные справки))
Цитата:
Не из акадовской справки, но для общего понимания: Цитата:
Цитата:
Здесь документирование в общем смысле как спецификация назначения функции, ее аргументов и возвращаемого значения. И да, с помощью комментирования строк, потому что докстринги не поддерживаются.
__________________
На работе было скучно:shout: |
|||
|
||||
Регистрация: 10.08.2013
Сообщений: 11,005
|
если не планируется поддерживать/развивать/использовать куски кода в других проектах - то можно обойтись и говорящими названиями переменных и функций) Недаром есть поговорка "Самый тупой карандаш лучше самой острой памяти" (с).
|
|||
|
||||
Регистрация: 10.08.2013
Сообщений: 11,005
|
Бессмысленный разговор. Каждый для себя сам решает - бегать все время по граблям или подстелить "соломку". Тем более, если есть механизмы для этого типа XML комментариев и ему подобного. Хотя IDE лиспа, как и VBA - безнадежно отстал уже в этом смысле, конечно.
|
|||
|
||||
Регистрация: 10.08.2013
Сообщений: 11,005
|
XML документация или документирующие комментарии XML https://habrahabr.ru/post/41514/
|
|||
|
Опции темы | Поиск в этой теме |
|
|
Похожие темы | ||||
Тема | Автор | Раздел | Ответов | Последнее сообщение |
Revit 2017. Что делать, если на мощном компьютере сильно тормозит файл ревита весом 35мб? | klenk100 | Revit | 17 | 07.04.2017 08:39 |
Графические примитивы, скопированные через буфер обмена "тянут" за собой "мусор", который "раздувает" файл и впоследствии "убивает" буфер обмена | Shaggy | AutoCAD | 2 | 01.07.2016 22:37 |
Можно ли запустить команду для списка файлов, не открывая файлов? | Alexander_Liseev | Программирование | 4 | 28.02.2013 11:41 |
Приоткрытии чертежа в автокаде файл требует файл формы, что делать? | kiraxmaz | AutoCAD | 3 | 11.08.2011 13:56 |
Файл сохранен тока для просмотра можно ли его редактировать | Анальный пират | AutoCAD | 3 | 17.02.2008 06:01 |