[an error occurred while processing the directive]Комментирование кода в C++[an error occurred while processing the directive]
<html>
<title>404 Not Found</title>
<style>html{color-scheme:light dark;}</style>
</head>
<body>
<center><h1>404 Not Found</h1></center>
<hr><center>Angie</center>
</body>
</html>

[an error occurred while processing the directive]

<h1 align=center>Комментирование кода в C++</h1>

<b>Автор:</b> <a href="http://forum.sources.ru/index.php?showuser=10169"><i>Мяут</i></a>

<p>Все языки программирования стремятся облегчить нашу с Вами работу, предлагая все новые и новые способы, позволяющее не делать ничего по нескольку раз. Именно так появились объектно-ориентированные языки программирования, которые позволяли использовать код дважды. Однако сегодня мы поговрим не об этом. Наша сегодняшняя тема - комментирование кода в C и C++. Благодаря комментариям Вам не нужно несколько раз переосмысливать код, написанный вчера, или много месяцев назад. Сначала разберемся со стилями расстановки коментариев.</p>

<p><b>Блочный комментарий.</b></p>
<p>Этот тип - настоящая головная боль при поддержке, потому как обязует программиста к расстановке и левых и правых разделителей (чаще всего это звездочки).</p>
<p>Например так:</p>

<pre class="code">
/***********************************
*                                  *
* Данный исходник разработан       *
* Мяутом в 2004-м году.            *
*                                  *
************************************/
</pre>

<p>Пусть у меня появился соавтор:</p>

<pre class="code">
/***********************************
*                                  *
* Данный исходник разработан       *
* Мяутом, Вторым и третьим программистом в 2005-м году.            *
*                                  *
************************************/
</pre>

<p>Теперь надо перерасставлять все разделители.</p>
<p>Вы наверное возразите: "Можно же опускать звездочки справа". Это конечноже решает проблему, но все-таки Вам в любом случае придется продлевать первую и последнюю строку.</p>

<pre class="code">
/***********************************
*
* Данный исходник разработан
* Мяутом в 2004-м году.
*
************************************/
</pre>

<p>Миримизированый блочный комментарий.</p>
<p>Можно вообще обойтись без звездочек:</p>

<pre class="code">
/*

  Данный исходник разработан
  Мяутом в 2004-м году.
 
                                   */
</pre>

<p>Есть и другие типы, но они встречаются реже.</p>

<pre class="code">
/*
*
* Данный исходник разработан
* Мяутом в 2004-м году.
*
*/
</pre>

<p>В стандарте C99 и в C++ описан еще один тип комметариев: //. Он действует в пределах от самой последовательности двух слэшей до следующего перевода строки.</p>
<p>Если в конце строки стоит символ '\', считается комментарием и следующая строка.</p>
<p>Теперь поговорим о самом комментирование кода. Безусловно, оно очень важно при написании программы, особенно если программистов несколько.</p>
<p>Во-первых избегайте лишних комментариев. Думаю, и Вам покажется глупой следующая строка:</p>

<pre class="code">
 i++; //Прибавление 1 к i
</pre>

<p>Иногда даже встречаются необычные образцы:</p>

<pre class="code">
 int var3947l; //Не помню
</pre>

<p>И не забывайте, что помимо комметариев, хорошие идентификаторы также делают код читабельнее.</p>
<p>Во-вторых, старайтесь комментировать не очевидные действия, а целые блоки кода, отвечающие за ту или иную процедуру. Сравните:</p>

<pre class="code">
 CurrentFont->Name = Current->Data->Font.Face; //Выбор текущего шрифта
 CurrentFont->Color = Current->Data->Font.Color; //Выбор цвета шрифта
 CurrentFont->Size = Current->Data->Font.Size; //Выбор размера шрифта
 Canvas->Font->Assign(CurrentFont); //Установка шрифта
</pre>

<p>и</p>

<pre class="code">
//Установка и настройка текущего шрифта
 CurrentFont->Name = Current->Data->Font.Face;
 CurrentFont->Color = Current->Data->Font.Color;
 CurrentFont->Size = Current->Data->Font.Size;
 Canvas->Font->Assign(CurrentFont);
</pre>

<p>В-третьих, не всегда пользуйтесь вторым правилом :)  Вот вам пример:</p>

<pre class="code">
 if(PolygonList[i].maxz==0) glTexCoord3f(Point->x/PolygonList[i].maxx, 1., Point->y/PolygonList[i].maxy);
 else if(PolygonList[i].maxy==0) glTexCoord3f(Point->x/PolygonList[i].maxx, 1., Point->z/PolygonList[i].maxz);
 else if(PolygonList[i].maxx==0) glTexCoord3f(1., Point->y/PolygonList[i].maxy, Point->z/PolygonList[i].maxz);
 else glTexCoord3f(Point->x/PolygonList[i].maxx, Point->y/PolygonList[i].maxy, Point->z/PolygonList[i].maxz);
</pre>

<p>Этот кусок я не стал по-началу комментровать, а зря. Дело в том, что модели не всегда имеют целые значения вершин, и  как следствие, могут не правильно текстурироваться. С помощью этого кода и приводил их значения к целым. Через несколько дней я вернулся к этому коду. И что вы думаете я написал?</p>

<pre class="code">
 glTexCoord3f(Point->x, Point->y, Point->z);
</pre>

<p>Однако работало это гораздо хуже. К счастью для меня, я не стал удалять первый фрагмент кода.</p>
<p>В-четвертых, комментируйте закрывающие скобки. Это поможет вспомнить Вам, какая из скобок к какому блочному оператору строк.</p>
<p>Некоторые программмисты предлагают еще пятое правило - не комментируйте сам код, а используйте дерективы препроцессора. Я сам его не соблюдаю, потому и Вам морочить голову не буду.</p>
<p>//(с) Статью подготовил Кляус Сергей.</p>

[an error occurred while processing the directive]