Joomla 1.5 Template By Youjoomla.com

Вы можете пояснять свои сценарии, делая комментарии к ним. Иногда, просто взглянув на сценарий, невозможно понять, как он работает или почему он был спроектирован именно так, а не иначе. Лучший способ ответить на эти вопросы - добавить комментарии. Они позволяют другим людям лучше понимать ваши намерения. Кроме того, комментарии могут послужить хорошей справкой и для самого разработчика, поскольку зачастую нетрудно забыть, почему данный фрагмент кода был реализован именно таким образом. Язык MEL поддерживает два типа комментариев.

Первый - однострочный комментарий. Он начинается с двух левых косых (//). Комментарием считается весь текст до конца строки, следующий за этими символами. int $avg; // Среднее число частиц в составе сцены Второй тип комментария - многострочный. Чтобы записать комментарий, который занимает более одной строки, просто заключите его в специальные скобки (/*, */).

Этот сценарий - часть расширенного пакета визуализации. Copyright (с) 2002 Smarty Pants Inc. */ Многострочные комментарии нельзя вкладывать друг в друга. Далее приведен пример, где один комментарий содержится внутри другого.

Такой код приведет к синтаксической ошибке. int. $avg; Для расчета среднего значения используется сумма по всем сферам в составе сцены. */ $avg = average( Sinput ); */ Комментарии могут быть очень удобны для включения и выключения различных фрагментов сценария. Если, к примеру, вы разрабатываете сценарий для выполнения конкретной задачи, а затем хотите внести в него изменения и усовершенствования, то исходные разделы кода обычнс копируют и помечают как комментарий. Так позднее вы сможете восстановить начальный вариант кода, если это понадобится.

Основная цель комментария - дать читателю ответ на все вопросы как и почему относительно того, что вы делаете. Подробный ответ на вопрос что не столь важен, поскольку это становится очевидным при просмотре кода. В следующем примере комментарий является излишним, так как понять, что происходит, вы сможете, просто взглянув на оператор. $total = Stotal + 1;//Прибавить кзначению единицу Лучше было бы объяснить, почему это было сделано.