Відмінності між версіями «5 Коментарі»
Donserg (Обговорення • внесок) м (Захист на 5 Коментарі встановлено ([edit=sysop] (безстроково) [move=sysop] (безстроково))) |
Xphlash (Обговорення • внесок) |
||
| (4 проміжні версії 3 користувачів не показані) | |||
| Рядок 1: | Рядок 1: | ||
| − | Коментарі | + | Коментарі - пояснення до початкового тексту програми, що знаходяться безпосередньо усередині коментованого коду. Синтаксис коментарів визначається мовою програмування. З точки зору компілятора або інтерпретатора, коментарі - частина тексту програми, що не впливає на її семантику. Коментарі не мають жодного впливу на результат компіляції програми або її інтерпретацію. Крім вихідних текстів програм, коментарі також застосовуються в мовах розмітки та мовах опису. |
| − | + | Більшість фахівців сходяться на думці, що коментарі повинні пояснювати наміри програміста, а не код; те, що можна виразити мовою програмування, не повинно виноситися в коментарі. Зокрема необхідно розбивати програму на легкі для розуміння частини, прагнути до того, щоб структура класів і структура баз даних були максимально зрозумілими і прозорими. Є навіть думка (його дотримуються в екстремальному програмуванні та деяких інших гнучких методологіях програмування), що якщо для розуміння програми потрібні коментарі - значить, вона погано написана. | |
| − | + | Концепція грамотного програмування наполягає на включення в текст програми настільки докладних і продуманих коментарів, щоб вона стала вихідним текстом не тільки для виконуваного коду, але і для супровідної документації. Коментарі в PHP можуть бути як однорядкові так і багаторядкові. Однорядкові коментарі починаються із "//" або "#" (коментар скриптових мов UNIX). Багаторядкові коментарі починаються символами "/*" і закінчуються "*/" (без лапок). Слід зазначити, що однорядкові коментарі йдуть до кінця поточного рядка або завершального тега. | |
| + | Нижче наведений приклад скрипта із різними видами коментарів: | ||
| − | <?php | + | <?php |
| − | + | echo "Це тест" ; // Це однорядковий коментар в стилі C++ | |
| − | + | /* Це багаторядковий коментар | |
| − | + | ще один рядок коментарю */ | |
| − | + | echo "Це ще один тест" ; | |
| − | + | echo "Останній тест" ; #Це коментар в стилі оболонки Unix | |
| − | ?> | + | ?> |
| − | + | ||
| + | Не можна вкладати один в одний багаторядкові коментарі (вони можуть з’явитися під час коментування великих блоків). Наприклад: | ||
| − | + | <?php | |
| − | + | /* | |
| − | + | echo "Це тест"; /* Цей коментар викличе проблему */ | |
| + | */ | ||
| + | ?> | ||
| − | + | Однорядкові коментарі йдуть тільки до кінця рядка або поточного блоку PHP-коду, в залежності від того, що йде перед ними. Це означає, що HTML-код після "//?>" не буде сприйматись інтерпретатором PHP в якості закінчення коду, як це, можливо, очікувалось від "?>", тому що всі символи до кінця рядка, що йдуть після "//", вважаються коментарем. | |
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | Однорядкові коментарі йдуть тільки до кінця рядка або поточного блоку PHP-коду, в залежності від того, що йде перед ними. Це означає, що HTML-код після //?> не буде сприйматись інтерпретатором PHP в якості закінчення коду, як це, можливо, очікувалось від ?>, тому що // | + | |
Поточна версія на 02:01, 20 червня 2014
Коментарі - пояснення до початкового тексту програми, що знаходяться безпосередньо усередині коментованого коду. Синтаксис коментарів визначається мовою програмування. З точки зору компілятора або інтерпретатора, коментарі - частина тексту програми, що не впливає на її семантику. Коментарі не мають жодного впливу на результат компіляції програми або її інтерпретацію. Крім вихідних текстів програм, коментарі також застосовуються в мовах розмітки та мовах опису. Більшість фахівців сходяться на думці, що коментарі повинні пояснювати наміри програміста, а не код; те, що можна виразити мовою програмування, не повинно виноситися в коментарі. Зокрема необхідно розбивати програму на легкі для розуміння частини, прагнути до того, щоб структура класів і структура баз даних були максимально зрозумілими і прозорими. Є навіть думка (його дотримуються в екстремальному програмуванні та деяких інших гнучких методологіях програмування), що якщо для розуміння програми потрібні коментарі - значить, вона погано написана. Концепція грамотного програмування наполягає на включення в текст програми настільки докладних і продуманих коментарів, щоб вона стала вихідним текстом не тільки для виконуваного коду, але і для супровідної документації. Коментарі в PHP можуть бути як однорядкові так і багаторядкові. Однорядкові коментарі починаються із "//" або "#" (коментар скриптових мов UNIX). Багаторядкові коментарі починаються символами "/*" і закінчуються "*/" (без лапок). Слід зазначити, що однорядкові коментарі йдуть до кінця поточного рядка або завершального тега. Нижче наведений приклад скрипта із різними видами коментарів:
<?php
echo "Це тест" ; // Це однорядковий коментар в стилі C++
/* Це багаторядковий коментар
ще один рядок коментарю */
echo "Це ще один тест" ;
echo "Останній тест" ; #Це коментар в стилі оболонки Unix
?>
Не можна вкладати один в одний багаторядкові коментарі (вони можуть з’явитися під час коментування великих блоків). Наприклад:
<?php /* echo "Це тест"; /* Цей коментар викличе проблему */ */ ?>
Однорядкові коментарі йдуть тільки до кінця рядка або поточного блоку PHP-коду, в залежності від того, що йде перед ними. Це означає, що HTML-код після "//?>" не буде сприйматись інтерпретатором PHP в якості закінчення коду, як це, можливо, очікувалось від "?>", тому що всі символи до кінця рядка, що йдуть після "//", вважаються коментарем.
