Документация

Весь код должен соответствовать ISO^® 9899:1990 «Языки программирования - C», с поправками и исправлениями ISO/IEC 9899/COR1:1995, ISO/IEC 9899/AMD1:1995 и ISO/IEC 9899/COR2:1996.

Язык сборки должен быть инкапсулирован и изолирован.

Исходный код должен использовать только /* */ комментарии стиля.

Последовательность символов /* не должны использоваться в рамках комментария.

Все виды использования #pragma директива должна быть задокументирована и разъяснена.

Должны использоваться только те эвакуационные последовательности, которые определены в стандарте ISO C.

Триграфы не должны использоваться.

Идентификаторы (внутренние и внешние) не должны полагаться на значимость более 31 символа.

Идентификаторы во внутренних возможностях не должны использовать то же имя, что и идентификаторы во внешних возможностях, и поэтому скрывать этот идентификатор.

Имя typedef должно быть уникальным идентификатором.

Имя тега должно быть уникальным идентификатором.

Не следует повторно использовать идентификатор объекта или функции со статической длительностью хранения.

Ни один идентификатор в одном пространстве имен не должен иметь такой же орфографии, как идентификатор в другом пространстве имен, за исключением структуры и имен представителей объединения.

Имя идентификатора не должно использоваться повторно.

Обычный тип char должен использоваться только для хранения и использования значений символов.

Подписанный и беззнаковый тип char должен использоваться только для хранения и использования числовых значений.

typedefs, которые указывают на размер и сигнальность, должны использоваться вместо основных типов.

Битовые поля должны быть определены только для типа unsigned int или signed int.

Битовые поля типа signed int длина должна быть не менее 2 бит.

Восьмеричные константы (кроме нуля) и восьмеричные выходные последовательности не должны использоваться.

Функции должны иметь объявления прототипа, и прототип должен быть виден как при определении функции, так и при вызове.

Всякий раз, когда объект или функция объявлены или определены, его тип четко указывается.

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

Если объекты или функции объявлены более одного раза, их типы должны быть совместимыми.

В заголовочном файле не должно быть определений объектов или функций.

Функции должны всегда объявляться в возможностях файла.

Объекты должны быть определены в возможности, если они доступны только из одной функции.

Внешний объект или функция должны быть объявлены в одном файле и только в одном файле.

Идентификатор с внешним редактированием должен иметь только одно внешнее определение.

Все объявления и определения объектов или функций в объеме файла должны иметь внутреннее редактирование, если не требуется внешнее редактирование.

The static спецификатор класса памяти должен использоваться в определениях и объявлениях объектов и функций, имеющих внутреннее редактирование

Когда массив объявлен с внешним редактированием, его размер должен быть указан явным или неявным образом путем инициализации.

Скобки должны использоваться для указания и соответствия структуры в ненулевой инициализации массивов и структур.

В списке перечислителей = конструкция не должна использоваться для явной инициализации представителей, отличных от первой, если только все элементы не инициализированы явным образом.

Значение выражения целого типа не должно неявно преобразовываться в другой базовый тип, если:

Значение выражения плавающего типа не должно неявно преобразовываться в другой тип, если

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

Значение комплексного выражения типа с плавающей точкой может быть приведено только к более узкому плавающему типу.

Если побитовый оператор ~ и << применяются к операнду базового типа unsigned char или unsigned short, результат должен быть немедленно приведен к базовому типу операнда

Суффикс «U» применяется ко всем константам unsigned типы.

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

Преобразование не должно выполняться между указателем на объект и любым типом, отличным от интегрального типа, другим указателем на тип объекта или указателем на void.

Приведение не должно выполняться между типом указателя и интегральным типом.

Приведение не должно выполняться между указателем на тип объекта и другим указателем на тип объекта.

Отливка не должна выполняться, чтобы удалить какие-либо const или volatile проверка типа, адресованного указателем

Ограниченная зависимость должна быть помещена в выражения в правилах приоритета операторов С.

The sizeof оператор не должен использоваться в выражениях, содержащих побочные эффекты.

Операнды логического && или || должны быть первичными выражениями.

Операнды логических операторов (&&, || и !) должен быть эффективно логическим. Выражение, которое эффективно является логическим, не должно использоваться как операнды для операторов, отличных от (&&, || или !).

Битовые операторы не должны применяться к операторам, основной тип которых подписан.

Оператор унарного минуса не применяется к выражению, базовый тип которого не подписан.

Оператор запятыми не должен использоваться.

Оценка постоянного беззнакового выражения не должна приводить к обертыванию.

Базовые битовые представления значений с плавающей точкой не должны использоваться.

Шаг (++) и сокращение (--) операторы не должны смешиваться с другими операторами в выражении

Операторы назначения не должны использоваться в выражениях, которые дают логические значения.

Тесты значения против нуля должны быть сделаны явными, если операнд не является фактически логическим.

Выражения с плавающей точкой не должны проверяться на равенство или неравенство.

Управляющее выражение for оператор не должен содержать никаких объектов плавающего типа.

Три выражения for оператор должен касаться только управления циклом.

Числовые переменные, используемые в for цикл для подсчета итерации не должен изменяться в теле цикла.

Все операторы без нуля должны либо

The goto оператор не должно использоваться.

The continue оператор не должно использоваться.

Для любого оператора итерации должно быть самое большее одно break оператор, используемый для завершения цикла.

Функция должна иметь одну точку выхода в конце функции.

Оператор, образующее тело switch, while, do while или for Оператор должен быть составным оператором.

Система координат if (выражение) за конструкцией следует составной оператор. The else за ключевым словом следует либо составной оператор, либо другой if оператор.

Все if else if конструкции должны содержать окончательную else пункт.

Между switch обнаружен недостижимый код оператор и первый case.

A switch метка должна использоваться только в том случае, если самый близкий составной оператор является телом switch оператор

Безусловное break оператор прекращает действие каждого непустого switch пункт.

Окончательный пункт switch оператор должно быть default пункт.

A switch выражение не должно представлять значение, которое эффективно является логическим.

Каждый switch оператор должно иметь по крайней мере один case пункт.

Функции не должны определяться переменным числом аргументов.

Идентификаторы должны быть даны для всех параметров в объявлении прототипа функции.

Идентификаторы, используемые в объявлении и определении функции, должны быть идентичными.

Функции без параметров должны быть объявлены с типом параметра void.

Количество аргументов, переданных функции, должно совпадать с количеством параметров.

Все выходные пути из функции с не- void возвращаемый тип должен иметь явный оператор возврата с выражением.

Идентификатор функции должен использоваться только с предыдущим &, или со списком параметров в круглых скобках, который может быть пустым.

Индексация массива должна быть единственно допустимой формой арифметики указателя.

Тип не должен содержать более 2 уровней опосредования указателя.

Все типы конструкций или объединений должны быть завершены в конце модуля перевода.

Объединения не должны использоваться.

#include операторам в файле должны предшествовать только другие директивы или комментарии предварительной обработки.

Нестандартные символы не должны встречаться в именах заголовочных файлов в #include директивы.

The #include за директивой следует последовательность < filename > или «filename».

Макросы C должны расширяться только на инициализатор скобок, константу, выражение в круглых скобках, квалификатор типа, спецификатор класса памяти или конструкцию нуль.

Макросы не должны быть #defined и #undefd внутри блока.

#undef не должны использоваться.

Функция должна использоваться в выборе функции, подобной макросу.

Функциональный макрос не должен вызываться без всех его аргументов.

Аргументы в функциональный макрос не должны содержать лексемы, которые выглядят как директивы предварительной обработки.

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

Все идентификаторы макросов в директивах препроцессора должны быть определены перед использованием, кроме #ifdef и #ifndef директивы препроцессора и defined() оператор.

Должно быть самое большее одно вхождение # или ## операторы препроцессора в одной макро- определение.

The # и ## операторы предпроцессора не должны использоваться.

Определенный оператор препроцессора должен использоваться только в одной из двух стандартных форм.

Необходимо принять меры предосторожности, порядок предотвратить включение содержимого файла заголовка дважды.

Директивы предварительной обработки должны быть синтаксически значимыми, даже если исключены препроцессором.

Все #else, #elif и #endif директивы препроцессора должны находиться в том же файле, что и #if или #ifdef директива, с которой они связаны.

Зарезервированные идентификаторы, макросы и функции в стандартной библиотеке не должны быть определены, переопределены или неопределены.

Имена стандартных библиотечных макросов, объектов и функций не должны использоваться повторно.

Динамическое выделение памяти «куча» не должно использоваться.

Индикатор ошибки errno не должны использоваться.

Макрос offsetof, в библиотечных <stddef.h>, не должны использоваться.

The setjmp макрос и longjmp функция не должна использоваться.

Средства обработки сигналов <signal.h> не должны использоваться.

Библиотека ввода/вывода <stdio.h> не должны использоваться в производственном коде.

Библиотека функционирует atof, atoi и atoll из библиотечных <stdlib.h> не должны использоваться.

Библиотека функционирует abort, exit, getenv и system из библиотечных <stdlib.h> не должны использоваться.

Функции обработки времени библиотечных <time.h> не должны использоваться.

Программа не должна содержать нарушений стандартного синтаксиса C и ограничений и не должна превышать пределов перевода реализации.

Языковые расширения не должны использоваться.

Проект не должен содержать неиспользованных объявлений типов.

Проект не должен содержать неиспользованных объявлений тегов.

Проект не должен содержать неиспользованных объявлений макросов.

Функция не должна содержать неиспользованных объявлений меток.

В функциях не должно быть неиспользованных параметров.

Последовательности символов /* и // не должны использоваться в рамках комментария.

Сращивание линий не должно использоваться в // комментарии.

Восьмиугольные и шестнадцатеричные выходные последовательности должны быть прекращены.

Триграфы не должны использоваться.

Внешние идентификаторы должны быть отдельными.

Идентификаторы, объявленные в тех же возможностях и пространстве имен, должны быть различными.

Идентификатор, объявленный во внутренних возможностях, не должен скрывать идентификатор, объявленный во внешних возможностях.

Идентификаторы макросов должны быть различными.

Идентификаторы должны отличаться от макро- имен.

Имя typedef должно быть уникальным идентификатором.

Имя тега должно быть уникальным идентификатором.

Идентификаторы, определяющие объекты или функции с внешним редактированием, должны быть уникальными.

Идентификаторы, которые определяют объекты или функции с внутренним редактированием, должны быть уникальными.

Битовые поля должны быть объявлены только с соответствующим типом.

Однобитовые именованные битовые поля не должны иметь тип со знаком.

Восьмиугольные константы не должны использоваться.

Суффикс «u» или «U» применяется ко всем целочисленным константам, которые представлены в беззнаковом типе.

Строчный символ «l» не должен использоваться в буквальном суффиксе.

Строковый литерал не должен назначаться объекту, если только тип объекта не является «указателем на сертифицированный char».

Типы должны быть четко указаны.

Типы функций должны быть в форме прототипа с именованными параметрами.

Во всех объявлениях объекта или функции должны использоваться одинаковые имена и типы классификаторов.

Совместимое объявление должно быть видно, когда определен объект или функция с внешним редактированием.

Внешний объект или функция объявляются один раз в одном и только в одном файле.

Идентификатор с внешним редактированием должен иметь только одно внешнее определение.

Функции и объекты не должны определяться с помощью внешних редактирований, если они указаны только в одном модуле преобразования.

The static спецификатор класса памяти должен использоваться во всех декларациях объектов и функций, имеющих внутреннее редактирование.

Объект должен быть определен в возможности, если его идентификатор отображается только в одной функции.

Встроенная функция должна быть объявлена с static класс памяти.

Когда массив с внешним редактированием объявлен, его размер должен быть явно задан.

В список перечислителя значение неявно заданной постоянной перечисления должно быть уникальным.

The restrict классификатор типа не должен использоваться.

Инициализатор агрегата или объединения должен быть заключен в скобки.

Массивы не должны быть частично инициализированы.

Элемент объекта не должен быть инициализирован более одного раза.

Если для инициализации объекта массива используются назначенные инициализаторы, то размер массива должен задаваться явным образом.

Операнды не должны быть несоответствующего типа.

Выражения по существу типа символов не должны использоваться ненадлежащим образом в операциях сложения и вычитания.

Значение выражения не присваивается объекту с более узким существенным типом или другой категории существенного типа.

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

Значение выражения не должно быть приведено к неподходящему существенному типу.

Значение составного выражения не присваивается объекту с более широким существенным типом.

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

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

Преобразование не должно выполняться между указателем на функцию и любым другим типом.

Преобразование не должно выполняться между указателем на неполный тип и любым другим типом.

Приведение не должно выполняться между указателем на тип объекта и указателем на другой тип объекта.

Преобразование не должно выполняться между указателем на объект и целым типом.

Преобразование не должно выполняться из указателя в пустой в указатель на объект.

Приведение не должно выполняться между указателем на пустоту и арифметическим типом.

Приведение не должно выполняться между указателем на объект и нецелочисленным арифметическим типом.

Отливка не должна удалять какую-либо несовпадающую или летучую проверку из типа, на который указывает указатель.

Макрос NULL является единственно разрешенной формой целого числа нулевого указателя.

Приоритет операторов в выражениях должен быть явным.

Оператор запятыми не должен использоваться.

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

Полное выражение, содержащее шаг (++) или сокращение (--) оператор не должен иметь других потенциальных побочных эффектов, кроме тех, которые вызваны оператором шага или уменьшения.

Результат оператора назначения не должен использоваться.

Операнд sizeof оператор не должен содержать никаких выражений, которые имеют потенциальные побочные эффекты.

Управляющее выражение if оператор и управляющее выражение оператора итерации должны иметь по существу логический тип.

The goto оператор не должен использоваться.

The goto оператор должен перейти к метке, объявленной позже в той же функции.

Любая метка, на которую ссылается goto оператор должен быть объявлен в том же блоке или в любом блоке, заключающем в goto оператор.

Должно быть не более одного break или goto оператор используется для завершения любого оператора итерации.

Функция должна иметь одну точку выхода в конце

Тело итерации-оператора или селекции должно быть составным оператором.

Все if … else if конструкции должны быть завершены else оператор.

Все switch операторы должны быть хорошо сформированы.

A switch метка должна использоваться только в том случае, если самый близкий составной оператор является телом switch оператор.

Безусловное break оператор прекращает действие каждый switch- пункт.

Каждый switch оператор должно иметь default метка.

A default метка должна отображаться как первая или последняя switch метка switch оператор.

Каждый switch оператор должно иметь не менее двух switch- положения.

A switch-экспрессия не должна иметь по существу логического типа.

Область функций <starg.h> не должны использоваться.

Функция не должна объявляться неявно.

Все выходные пути из функции с не- void возвращаемый тип должен иметь явный оператор возврата с выражением.

Объявление параметра массива не должно содержать static ключевое слово между [ ].

Значение, возвращенное функцией, не имеющей void должен использоваться возвращаемый тип.

The +, -, += и -= операторы не должны применяться к выражению типа указателя.

Объявления должны содержать не более двух уровней вложенности указателей.

Гибкие представители массива не должны быть объявлены.

Типы массивов переменной длины не должны использоваться.

The union не следует использовать ключевое слово.

#include директивам должны предшествовать только директивы предпроцессора или комментарии.

The ', ", или \ символы и /* или // последовательности символов не должны находиться в имени файла заголовка.

The #include за директивой следует последовательность < filename > или\« filename\».

Макрос не должен быть определен с таким же именем, как ключевое слово.

#undef не следует использовать.

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

Выражения, вытекающие из расширения макро- параметры, заключаются в круглые скобки.

Управляющее выражение #if или #elif директива о предварительной обработке должна быть оценена как 0 или 1.

Все идентификаторы, используемые в управляющем выражении #if или #elif директивы предварительной обработки должны быть #defineдо оценки.

The # и ## операторы предпроцессора не должны использоваться.

Параметр макроса, непосредственно следующий за # оператор не должен немедленно сопровождаться ## оператор.

Параметр макроса, используемый в качестве операнда к # или ## операторы, которые сами подлежат дальнейшей замене макросами, должны использоваться только в качестве операнда этим операторам.

A линии, чья первая лексема # является действительной директивой предварительной обработки.

Все #else, #elif и #endif директивы препроцессора должны находиться в том же файле, что и #if, #ifdef или #ifndef директива, с которой они связаны.

#define и #undef не должен использоваться в зарезервированном идентификаторе или зарезервированном имени макроса.

Зарезервированный идентификатор или имя макроса не должны объявляться.

Функции выделения и отмены выделения памяти <stdlib.h> не должны использоваться.

Стандартный файл заголовка <setjmp.h> не должны использоваться.

Стандартный файл заголовка <signal.h> не должны использоваться.

Входные/выходные функции Стандартной библиотеки не должны использоваться.

The atof, atoi, atol, и atoll функции <stdlib.h> не должны использоваться.

Библиотека функционирует abort, exit, getenv и system от <stdlib.h> не должны использоваться.

Библиотека функционирует bsearch и qsort от <stdlib.h> не должны использоваться.

Функции «Стандартное время и дата библиотеки» не должны использоваться.

Стандартный файл заголовка <tgmath.h> не должны использоваться.

Особые функции обработки исключений <fenv.h> не следует использовать.