indent - Интернет в облаке

ПРОГРАММА:

ИМЯ

indent - изменяет внешний вид программы C, вставляя или удаляя пробелы.

СИНТАКСИС

Отступ [опции] [входные файлы]

Отступ [параметры] [один-входной-файл] [-o выходной-файл]

Отступ --версия

ОПИСАНИЕ

Эта страница руководства создается из файла отступ.texinfo. Это издание "The Отступ
Руководство "для версии с отступом, последнее обновление.

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

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

В версии 1.2 и более поздних версиях по умолчанию используется стиль отступов GNU.

ДОПОЛНИТЕЛЬНЫЕ УСЛУГИ, НЕ ВКЛЮЧЕННЫЕ В ПАКЕТ

-Плохо, --blank-lines-after-декларации
Вставить пустые строки после объявлений.
Читать ПУСТО ЛИНИИ.

-бап, --blank-lines-after-Procedures
Вставить пустые строки после тела процедуры.
Читать ПУСТО ЛИНИИ.

-ббб, --blank-lines-before-block-comments
Вставить пустые строки перед блочными комментариями.
Читать ПУСТО ЛИНИИ.

-ббо, --break-before-boolean-operator
Предпочитайте разрывать длинные строки перед логическими операторами.
Читать НАША ДЛИННЫЙ ЛИНИИ.

-до н.э, --пустые строки-после-запятой
Установить новую строку после запятой в объявлении.
Читать ЗАЯВЛЕНИЯ.

-бл, - скобки после строки
Ставьте фигурные скобки на линию после if, и т.д.
Читать ОТЧЕТНОСТЬ.

-блф, --braces-after-func-def-line
Поместите фигурные скобки в строку, следующую за строкой определения функции.
Читать ЗАЯВЛЕНИЯ.

-блиn, - скобка-отступn
Отступы скобок n пространства.
Читать ОТЧЕТНОСТЬ.

-bls, --braces-after-struct-decl-line
Ставьте фигурные скобки на линию после структура строки объявления.
Читать ЗАЯВЛЕНИЯ.

-бр, - скобки на линии
Поставьте брекеты на if, и т.д.
Читать ОТЧЕТНОСТЬ.

-брф, --braces-on-func-def-line
Поставьте фигурные скобки на строку определения функции.
Читать ЗАЯВЛЕНИЯ.

-brs, --braces-on-struct-decl-line
Наденьте брекеты структура строка объявления.
Читать ЗАЯВЛЕНИЯ.

-бс, - Билл-Шеннон, --blank-before-sizeof
Поместите пробел между размер и его аргумент.
Читать ОТЧЕТНОСТЬ.

-cn, --comment-отступn
Поместите комментарии справа от кода в столбец n.
Читать КОММЕНТАРИИ.

-cbin, --case-brace-отступn
Отступить фигурные скобки после метки регистра на N пробелов.
Читать ОТЧЕТНОСТЬ.

-CDn, --declaration-comment-столбецn
Поместите комментарии справа от объявлений в столбце n.
Читать КОММЕНТАРИИ.

-cdb, --comment-delimiters-на-пустых-строках
Поместите разделители комментариев в пустые строки.
Читать КОММЕНТАРИИ.

-cdw, --обниматься-делать-пока
Обниматься пока do {} пока; и предшествующий '}'.
Читать КОММЕНТАРИИ.

-это, --обниматься-еще
Cuddle else и предшествующий символ "}".
Читать КОММЕНТАРИИ.

-этотn, - продолжение-отступn
Продолжение отступа n пространства.
Читать ОТЧЕТНОСТЬ.

-клиn, --case-отступn
Отступ метки регистра n пространства.
Читать ОТЧЕТНОСТЬ.

-срn, --else-endif-столбецn
Поместите комментарии справа от #еще и #endif заявления в столбце n.
Читать КОММЕНТАРИИ.

-cs, --space-после приведения
Поставьте пробел после оператора приведения.
Читать ОТЧЕТНОСТЬ.

-dn, - строка-комментарии-отступn
Установите отступ комментариев не справа от кода, чтобы n пространства.
Читать КОММЕНТАРИИ.

-БФДА, --break-функция-объявление-аргументы
Разорвать строку перед всеми аргументами в объявлении.
Читать ЗАЯВЛЕНИЯ.

-бфде, --break-функция-объявление-аргументы-конец
Разорвать строку после последнего аргумента в объявлении.
Читать ЗАЯВЛЕНИЯ.

-DJ, --left-justify-декларации
Если используется -cd 0, то комментарии после объявлений оставляются по ширине после
декларация.
Читать ЗАЯВЛЕНИЯ.

-dun, - декларация-отступn
Поместите переменные в столбец n.
Читать ЗАЯВЛЕНИЯ.

-fc1, --format-first-column-комментарии
Отформатируйте комментарии в первом столбце.
Читать КОММЕНТАРИИ.

-фка, --формат-все-комментарии
Не отключайте все форматирование комментариев.
Читать КОММЕНТАРИИ.

-гну, --gnu-стиль
Используйте стиль кодирования GNU. Это значение по умолчанию.
Читать ОБЩИЙ СТИЛИ.

-hnl, --чести-новые строки
Предпочитайте разрывать длинные строки в позиции новой строки во вводе.
Читать НАША ДЛИННЫЙ ЛИНИИ.

-in, --индент-уровеньn
Установите уровень отступа на n пространства.
Читать УКАЗАНИЕ.

-Онn, --indent-меткаn
Установить смещение меток к столбцу n.
Читать УКАЗАНИЕ.

-ipn, - параметр-отступn
Типы параметров отступа в определениях функций в старом стиле n пространства.
Читать УКАЗАНИЕ.

-кр, --k-and-r-стиль
Используйте стиль кодирования Керниган и Ричи.
Читать ОБЩИЙ СТИЛИ.

-ln, - длина линииn
Установите максимальную длину строки для строк без комментариев равной n.
Читать НАША ДЛИННЫЙ ЛИНИИ.

-lcn, --comment-длина строкиn
Установите максимальную длину строки для форматирования комментария равной n.
Читать КОММЕНТАРИИ.

-линукс, - в стиле linux
Используйте стиль кодирования Linux.
Читать ОБЩИЙ СТИЛИ.

-лп, - продолжение в круглых скобках
Выровняйте продолженные строки в круглых скобках.
Читать УКАЗАНИЕ.

-лпс, --leave-препроцессор-пространство
Оставьте пробел между '#' и директивой препроцессора.
Читать УКАЗАНИЕ.

-нбад, --no-blank-lines-after-декларации
Не вставляйте пустые строки после объявлений.
Читать ПУСТО ЛИНИИ.

-нбап, --no-blank-lines-after-Procedures
Не вставляйте пустые строки после тела процедуры.
Читать ПУСТО ЛИНИИ.

-нббо, --break-after-boolean-operator
Не стоит прерывать длинные строки перед логическими операторами.
Читать НАША ДЛИННЫЙ ЛИНИИ.

-nbc, --нет-пустых-строк-после-запятых
Не вставляйте символы новой строки после запятых в объявлениях.
Читать ЗАЯВЛЕНИЯ.

-нбфда, --dont-break-function-decl-args
Не помещайте каждый аргумент в объявлении функции в отдельной строке.
Читать ЗАЯВЛЕНИЯ.

-ncdb, --no-comment-разделители-в-пустых строках
Не ставьте разделители комментариев на пустые строки.
Читать КОММЕНТАРИИ.

-ncdw, --не-обниматься-делать-пока
Не обниматься } и в то время как в А do {} пока;.
Читать ОТЧЕТНОСТЬ.

-сюда, --не-обниматься-иначе
Не обниматься } и еще.
Читать ОТЧЕТНОСТЬ.

-ncs, --no-space-after-castts
Не ставьте пробел после операторов приведения.
Читать ОТЧЕТНОСТЬ.

-нджn, --dont-left-justify-декларации
Комментарии после объявлений обрабатываются так же, как комментарии после других утверждений.
Читать ЗАЯВЛЕНИЯ.

-nfc1, --dont-format-first-column-comments
Не форматируйте комментарии в первом столбце как обычно.
Читать КОММЕНТАРИИ.

-нфка, --не форматировать комментарии
Не форматируйте комментарии.
Читать КОММЕНТАРИИ.

-ннл, --игнорировать новые строки
Не предпочитайте разрыв длинных строк в позиции новой строки во вводе.
Читать НАША ДЛИННЫЙ ЛИНИИ.

-Нип, --no-параметр-indentation
Отступ нулевой ширины для параметров.
Читать УКАЗАНИЕ.

-нлп, --dont-line-up-скобки
Не ставьте скобки в ряд.
Читать ОТЧЕТНОСТЬ.

-НПС, --no-space-after-function-callnames
Не ставьте пробел после функции в вызовах функций.
Читать ОТЧЕТНОСТЬ.

-нпрс, --no-space-after-скобки
Не ставьте пробел после каждого "(" и перед каждым ")".
Читать ОТЧЕТНОСТЬ.

-нпсл, --dont-break-процедура-тип
Поместите тип процедуры в ту же строку, что и ее имя.
Читать ЗАЯВЛЕНИЯ.

-нсаф, --без пробела-после-для
Не ставьте пробел после каждого для.
Читать ОТЧЕТНОСТЬ.

-нсай, --без пробела после-если
Не ставьте пробел после каждого if.
Читать ОТЧЕТНОСТЬ.

-пила, --no-space-после-время
Не ставьте пробел после каждого в то время как.
Читать ОТЧЕТНОСТЬ.

-нск, --dont-star-комментарии
Не ставьте символ «*» слева от комментариев.
Читать КОММЕНТАРИИ.

-ноб, --leave-необязательные-пустые-строки
Не проглатывайте необязательные пустые строки.
Читать ПУСТО ЛИНИИ.

-нсс, --dont-space-special-точка с запятой
Не ставьте пробел перед точкой с запятой после некоторых утверждений. Отключает -ss.
Читать ОТЧЕТНОСТЬ.

-орех, --без вкладок
Используйте пробелы вместо табуляции.
Читать УКАЗАНИЕ.

-nv, - многословие
Отключить подробный режим.
Читать РАЗНОЕ ДОПОЛНИТЕЛЬНЫЕ УСЛУГИ, НЕ ВКЛЮЧЕННЫЕ В ПАКЕТ.

-ориг, --оригинальный
Используйте оригинальный стиль кодирования Беркли.
Читать ОБЩИЙ СТИЛИ.

-нпро, --игнорировать-профиль
Не читайте файлы '.indent.pro'.
Читать ВЫЗОВ УДАЛЕНИЕ.

-шт, - пробел-после-процедур-вызовов
Вставьте пробел между именем вызываемой процедуры и символом '('.
Читать ОТЧЕТНОСТЬ.

-число Пиn, --paren-отступn
Укажите дополнительный отступ для открытых круглых скобок '(', когда оператор не работает.
ОТЧЕТНОСТЬ.

-pmt, --preserve-mtime
Сохраните время доступа и модификации для выходных файлов. РАЗНОЕ ДОПОЛНИТЕЛЬНЫЕ УСЛУГИ, НЕ ВКЛЮЧЕННЫЕ В ПАКЕТ.

-ppin, - препроцессор-отступn
Укажите отступ для условных операторов препроцессора. УКАЗАНИЕ.

-прс, - пробел после круглых скобок
Ставьте пробел после каждого "(" и перед каждым ")".
Читать ОТЧЕТНОСТЬ.

-псл, --procnames-start-lines
Укажите тип процедуры в строке перед ее названием.
Читать ЗАЯВЛЕНИЯ.

-саф, --пробел-после-для
Ставьте пробел после каждого для.
Читать ОТЧЕТНОСТЬ.

-сай, - пробел-после-если
Ставьте пробел после каждого if.
Читать ОТЧЕТНОСТЬ.

-пила, --space-после-в то время как
Ставьте пробел после каждого в то время как.
Читать ОТЧЕТНОСТЬ.

-сбиn, --struct-brace-отступn
Отступы фигурных скобок структуры, объединения или перечисления N пробелов.
Читать ОТЧЕТНОСТЬ.

-SC, --start-left-side-of-комментарии
Поместите символ '*' слева от комментариев.
Читать КОММЕНТАРИИ.

-соб, --swallow-необязательные пустые строки
Проглатывайте необязательные пустые строки.
Читать ПУСТО ЛИНИИ.

-ss, --специальная точка с запятой
В одну строку для и в то время как операторы, поставьте пробел перед точкой с запятой.
Читать ОТЧЕТНОСТЬ.

-st, - стандартный вывод
Пишите на стандартный вывод.
Читать ВЫЗОВ УДАЛЕНИЕ.

-T Сказать Отступ название typenames.
Читать ЗАЯВЛЕНИЯ.

-TSn, - размер вкладкиn
Установите размер табуляции на n пространства.
Читать УКАЗАНИЕ.

-ут, --use-вкладки
Используйте вкладки. Это значение по умолчанию.
Читать УКАЗАНИЕ.

-v, --подробный
Включить подробный режим.
Читать РАЗНОЕ ДОПОЛНИТЕЛЬНЫЕ УСЛУГИ, НЕ ВКЛЮЧЕННЫЕ В ПАКЕТ.

-версия
Выведите номер версии Отступ.
Читать РАЗНОЕ ДОПОЛНИТЕЛЬНЫЕ УСЛУГИ, НЕ ВКЛЮЧЕННЫЕ В ПАКЕТ.

ВЫЗОВ УДАЛЕНИЕ

Начиная с версии 1.3, формат файла Отступ команда является:

отступ [кредита] [входные файлы]

отступ [кредита] [файл с одним входом] [-о выходной файл]

Этот формат отличается от более ранних версий и других версий Отступ.

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

Во второй форме указан только один входной файл. В этом случае, или когда стандарт
input, вы можете указать выходной файл после опции '-o'.

Вызывать Отступ для записи в стандартный вывод используйте параметр -st. Это разрешено только
когда есть только один входной файл или когда используется стандартный ввод.

Если ни один из файлов ввода не назван, стандартный ввод читается для ввода. Также, если имя файла
с именем '-', затем читается стандартный ввод.

Например, каждая из следующих команд вводит программу slithy_toves.c и
напишите его текст с отступом в slithy_toves.out:

отступ slithy_toves.c -o slithy_toves.out

отступ -st slithy_toves.c> slithy_toves.out

кот slithy_toves.c | отступ -o slithy_toves.out

Большинство других вариантов Отступ контролировать форматирование программ. Начиная с версии 1.2,
Отступ также распознает длинное имя для каждого имени опции. Длинные варианты начинаются с префикса
либо "-", либо "+". ["+" заменяется на "-" для согласования с
Стандарт POSIX.]
В большей части этого документа для краткости используются традиционные короткие имена.
Читать ВАРИАНТ РЕЗЮМЕ, для получения списка параметров, включая как длинные, так и короткие имена.

Вот еще один пример:

отступ -br тест / метаболизм.c -l85

Это приведет к отступу программы test / метаболизм.c с использованием параметров -br и -l85, напишите
вывод обратно в 'test / Metabism.c' и записать исходное содержимое
'test / Metabism.c' в файл резервной копии в каталоге 'test'.

Эквивалентные вызовы с использованием длинных имен опций для этого примера будут:

indent --braces-on-if-line --line-length185 test / Metabism.c

отступ + фигурные скобки на строке + длина строки185 test / Metabism.c

Если вы обнаружите, что часто используете Отступ с теми же параметрами, вы можете поместить эти параметры
в файл с именем '.indent.pro'. Отступ будет искать файл профиля в трех местах.
Сначала он проверит переменную окружения INDENT_PROFILE. Если он существует, его значение
ожидается имя файла, который будет использоваться. Если переменная среды не существует,
indent ищет '.indent.pro' в текущем каталоге
и используйте это, если найдете. Ну наконец то Отступ будет искать в вашем домашнем каталоге '.indent.pro'
и используйте этот файл, если он найден. Это поведение отличается от поведения других версий.
of Отступ, которые загружают оба файла, если они оба существуют.

Формат '.indent.pro' - это просто список параметров, как если бы они отображались на
командная строка, разделенная пробелом (табуляция, пробелы и символы новой строки). Параметры в
'.indent.pro' может быть окружен комментариями C или C ++, и в этом случае они игнорируются.

Переключатели командной строки обрабатываются после обработка '.indent.pro'. Опции уточняются позже
переопределить аргументы, указанные ранее, за одним исключением: явно указанные параметры
всегда переопределять параметры фона (см. ОБЩИЙ СТИЛИ). Вы можете предотвратить Отступ от
чтение файла '.indent.pro', указав параметр '-npro'.

BACKUP FILES

Начиная с версии 1.3, GNU Отступ создает файлы резервных копий в стиле GNU, точно так же, как это делает GNU Emacs.
Это означает, что либо декриминализовано or нумерованный могут быть созданы резервные копии имен файлов.

Простые имена файлов резервных копий создаются путем добавления суффикса к исходному имени файла.
По умолчанию для этого суффикса используется односимвольная строка «~» (тильда). Таким образом, резервная копия
файл для 'python.c' будет 'python.c ~'.

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

Нумерованные резервные версии файла momeraths.c выглядят как momeraths.c. ~ 23 ~, где 23 - это
версия этой конкретной резервной копии. При создании нумерованной резервной копии файла
'src / momeraths.c', файл резервной копии будет называться 'src / momeraths.c. ~V~ ', где V один
выше, чем самая высокая версия, существующая в настоящее время в каталоге src. В
переменная среды VERSION_WIDTH контролирует количество цифр, используя левый нулевой отступ
когда необходимо. Например, установка этой переменной на "2" приведет к резервному файлу.
назван "momeraths.c. ~ 04 ~".

Тип файла резервной копии определяется значением переменной среды.
КОНТРОЛЬ ВЕРСИЙ. Если это строка «простой», то будут созданы только простые резервные копии. Если
его значение - строка «пронумерованная», тогда будут созданы нумерованные резервные копии. Если его значение
'пронумерованные-существующие', то будут созданы пронумерованные резервные копии, если есть уже существовать нумерованный
резервные копии файла с отступом; в противном случае создается простая резервная копия. Если
КОНТРОЛЬ ВЕРСИЙ не установлен, то Отступ предполагает поведение «пронумерованное существующее».

Другие версии Отступ используйте суффикс '.BAK' в именах файлов резервных копий. Такое поведение может
подражать, установив SIMPLE_BACKUP_SUFFIX в '.BAK'.

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

ОБЩИЙ СТИЛИ

Существует несколько общих стилей кода C, включая стиль GNU, стиль Kernighan &
Стиль Ричи и оригинальный стиль Беркли. Стиль можно выбрать с помощью одного
фон option, который определяет набор значений для всех остальных параметров. Тем не мение,
явно указанные параметры всегда переопределяют параметры, подразумеваемые фоновым параметром.

Начиная с версии 1.2, стиль GNU по умолчанию Отступ это стиль GNU. Таким образом, нет
дольше необходимо указать параметр '-gnu' для получения этого формата, хотя при этом
не вызовет ошибки. Настройки опций, соответствующие стилю GNU, следующие:

-nbad -bap -nbc -bbo -bl -bli2 -bls -ncdb -nce -cp1 -cs -di2
-ndj -nfc1 -nfca -hnl -i2 -ip5 -lp -pcs -nprs -psl -saf -sai
-пила -nsc -nsob

Стиль кодирования GNU предпочтителен для проекта GNU. Это стиль, в котором GNU
Режим Emacs C поощряет и используется в частях GNU Emacs на C. (Люди
заинтересованные в написании программ для Project GNU должны получить копию "The GNU Coding
Стандарты », который также охватывает вопросы семантики и переносимости, такие как использование памяти,
размер целых чисел и т. д.)

Стиль Керниган и Ричи используется в их известной книге "Программирование на языке Си".
Язык ". Он включается с помощью опции '-kr'. Стиль Керниган и Ричи
соответствует следующему набору опций:

-nbad -bap -bbo -nbc -br -brs -c33 -cd33 -ncdb -ce -ci4 -cli0
-cp33 -cs -d0 -di1 -nfc1 -nfca -hnl -i4 -ip0 -l75 -lp -npcs
-nprs -npsl -saf -sai -saw -nsc -nsob -nss

Стиль Kernighan & Ritchie не помещает комментарии справа от кода в тот же столбец на
все время (при этом не используется только один пробел справа от кода), поэтому для этого стиля
Отступ произвольно выбрал столбец 33.

Стиль оригинального Беркли Отступ можно получить, указав '-orig' (или
указав '--original', используя длинное имя параметра). Этот стиль эквивалентен
следующие настройки:

-nbad -nbap -bbo -bc -br -brs -c33 -cd33 -cdb -ce -ci4 -cli0
-cp33 -di16 -fc1 -fca -hnl -i4 -ip4 -l75 -lp -npcs -nprs -psl
-saf -sai -saw -sc -nsob -nss -ts8

Стиль Linux используется в коде ядра и драйверах Linux. Код обычно должен следовать
стиль кодирования Linux должен быть принят. Этот стиль эквивалентен следующему
параметры:

-nbad -bap -nbc -bbo -hnl -br -brs -c33 -cd33 -ncdb -ce -ci4
-cli0 -d0 -di1 -nfc1 -i8 -ip0 -l80 -lp -npcs -nprs -npsl -sai
-saf -saw -ncs -nsc -sob -nfca -cp33 -ss -ts8 -il1

ПУСТО ЛИНИИ

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

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

Опция '-bap' заставляет пустую строку после каждого тела процедуры. Параметр -nbap
не заставляет такую ​​пустую строку.

Параметр '-bbb' заставляет вставлять пустую строку перед каждым комментарием в рамке (см. КОММЕНТАРИИ.)
Параметр '-nbbb' не заставляет такие пустые строки.

Параметр '-sob' вызывает Отступ проглатывать необязательные пустые строки (то есть любые необязательные
пустые строки, присутствующие на входе, будут удалены из вывода). Если "-nsob"
указано, любые пустые строки, присутствующие во входном файле, будут скопированы в выходной файл.

--blank-lines-after-декларации

Параметр '-bad' заставляет пустую строку после каждого блока объявлений. '-Nbad'
опция не добавляет таких пустых строк.

Например, учитывая ввод
char * foo;
char * bar;
/ * Это разделяет блоки объявлений. * /
инт баз;

Отступ -Плохо производит

char * foo;
char * bar;

/ * Это разделяет блоки объявлений. * /
инт баз;

и Отступ -нбад производит

char * foo;
char * bar;
/ * Это разделяет блоки объявлений. * /
инт баз;

--blank-lines-after-Procedures

Опция '-bap' заставляет пустую строку после каждого тела процедуры.

Например, учитывая ввод

Int
фу ()
{
кладет ("Привет");
}
/ * Панель процедур еще менее интересна. * /
символ *
бар ()
{
кладет ("Привет");
}

Отступ -бап производит

Int
фу ()
{
кладет ("Привет");
}

/ * Панель процедур еще менее интересна. * /
символ *
бар ()
{
кладет ("Привет");
}

и Отступ -нбап производит

Int
фу ()
{
кладет ("Привет");
}
/ * Панель процедур еще менее интересна. * /
символ *
бар ()
{
кладет ("Привет");
}

После процедуры пустая строка не добавляется. Foo.

КОММЕНТАРИИ

Отступ форматирует комментарии C и C ++. Комментарии C начинаются с '/ *', оканчиваются на
'* /' и может содержать символы новой строки. Комментарии C ++ начинаются с разделителя '//' и
заканчиваются новой строкой.

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

Отступ далее различает комментарии, найденные вне процедур и агрегатов,
и те, что находятся внутри них. В частности, комментарии, начинающиеся со строки, найденной внутри
процедура будет с отступом к столбцу, в котором код в настоящее время имеет отступ. В
Исключением является комментарий, начинающийся в крайнем левом столбце; такой комментарий выводится
в этом столбце.

Отступ попытки уйти в коробке Комментарии немодифицированный. Общая идея такого комментария такова:
что он заключен в прямоугольник или «коробку» из звезд или тире, чтобы визуально выделить его.
Точнее, комментарии в рамке определяются как комментарии, в которых следует начальный символ '/ *'.
сразу символом '*', '=', '_' или '-', или теми, в которых начало
разделитель комментариев ('/ *') находится в отдельной строке, а следующая строка начинается с '*'
в том же столбце, что и звезда открывающего ограничителя.

Примеры заключенных в рамку комментариев:

/ **********************
* Комментарий в рамке !! *
********************** /

/*
* Другой аромат,
* для другого комментария.
*/

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

Если указана опция '-bbb', всем таким комментариям в рамке будет предшествовать пробел.
строка, если такому комментарию не предшествует код.

Комментарии, которые не помещены в рамку, могут быть отформатированы, что означает, что строка
разорванный, чтобы поместиться в правое поле, и заполненный пробелом слева. Одиночные символы новой строки
эквивалент пробела, но пустые строки (две или более новой строки в строке) означают
разрыв абзаца. Форматирование комментариев, которые начинаются после включения первого столбца
с опцией -fca. Чтобы отформатировать те, которые начинаются в первом столбце, укажите «-fc1». Такой
форматирование по умолчанию отключено.

Правое поле для форматирования по умолчанию - 78, но его можно изменить с помощью опции '-lc'.
Если указанное поле не позволяет напечатать комментарий, поле будет
автоматически продлевается на время этого комментария. Маржа не соблюдается, если
комментарий не форматируется.

Если комментарий начинает строку (т.е. слева от него нет текста программы), он будет
с отступом к столбцу, в котором он был найден, если только комментарий не находится в блоке кода. В
в этом случае такой комментарий будет выровнен с кодом этого блока с отступом (если только
комментарий начался в первой колонке). На это выравнивание может повлиять опция '-d',
который определяет количество, на которое такие комментарии перемещаются в оставил, или без отступов.
Например, "-d2" помещает комментарии двумя пробелами слева от кода. По умолчанию комментарии
выровнены с кодом, если они не начинаются в первом столбце, и в этом случае они остаются
там по умолчанию --- чтобы привести их в соответствие с кодом, укажите '-fc1'.

Комментарии справа от кода появятся по умолчанию в столбце 33. Это можно изменить.
с одним из трех вариантов. '-c' будет указывать столбец для комментариев после кода,
'-cd' указывает столбец для комментариев после объявлений, а '-cp' указывает
столбец для комментариев после директив препроцессора #еще и #endif. '-dj' вместе
с '-cd0' может использоваться для подавления выравнивания комментариев справа от объявлений,
заставляя комментарий следовать одной позиции табуляции от конца объявления. Обычно '-cd0'
заставляет '-c' вступить в силу.

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

Параметр '-cdb' помещает разделители комментариев в пустые строки. Таким образом, одна строка
комментарий как /* Любящий обнимать */ можно преобразовать в:

/*
Любящие объятия
*/

Звездочки могут быть размещены в начале многострочных комментариев с помощью опции -sc. Таким образом,
однострочный комментарий выше можно преобразовать (с помощью '-cdb -sc') в:

/*
* Любовное объятие
*/

ОТЧЕТНОСТЬ

Параметр «-br» или «-bl» указывает, как форматировать фигурные скобки.

Параметр '-br' форматирует фигурные скобки оператора следующим образом:

if (x> 0) {
Икс--;
}

Параметр -bl форматирует их следующим образом:

если (x> 0)
{
Икс--;
}

Если вы используете опцию «-bl», вы также можете указать опцию «-bli». Этот вариант
указывает количество пробелов, на которые делается отступ фигурных скобок. '-bli2', по умолчанию, дает
результат, показанный выше. '-bli0' приводит к следующему:

если (x> 0)
{
Икс--;
}

Если вы используете опцию «-br», вы, вероятно, захотите также использовать опцию «-ce». Этот
вызывает еще в конструкции if-then-else, чтобы прижаться к непосредственно предшествующему
'}'. Например, с -br -ce вы получите следующее:

if (x> 0) {
Икс--;
} Еще {
fprintf (stderr, "... что-то не так? \ n");
}

С -br -nce этот код будет выглядеть как

if (x> 0) {
Икс--;
}
еще {
fprintf (stderr, "... что-то не так? \ n");
}

Это вызывает в то время как в цикле do-while, чтобы прижаться к непосредственно предшествующему '}'.
Например, с -cdw вы получите следующее:

делать {
Икс--;
} пока (х);

С -ncdw этот код будет выглядеть как

делать {
Икс--;
}
в то время как (х);

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

По умолчанию используется такой код:

переключатель (я)
{
0 случае:
перерыва;
1 случае:
{
++ i;
}
по умолчанию:
перерыва;
}

Используя '-cli2', который станет:

переключатель (я)
{
0 случае:
перерыва;
1 случае:
{
++ i;
}
по умолчанию:
перерыва;
}

Отступ фигурных скобок под оператором case можно контролировать с помощью '-cbin"
вариант. Например, использование -cli2 -cbi0 приводит к:

переключатель (я)
{
0 случае:
перерыва;
1 случае:
{
++ i;
}
по умолчанию:
перерыва;
}

Если точка с запятой стоит в той же строке, что и для or в то время как оператор, опция '-ss' будет
поставить пробел перед точкой с запятой. Это подчеркивает точку с запятой, делая ее
ясно, что тело для or в то время как оператор - это пустой оператор. '-nss' отключает
эта особенность.

Опция '-pcs' заставляет пробел помещаться между именем процедуры, которую
называется и '(' (например, путы ("Привет");. Параметр -npcs даст
кладет ("Привет");).

Если указана опция '-cs', Отступ помещает пробел между оператором приведения и
объект, который нужно отлить. '-Ncs' гарантирует отсутствие пробелов между оператором приведения и
объект. Помни это Отступ знает только о стандартных типах данных C и поэтому не может
распознавать определяемые пользователем типы в приведениях. Таким образом (mytype) вещь не рассматривается как гипсовая.

Параметр -bs гарантирует наличие пробела между ключевыми словами. размер и ее
аргумент. В некоторых версиях это называется опцией Bill_Shannon.

Параметр -saf устанавливает пробел между для и следующие скобки. Это
по умолчанию.

Параметр '-sai' устанавливает пробел между if и следующие скобки. Это
по умолчанию.

Опция '-saw' устанавливает пробел между в то время как и следующие скобки. Это
по умолчанию.

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

в то время как ((e_code - s_code) <(dec_ind - 1))
{
set_buf_break (bb_dec_ind);
* e_code ++ = '';
}

ЗАЯВЛЕНИЯ

По умолчанию Отступ выровняет идентификаторы в столбце, указанном опцией '-di'.
Например, '-di16' заставляет вещи выглядеть так:

инт фу;
char * bar;

Использование небольшого значения (например, одного или двух) для параметра '-di' может быть использовано для того, чтобы
идентификаторы, которые нужно разместить в первой доступной позиции; Например:

инт фу;
char * bar;

Значение, указанное для опции '-di', по-прежнему будет влиять на переменные, которые помещаются в отдельные
строки из их типов, например '-di2' приведут к:

Int
фу;

Если указан параметр «-bc», после каждой запятой в объявлении принудительно ставится новая строка.
Например,

в,
b,
c;

С опцией '-nbc' это будет выглядеть как

в а, б, в;

Параметр '-bfda' приводит к принудительному добавлению новой строки после запятой, разделяющей аргументы.
объявления функции. Аргументы появятся на один уровень отступа глубже, чем
объявление функции. Это особенно полезно для функций с длинным аргументом.
списки. Параметр '-bfde' заставляет перевод строки перед закрывающей скобкой
объявление функции. Для обоих вариантов по умолчанию установлено значение «n»: -nbdfa и -nbdfe.

Например,

void foo (int arg1, char arg2, int * arg3, long arg4, char arg5);
С параметром '-bfda' это будет выглядеть как

пустота фу (
целочисленный аргумент1,
символ аргумент2,
int * arg3,
длинный arg4,
символ аргумент5);

Кроме того, с параметром '-bfde' это будет выглядеть как

пустота фу (
целочисленный аргумент1,
символ аргумент2,
int * arg3,
длинный arg4,
char аргумент5
);

Параметр '-psl' приводит к тому, что тип определяемой процедуры помещается в строку
перед названием процедуры. Этот стиль необходим для теги программа для работы
правильно, а также некоторые c-режим функции Emacs.

Вы должны использовать опцию '-T', чтобы указать Отступ имя всех типов в вашей программе
которые определены ЬурейеЕ. '-T' можно указывать более одного раза, и все имена
указанные используются. Например, если ваша программа содержит

typedef unsigned long CODE_ADDR;
typedef enum {красный, синий, зеленый} ЦВЕТ;

вы должны использовать опции -T CODE_ADDR -T COLOR.

Параметр «-brs» или «-bls» указывает, как форматировать фигурные скобки в объявлениях структур. В
Параметр -brs форматирует фигурные скобки следующим образом:

структура фу {
int x;
};

Параметр -bls форматирует их следующим образом:

структура foo
{
int x;
};

Аналогично параметрам структурной скобки '-brs' и '-bls',
параметры фигурных скобок '-brf' или '-blf' указывают, как форматировать фигурные скобки в функции
определения. Параметр -brf форматирует фигурные скобки следующим образом:

int one (void) {
1 вернуться;
};

Параметр -blf форматирует их следующим образом:

int один (пусто)
{
1 вернуться;
};

УКАЗАНИЕ

Одна из проблем форматирования кода заключается в том, насколько далеко каждая строка должна иметь отступ слева.
допуск. Когда в начале высказывания типа if or для встречается
уровень отступа увеличивается на значение, указанное опцией '-i'. Например,
используйте '-i8', чтобы указать отступ в восемь символов для каждого уровня. Когда заявление
разделенная на две строки, вторая строка имеет отступ на несколько дополнительных пробелов
указывается параметром '-ci'. '-ci' по умолчанию 0. Однако, если опция '-lp'
указано, и у строки есть левая скобка, которая не закрывается на этой строке, то
строки продолжения будут выровнены так, чтобы они начинались с позиции символа сразу после левого
скобка. Эта обработка также применяется к "[" и применяется к "{", когда это происходит в
списки инициализации. Например, фрагмент продолженного кода может выглядеть так:
'-nlp -ci3' действует:

p1 = первая_процедура (вторая_процедура (p2, p3),
третья_процедура (p4, p5));

При действии '-lp' код выглядит несколько яснее:

p1 = первая_процедура (вторая_процедура (p2, p3),
третья_процедура (p4, p5));

Когда оператор разбивается между двумя или более парными скобками (...), каждая дополнительная пара
вызывает дополнительный отступ на уровне отступа:

если ((((i <2 &&
k> 0) || p == 0) &&
д == 1) ||
п = 0)

Параметр '-ipN'может использоваться для установки дополнительного смещения для каждого элемента. Например, "-ip0"
отформатировал бы это как:

если ((((i <2 &&
k> 0) || p == 0) &&
д == 1) ||
п = 0)

Отступ предполагает, что вкладки размещаются через равные промежутки времени как при вводе, так и при выводе
потоки символов. Эти интервалы по умолчанию составляют 8 столбцов шириной, но (начиная с версии 1.2)
может быть изменен опцией '-ts'. Табуляция рассматривается как эквивалентное количество пробелов.

Отступ деклараций типов в определениях функций в старом стиле контролируется
параметр -ip. Это числовой параметр, определяющий количество пробелов для отступа.
объявления типов. Например, значение по умолчанию -ip5 делает определения такими:

символ *
create_world (x, y, масштаб)
int x;
int y;
плавающая шкала;
{
. . .
}

Для совместимости с другими версиями indent предоставляется опция '-nip', которая является
эквивалентно -ip0.

ANSI C позволяет помещать пробелы в командных строках препроцессора между символами.
'#' и имя команды. По умолчанию, Отступ удаляет это пространство, но с указанием
Параметр '-lps' указывает Отступ оставить это место без изменений. Параметр '-ppi' отменяет
-nlps и -lps.

Эта опция может использоваться, чтобы запросить, что условные операторы препроцессора могут быть
с отступом на заданное количество пробелов, например, с опцией '-ppi 3'

#если Х
#если Y
# определить Z 1
#еще
# определить Z 0
#endif
#endif
становится
#если Х
# если Y
# определить Z 1
# еще
# определить Z 0
# конец
#endif

Этот параметр устанавливает смещение, с которым будет располагаться метка (кроме меток регистра). Если
он установлен на ноль или положительное число, это указывает, как далеко от левого поля до
сделать отступ на этикетке. Если установлено отрицательное число, это указывает, насколько далеко от
текущий уровень отступа для размещения метки. Значение по умолчанию - -2, что соответствует
поведение более ранних версий отступа. Обратите внимание, что этот параметр не влияет на
размещение этикеток на ящиках; см. для этого параметр '-cli'. Например с опцией
'-il 1'

группы
функция ()
{
если (do_stuff1 () == ОШИБКА)
перейти к очистке1;

если (do_stuff2 () == ОШИБКА)
перейти к очистке2;

вернуть УСПЕХ;

очистка2:
do_cleanup2 ();

очистка1:
do_cleanup1 ();

вернуть ОШИБКУ;
}
становится
группы
функция ()
{
если (do_stuff1 () == ОШИБКА)
перейти к очистке1;

если (do_stuff2 () == ОШИБКА)
перейти к очистке2;

вернуть УСПЕХ;

очистка2:
do_cleanup2 ();

очистка1:
do_cleanup1 ();

вернуть ОШИБКУ;
}

НАША ДЛИННЫЙ ЛИНИИ

С опцией '-ln', или' - длина строкиn', можно указать максимальную длину
строки кода C, не включая возможные комментарии, следующие за ней.

Когда строки становятся длиннее указанной длины строки, GNU Отступ пытается сломать
линия в логическом месте. Это новинка версии 2.1, но не очень умная.
или еще гибкий.

В настоящее время есть два варианта, которые позволяют вмешиваться в алгоритм, который
определяет, где разорвать линию.

Параметр '-bbo' вызывает GNU Отступ предпочитать разбивать длинные строки перед логическим
Операторы && и ||. Параметр '-nbbo' вызывает GNU Отступ не имею такого предпочтения. За
Например, опция по умолчанию '-bbo' (вместе с '--line-length60' и '--ignore-
newlines ') делает код таким:

если (маска
&& ((маска [0] == '\ 0')
|| (маска [1] == '\ 0'
&& ((маска [0] == '0') || (маска [0] == '*')))))

Использование опции '-nbbo' сделает это так:

если (маска &&
((маска [0] == '\ 0') ||
(маска [1] == '\ 0' &&
((маска [0] == '0') || (маска [0] == '*')))))

Однако по умолчанию '-hnl' учитывает новые строки во входном файле, давая им наивысший
возможный приоритет разрыва строк. Например, когда входной файл выглядит так:

если (маска
&& ((маска [0] == '\ 0')
|| (маска [1] == '\ 0' && ((маска [0] == '0') || (маска [0] == '*')))))

затем используя опцию '-hnl' или '--honour-newlines' вместе с ранее
упомянутые '-nbbo' и '--line-length60' приведут к тому, что вывод будет не таким, как указано в
последний пример, но вместо этого предпочтет разорвать позиции, где был код
не работает во входном файле:

если (маска
&& ((маска [0] == '\ 0')
|| (маска [1] == '\ 0' &&
((маска [0] == '0') || (маска [0] == '*')))))

Идея этого варианта заключается в том, что строки слишком длинные, но уже разорваны,
GNU не тронет Отступ. Следует прогнать действительно грязный код Отступ at
хотя бы один раз, используя параметр --ignore-newlines.

ОТКЛЮЧЕНИЕ ФОРМАТИРОВАНИЕ

Форматирование кода C может быть отключено для частей программы путем встраивания специальных
контроль Комментарии в программе. Чтобы отключить форматирование раздела программы, поместите
отключающий контрольный комментарий /* * НЕЗАВИСИМО * */ на отдельной строке непосредственно перед этим
раздел. Текст программы, отсканированный после этого контрольного комментария, выводится точно как ввод
без изменений, пока соответствующий разрешающий комментарий не просканируется в строке
сам. Комментарий к элементу управления отключением: /* * НЕЗАВИСИМО * */, и любой текст, следующий за
комментарий в строке также выводится в неформатированном виде. Форматирование снова начинается с ввода
строка, следующая за комментарием включающего элемента управления.

Точнее, Отступ не пытается проверить закрывающий разделитель (*/) для этих C
комментарии, и любые пробелы в строке полностью прозрачны.

Эти управляющие комментарии также работают в своих форматах C ++, а именно: // * НЕЗАВИСИМО * и //
* НЕЗАВИСИМО *.

Следует отметить, что внутреннее состояние Отступ остается неизменным в течение
неформатированный раздел. Так, например, отключив форматирование в середине
функция и продолжение ее после окончания функции может привести к странным результатам. Это
поэтому разумно быть в некоторой степени модульным при выборе кода, который следует оставить неформатированным.

В качестве исторической заметки, некоторые более ранние версии Отступ выдает сообщения об ошибках, начало
* ДЕНТА **. Эти версии Отступ были написаны, чтобы игнорировать любые строки ввода текста
который начинался с таких сообщений об ошибках. Я удалил эту кровосмесительную особенность из GNU
Отступ.

РАЗНОЕ ДОПОЛНИТЕЛЬНЫЕ УСЛУГИ, НЕ ВКЛЮЧЕННЫЕ В ПАКЕТ

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

Параметр '-v' может использоваться для включения подробного режима. В подробном режиме Отступ отчеты
когда он разбивает одну строку ввода еще на две строки вывода и дает некоторый размер
статистика по завершению.

Параметр -pmt вызывает Отступ чтобы сохранить время доступа и модификации на
выходные файлы. Использование этой опции имеет то преимущество, что отступы для всех исходных и
файлы заголовков в проекте не вызовут сделать восстановить все цели. Этот вариант только
доступно в операционных системах с POSIX время(2) функции.

Используйте отступы в Интернете с помощью сервисов onworks.net