http://freesource.info/wiki/Etersoft/CodingStyle History/revisions of FreeSource/Etersoft/CodingStyle en-us http://freesource.info/wiki/Etersoft/CodingStyle/show?time=2007-12-24+12%3A27%3A43 <div class="pageBefore"><img src="http://freesource.info/wiki/images/z.gif" width="1" height="1" border="0" alt="" style="display:block" align="top" /></div><div class="page"> <b>Сравнение версий <a name=".etersoft.codingstyle" href="http://freesource.info/wiki/Etersoft/CodingStyle&" class="">/Etersoft&nbsp;/&nbsp;Coding&nbsp;Style</a> за <a href="http://freesource.info/wiki/Etersoft/CodingStyle?time=2007-12-24+12%3A27%3A43">2007-12-24 12:27:43</a> и <a href="http://freesource.info/wiki/Etersoft/CodingStyle">2008-06-04 05:38:36</a></b><br /> <br /> <b>Добавлено:</b><br /> <div class="additions"><ul><li> не&nbsp;рекомендуется использовать strcat и&nbsp;strcpy (нужен контроль границ) </li><li> в&nbsp;коде не&nbsp;должно быть числовых констант, обозначающих символы (if (buf[i]==63) </li><li> временно отключаемые участки кода можно выключать через if&nbsp;(0) или&nbsp;#if 0 </li><li> выделять память нужно с&nbsp;помощью принятых для&nbsp;этого в&nbsp;данном языке и&nbsp;среде функций, в&nbsp;едином стиле </li><li> выделенную память надо освобождать </li><li> параметры функции и&nbsp;сама функция как&nbsp;член класса должны иметь модификатор const, если возможно </li><li> программа не&nbsp;должна содержать прямых путей к&nbsp;файлам (переносимость!) </li><li> для&nbsp;возможно большего числа функций в&nbsp;программе должны быть написаны тесты.</li></ul></div><br /> <b>Удалено:</b><br /> <div class="deletions"><ul><li> не&nbsp;рекомендуется использовать strcat </li><li> не&nbsp;должно быть числовых констант, обозначающих символы (if (buf[i]==63) </li><li> временно отключаемые участки кода лучше выключать через #if 0 </li><li> выделять память нужно с&nbsp;помощью принятых для&nbsp;этого функций, в&nbsp;едином стиле </li><li> выделенную память надо освобождать как&nbsp;можно скорее </li><li> параметры функции должны иметь модификатор const, если возможно </li><li> программа не&nbsp;должна содержать прямых путей к&nbsp;файлам </li><li> для&nbsp;возможно большего числа функций в&nbsp;программе должны быть написаны test cases.</li></ul></div></div> http://freesource.info/wiki/Etersoft/CodingStyle/show?time=2007-12-23+15%3A57%3A30 <div class="pageBefore"><img src="http://freesource.info/wiki/images/z.gif" width="1" height="1" border="0" alt="" style="display:block" align="top" /></div><div class="page"> <b>Сравнение версий <a href="http://freesource.info/wiki/Etersoft/CodingStyle&" class="">/Etersoft&nbsp;/&nbsp;Coding&nbsp;Style</a> за <a href="http://freesource.info/wiki/Etersoft/CodingStyle?time=2007-12-23+15%3A57%3A30">2007-12-23 15:57:30</a> и <a href="http://freesource.info/wiki/Etersoft/CodingStyle?time=2007-12-24+12%3A27%3A43">2007-12-24 12:27:43</a></b><br /> <br /> <b>Добавлено:</b><br /> <div class="additions"><ul><li> минимум использования числовых констант в&nbsp;явном виде (типа j&nbsp;+= 25) </li><li> временно отключаемые участки кода лучше выключать через #if 0</li></ul></div><br /> <b>Удалено:</b><br /> <div class="deletions"><ul><li> минимум использования числовых констант в&nbsp;явном виде (типа j&nbsp;= j&nbsp;+ 25) </li><li> временно отключаемые участки кода лучше выключать через #ifdef 0</li></ul></div></div> http://freesource.info/wiki/Etersoft/CodingStyle/show?time=2007-12-23+15%3A53%3A55 <div class="pageBefore"><img src="http://freesource.info/wiki/images/z.gif" width="1" height="1" border="0" alt="" style="display:block" align="top" /></div><div class="page"> <b>Сравнение версий <a href="http://freesource.info/wiki/Etersoft/CodingStyle&" class="">/Etersoft&nbsp;/&nbsp;Coding&nbsp;Style</a> за <a href="http://freesource.info/wiki/Etersoft/CodingStyle?time=2007-12-23+15%3A53%3A55">2007-12-23 15:53:55</a> и <a href="http://freesource.info/wiki/Etersoft/CodingStyle?time=2007-12-23+15%3A57%3A30">2007-12-23 15:57:30</a></b><br /> <br /> <b>Добавлено:</b><br /> <div class="additions"><a name="h8187-1"></a><h2> Общий подход </h2> <ul><li> нельзя вписывать конструкции &laquo;на всякий случай&raquo;, не&nbsp;понимая, что&nbsp;происходит </li><li> нельзя оставлять &laquo;на потом&raquo; форматирование и&nbsp;комментарии </li><li> не&nbsp;вписывать конструкции вида textbuf[len]=0 на&nbsp;всякий случай </li><li> не&nbsp;рекомендуется использовать strcat </li><li> не&nbsp;должно быть числовых констант, обозначающих символы (if (buf[i]==63)</li></ul><a name="h8187-2"></a><h2> Форматирование кода, стиль, стандарт </h2> <ul><li> код&nbsp;должен быть отформатирован </li><li> временно отключаемые участки кода лучше выключать через #ifdef 0 </li><li> код&nbsp;должен быть написан в&nbsp;стиле, принятом для&nbsp;соответствующего языка </li><li> программа должна компилироваться с&nbsp;помощью mingw без&nbsp;выдачи предупреждений </li><li> программа должна состоять из&nbsp;модулей (логически завершённых блоков), разнесённых по&nbsp;файлам</li></ul><a name="h8187-3"></a><h2> Запись логических выражений </h2> <ul><li> конструкции вида if&nbsp;(a !=0 ) должны выглядеть как&nbsp;if&nbsp;(a) </li><li> конструкции вида if&nbsp;(strcmp(...)==0) должны выглядеть как&nbsp;if&nbsp;(!strcmp())</li></ul><a name="h8187-4"></a><h2> Типы данных и&nbsp;память </h2> <ul><li> выделять память нужно с&nbsp;помощью принятых для&nbsp;этого функций, в&nbsp;едином стиле </li><li> преобразования типов должны быть минимизированы и&nbsp;применяться по&nbsp;осознанной необходимости </li><li> выделенную память надо освобождать как&nbsp;можно скорее </li><li> параметры функции должны иметь модификатор const, если возможно</li></ul><a name="h8187-5"></a><h2> Пути к&nbsp;файлам </h2> <ul><li> программа не&nbsp;должна содержать прямых путей к&nbsp;файлам </li><li> для&nbsp;разделителя путей надо применять специальную константу</li></ul><a name="h8187-6"></a><h2> Совместная работа и&nbsp;релизы </h2> <ul><li> для&nbsp;каждой протестированной или&nbsp;выпускаемой сборки должен быть установлен tag&nbsp;в&nbsp;CVS </li><li> запрещается копировать файлы с&nbsp;исходным кодом. Используйте CVS&nbsp;для передачи файлов. </li><li> для&nbsp;возможно большего числа функций в&nbsp;программе должны быть написаны test cases. </li><li> по&nbsp;каждому релизу должна быть сохранена бинарная сборка</li></ul></div><br /> <b>Удалено:</b><br /> <div class="deletions"><ul><li> перестать вписывать конструкции вида textbuf[len]=0 на&nbsp;всякий случай </li><li> не&nbsp;должно быть числовых констант, обозначающих символы ( if&nbsp;(buf[i]==63)</li></ul> Форматирование кода, стиль, стандарт<br /> • код&nbsp;должен быть отформатирован<br /> • временно отключаемые участки кода лучше выключать через #ifdef 0<br /> • код&nbsp;должен быть написан в&nbsp;стиле, принятом для&nbsp;соответствующего языка<br /> • программа должна компилироваться с&nbsp;помощью mingw без&nbsp;выдачи предупреждений<br /> • программа должна состоять из&nbsp;модулей (логически завершённых блоков), разнесённых по&nbsp;файлам<br /> Запись логических выражений<br /> • конструкции вида if&nbsp;(a !=0 ) должны выглядеть как&nbsp;if&nbsp;(a)<br /> • конструкции вида if&nbsp;(strcmp(...)==0) должны выглядеть как&nbsp;if&nbsp;(!strcmp())<br /> Типы данных и&nbsp;память<br /> • преобразования типов должны быть минимизированы и&nbsp;применяться по&nbsp;осознанной необходимости<br /> • выделенную память надо освобождать как&nbsp;можно скорее<br /> • параметры функции должны иметь модификатор const, если возможно<br /> Пути к&nbsp;файлам<br /> • программа не&nbsp;должна содержать прямых путей к&nbsp;файлам<br /> Совместная работа и&nbsp;релизы<br /> • для&nbsp;каждой протестированной или&nbsp;выпускаемой сборки должен быть установлен tag&nbsp;в&nbsp;CVS<br /> • запрещается копировать файлы с&nbsp;исходным кодом. Используйте CVS&nbsp;для передачи файлов.<br /> • для&nbsp;возможно большего числа функций в&nbsp;программе должны быть написаны test cases.<br /> • по&nbsp;каждому релизу должна быть сохранена бинарная сборка</div></div>