Интересно почитать

Интересно почитать

Как найти правильное количество комментариев

Но как найти золотую середину? Каков объем комментариев нужно размещать в скрипте?! Это зависит от множества факторов: например, времени, которое есть у вас, или сложности проекта и политики компании и т. п. Тем не менее, вам нужно усвоить некоторые основные принципы, которых следует придерживаться при написании программ:

Всегда комментируйте назначение функций перед их телом.

Оставляйте комментарии в сомнительных участках кода, если не уверены в его полной работоспособности.

Как комментировать коды

Если текст программы имеет плохую документацию, это означает что разработчик – эгоистичный программист.

При анализе такой программы, чтобы внести в нее улучшения, появится излишняя головная боль. Самодокументированный код среди программистов считается хорошим тоном, но мало кто из них пишет свои комментарии.

Необходимо избегать также и избыточных комментариев. Их тоже довольно таки редко встретишь, и они создают такую же проблему – плохо читаемый исходный код. Вот наглядный пример этому:

Следующая часть о printf()

Языки с отсутствием определения типа переменных дают большую гибкость при написании кода. Но, если вы неправильно используете семантику в большинстве функций PHP вы увидите сообщение о возникшей ошибке.

Вот кусок кода, открывающего файл и выводящего его построчно:<?php$fp = @fopen ( 'somefile. txt', 'r' )or die ( 'Не могу открыть файл somefile. txt' );

Функция что выводится с помощью printf()

Еще одна часто допускаемая ошибка – использование функции printf() для вывода значения, возвращаемого функцией, как здесь:<?phpprintf ("Найдено %d вхождений строки %s", count ($result), $search_term);?>Так же как и при использовании функции print() в тех же целях, необходимо воспользоваться оператором «.». В этом случае оператор прибавляет к результату вывода функции текст:

<?phpprint "Найдено " .count ($result) ." вхождений строки $search_term";?>

Когда можно использовать функцию printf()

Функция вызывается чаще всего в тех случаях, где нужно было использовать print(). В примере, приведенном ниже, функция printf() была использована для вывода 4-х переменных:

<?php$name = 'Sterling Hughes';$job = 'Senior Engineer';$company = 'DesignMultimedia';$email = 'email адрес';


Карта сайта


Информационный сайт Webavtocat.ru