Krasorion.ru

Упаковочные материалы

Стандарт оформления кода

Станда́рт оформле́ния ко́да или станда́рт коди́рования (англ. coding standards, coding convention или programming style) — набор правил и соглашений, используемых при написании исходного кода на некотором языке программирования.

Содержание

Применение

Стандарт оформления кода обычно принимается и используется некоторой группой разработчиков программного обеспечения для единообразного оформления совместно используемого кода. Целью принятия и использования стандарта является упрощение восприятия программного кода человеком, минимизация нагрузки на память и зрение при чтении программы.

Образцом для стандарта кодирования может стать набор соглашений, принятых в какой-либо распространённой печатной работе по языку (например, стандарт кодирования на языке Си, получивший сокращённое наименование K&R, происходит из классического описания Си его авторами — Кернинганом и Ричи), широко применяемая библиотека или API (так, на распространение венгерской нотации явно повлияло её использование в MS-DOS и Windows API, а большинство стандартов кодирования для Delphi используют, в той или иной мере, манеру кодирования библиотеки VCL). Реже разработчик языка выпускает подробные рекомендации по кодированию на нём; выпущены, например, стандарты кодирования на C# от Microsoft и на Java от Sun. Предложенная разработчиком или принятая в общеизвестных источниках манера кодирования в большей или меньшей степени дополняется и уточняется в корпоративных стандартах.

Состав

Стандарт сильно зависит от используемого языка программирования. Например, стандарт оформления кода для языка Си будет серьёзно отличаться от стандарта для языка BASIC. В целом, исходя из назначения стандарта, обычно он имеет целью добиться такого положения, когда программист достаточной квалификации мог бы дать заключение о функции, выполняемой конкретным участком кода, а в идеале — также определить его корректность, изучив только сам этот участок кода или, во всяком случае, минимально изучив другие части программы. Иными словами, смысл кода должен быть виден из самого кода, без необходимости изучать контекст. Поэтому стандарт кодирования обычно строится так, чтобы за счёт определённого визуального оформления элементов программы повысить информативность кода для человека.

Обычно, стандарт оформления кода описывает:

Вне стандарта подразумевается:

  • отсутствие магических чисел;
  • ограничение размера кода по горизонтали (чтобы помещался на экране, вплоть до 78 символов[1] для DOS-приложений) и вертикали (чтобы весь код файла держался в памяти), а также функции или метода в размер одного экрана.

Стандарты кодирования и синтаксис языков

Основные принципы распространённых стандартов кодирования в последнее время оказывают влияние на синтаксис вновь создаваемых языков программирования. В некоторых из них соглашения, ранее применявшиеся только в стандартах кодирования, становятся обязательными элементами синтаксиса. Так, в некоторых современных языках (Python, Nemerle) отступы влияют на логику исполнения (то есть блоки кода выделяются не ключевыми словами, а размером отступов), в других (Ruby) стали частью языка соглашения о регистре букв и префиксах для типов, констант, переменных и полей классов. В результате, если ранее недисциплинированный программист мог игнорировать стандарты кодирования из личных соображений, ради удобства или скорости написания кода, то теперь, при работе на новых языках, соблюдение стандартов в определённой мере контролируется транслятором.

См. также

Ссылки

  • Стандарты оформления кода языков программирования и всё что этого касается  (рус.). Проверено 10 июня 2010.
    • для языка Стандарт кодирования GNU.  (рус.). Проверено 10 июня 2010. [1] (англ.)
      • C++ Programming Style Guidelines  (англ.). Проверено 10 июня 2010.
    • для языка Стиль. // Автоматический контроль качества Java-кода  (рус.). Проверено 10 июня 2010.
      • Стандарт кодирования Java  (англ.)
    • для языка Стандарты оформления кода языков программирования и всё что этого касается  (рус.). Проверено 10 июня 2010.
    • для языка Соглашения по оформлению кода команды RSDN (рус.). — RSDN Magazine., 2003. — В. #1-2004.
    • для языка Стандарт стилевого оформления исходного кода DELPHI  (рус.). Королевство Delphi (05.06.2003). Проверено 10 июня 2010.
  • Голуб А. И. Веревка достаточной длины, чтобы... выстрелить себе в ногу (рус.) // Зацепин В. / перев. Зацепин В. ред. Базаров В.. — Москва, 2001. — С. 241 (Глава 3. Форматирование и документация 37-55 Глава 4. Имена и индификаторы 56-.
  • How To Write Unmaintainable Code  (англ.). Проверено 10 июня 2010.

Примечания

  1. Ширина экрана в DOS-режиме 80 символов.

Стандарт оформления кода.

© 2011–2023 krasorion.ru, Россия, Братск, ул. Ленинская 34, +7 (3953) 38-98-93