відступ - онлайн в хмарі

ПРОГРАМА:

ІМ'Я

відступ - змінює зовнішній вигляд програми на C, вставляючи або видаляючи пробіли.

СИНТАКСИС

відступ [параметри] [вхідні файли]

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

відступ -- версія

ОПИС

Ця man-сторінка генерується з файлу indent.texinfo. Це видання «The відступ
Посібник", для версії з відступом, останнє оновлення.

Команда відступ Програму можна використовувати для полегшення читання коду. Він також може конвертувати з одного
стиль написання С до іншого.

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

У версії 1.2 і новіших версіях стиль відступів GNU є за замовчуванням.

ВАРІАНТИ

-погано, --пусті рядки-після декларацій
Примусово пропустіть рядки після декларацій.
Читати ПУСТО ЛІНІЇ.

-бап, --пусті рядки-після-процедур
Примусово пропустіть рядки після тіл процедури.
Читати ПУСТО ЛІНІЇ.

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

-ббо, --break-before-boolean-оператор
Віддавайте перевагу розриву довгих рядків перед булевими операторами.
Читати НАРУШЕННЯ ДОВГО ЛІНІЇ.

- до н.е, --пусті рядки-після коми
Примусово перевести новий рядок після коми в оголошенні.
Читати ДЕКЛАРАЦІЇ.

-бл, --дужки-після-якщо-рядка
Після цього поставте дужки if, І т.д.
Читати ЗАЯВА.

-бл, --субки-після-func-def-line
Поставте дужки на рядок, наступний за рядком визначення функції.
Читати ДЕКЛАРАЦІЇ.

-бліn, ---відступn
Дужки з відступом n простори.
Читати ЗАЯВА.

-блс, -- фігурні дужки після-структури-decl-line
Поставте дужки на лінію після структура рядки декларації.
Читати ДЕКЛАРАЦІЇ.

-бр, --субки-на-якщо-лінії
Поставте брекети на одну лінію з if, І т.д.
Читати ЗАЯВА.

-brf, --субки-на-функції-визначення-лінії
Поставте дужки в рядку визначення функції.
Читати ДЕКЛАРАЦІЇ.

-бр, --субки-на-структурі-decl-line
Одягніть брекети структура рядок декларації.
Читати ДЕКЛАРАЦІЇ.

-bs, --Білл-Шеннон, --blank-before-sizeof
Поставте між ними пробіл sizeof і його аргумент.
Читати ЗАЯВА.

-cn, --відступ від коментаряn
Помістіть коментарі праворуч від коду в стовпці n.
Читати КОМЕНТАРІ.

-cbin, -- відступ від реєструn
Зробіть відступ у дужках після мітки регістра N пробілів.
Читати ЗАЯВА.

- компакт-дискn, -- декларація-коментар-стовпецьn
Поставте коментарі праворуч від декларацій у колонці n.
Читати КОМЕНТАРІ.

-cdb, --comment-delimiters-on-blank-lines
Поставте роздільники коментарів у порожні рядки.
Читати КОМЕНТАРІ.

-cdw, -- обіймися
Обіймаються під час do {} поки; і перед '}'.
Читати КОМЕНТАРІ.

- це, -- обіймися
Обійміться ще й перед '}'.
Читати КОМЕНТАРІ.

- цеn, --продовження-відступn
Продовження відступу n простори.
Читати ЗАЯВА.

-кліn, -- відступ від регіструn
Відступ етикетки справи n простори.
Читати ЗАЯВА.

-cpn, --else-endif-стовпецьn
Поставте коментарі праворуч від #else та #endif твердження в колонці n.
Читати КОМЕНТАРІ.

-cs, --простір після відтворення
Поставте пробіл після оператора приведення.
Читати ЗАЯВА.

-dn, --line-comments-indentationn
Встановіть відступ коментарів не праворуч від коду n простори.
Читати КОМЕНТАРІ.

-bfda, --break-function-decl-args
Розривайте рядок перед усіма аргументами в оголошенні.
Читати ДЕКЛАРАЦІЇ.

-bfde, --break-function-decl-args-end
Розривайте рядок після останнього аргументу в оголошенні.
Читати ДЕКЛАРАЦІЇ.

-діджей, --оголошення лівого вирівнювання
Якщо використовується -cd 0, коментарі після декларацій залишаються вирівняними
декларація
Читати ДЕКЛАРАЦІЇ.

-dun, --декларація-відступn
Помістіть змінні в стовпець n.
Читати ДЕКЛАРАЦІЇ.

-fc1, --format-first-column-comments
Форматуйте коментарі в першому стовпці.
Читати КОМЕНТАРІ.

-fca, --format-all-comments
Не вимикайте все форматування коментарів.
Читати КОМЕНТАРІ.

- гну, ---стиль gnu
Використовуйте стиль кодування GNU. Це значення за замовчуванням.
Читати ЗАГАЛЬНИЙ СТИЛИ.

-hnl, --honour-новий рядок
Віддавайте перевагу розриву довгих рядків у позиції нового рядка у вводі.
Читати НАРУШЕННЯ ДОВГО ЛІНІЇ.

-in, --рівень відступуn
Установіть рівень відступу на n простори.
Читати ВІДСТУП.

-ілn, --мітка-відступn
Установити зміщення для міток до стовпця n.
Читати ВІДСТУП.

-ipn, --відступ-параметрn
Відступ типів параметрів у визначеннях функцій старого стилю за n простори.
Читати ВІДСТУП.

-кр, --к-і-р-стиль
Використовуйте стиль кодування Кернігана та Річі.
Читати ЗАГАЛЬНИЙ СТИЛИ.

-ln, -- довжина рядкаn
Встановити максимальну довжину рядків без коментарів до n.
Читати НАРУШЕННЯ ДОВГО ЛІНІЇ.

-lcn, --довжина рядка коментарівn
Встановити максимальну довжину рядка для форматування коментаря n.
Читати КОМЕНТАРІ.

-лінукс, ---стиль Linux
Використовуйте стиль кодування Linux.
Читати ЗАГАЛЬНИЙ СТИЛИ.

-lp, --продовження в дужках
Розташуйте продовжені рядки в дужках.
Читати ВІДСТУП.

-lps, --leave-preprocessor-space
Залиште пробіл між «#» і директивою препроцесора.
Читати ВІДСТУП.

-погано, --no-blank-lines-after-declarations
Не вводьте порожні рядки після декларацій.
Читати ПУСТО ЛІНІЇ.

-nbap, --no-blank-lines-after-procedures
Не додавайте пусті рядки після тіл процедури.
Читати ПУСТО ЛІНІЇ.

-nbbo, --перерив після-логічного оператора
Не віддавайте перевагу розриву довгих рядків перед булевими операторами.
Читати НАРУШЕННЯ ДОВГО ЛІНІЇ.

-nbc, --без-порожніх-рядків-після ком
Не вводьте новий рядок після коми в оголошеннях.
Читати ДЕКЛАРАЦІЇ.

-nbfda, --dont-break-function-decl-args
Не розміщуйте кожен аргумент в оголошенні функції в окремому рядку.
Читати ДЕКЛАРАЦІЇ.

-ncdb, --no-comment-delimiters-on-blank-lines
Не ставте роздільники коментарів на порожні рядки.
Читати КОМЕНТАРІ.

-ncdw, --не-обіймати-до-поки
Не обіймаються } і в той час як з do {} поки;.
Читати ЗАЯВА.

-nce, --dont-cudle-else
Не обіймаються } та ще.
Читати ЗАЯВА.

-ncs, --без пробілу після закидання
Не ставте пробіл після операторів приведення.
Читати ЗАЯВА.

-ndjn, --dont-left-justify-declarations
Коментарі після заяв розглядаються так само, як і коментарі після інших заяв.
Читати ДЕКЛАРАЦІЇ.

-nfc1, --dont-format-first-column-comments
Не форматуйте коментарі в першому стовпці як зазвичай.
Читати КОМЕНТАРІ.

-nfca, --dont-format-comments
Не форматуйте коментарі.
Читати КОМЕНТАРІ.

-nhnl, --ігнорувати-новий рядок
Не віддавайте перевагу розриву довгих рядків у позиції нового рядка у вводі.
Читати НАРУШЕННЯ ДОВГО ЛІНІЇ.

- кусати, --no-parameter-indentation
Відступ нульової ширини для параметрів.
Читати ВІДСТУП.

-nlp, --dont-line-up-дужки
Не розставляйте дужки.
Читати ЗАЯВА.

-npcs, --без пробілу після імен виклику функції
Не ставте пробіл після функції у викликах функцій.
Читати ЗАЯВА.

-nprs, --без пробілу після дужок
Не ставте пробіл після кожного '(' і перед кожним ')'.
Читати ЗАЯВА.

-npsl, --dont-break-procedure-type
Помістіть тип процедури в одному рядку з її назвою.
Читати ДЕКЛАРАЦІЇ.

-nsaf, --без пробілу після-для
Не ставте пробіл після кожного та цінності.
Читати ЗАЯВА.

-нсай, --без пробілу після-якщо
Не ставте пробіл після кожного if.
Читати ЗАЯВА.

-nsaw, --без пробілу-після часу
Не ставте пробіл після кожного в той час як.
Читати ЗАЯВА.

-nsc, --dont-star-comments
Не ставте символ «*» зліва від коментарів.
Читати КОМЕНТАРІ.

-нссоб, --leave-optional-blank-lines
Не ковтайте додаткові порожні рядки.
Читати ПУСТО ЛІНІЇ.

-nss, --dont-пробіл-спеціальна-крапка з комою
Не ставте пробіл перед крапкою з комою після певних операторів. Вимикає '-ss'.
Читати ЗАЯВА.

- горіх, --без вкладок
Використовуйте пробіли замість табуляції.
Читати ВІДСТУП.

-nv, -- без багатослівності
Вимкнути докладний режим.
Читати РІЗНЕ ВАРІАНТИ.

-оригінал, --оригінал
Використовуйте оригінальний стиль кодування Берклі.
Читати ЗАГАЛЬНИЙ СТИЛИ.

-npro, --ignore-profile
Не читайте файли «.indent.pro».
Читати ЗАКЛЮЧЕННЯ ВІДступ.

-шт, --пробіл-після-виклики-процедури
Вставте пробіл між назвою процедури, яка викликається, і символом «(».
Читати ЗАЯВА.

-піn, -- родительський відступn
Вкажіть додатковий відступ у відкритих дужках '(', коли оператор не працює. Див
ЗАЯВА.

-pmt, --preserve-mtime
Збережіть час доступу та модифікації вихідних файлів. Див РІЗНЕ ВАРІАНТИ.

-ppin, --відступи препроцесораn
Вкажіть відступ для умовних операторів препроцесора. Див ВІДСТУП.

-прс, --пробіл після дужок
Поставте пробіл після кожного '(' і перед кожним ')'.
Читати ЗАЯВА.

-псл, --procnames-start-lines
Поставте тип процедури в рядок перед її назвою.
Читати ДЕКЛАРАЦІЇ.

-саф, --пробіл-після-для
Поставте пробіл після кожного та цінності.
Читати ЗАЯВА.

-сай, --пробіл-після-якщо
Поставте пробіл після кожного if.
Читати ЗАЯВА.

-пила, --пробіл-після-поки
Поставте пробіл після кожного в той час як.
Читати ЗАЯВА.

-sbin, --struct-brace-indentationn
Відступ у дужках структури, об’єднання або перерахування N пробілів.
Читати ЗАЯВА.

-sc, --start-left-side-of-comments
Поставте символ «*» зліва від коментарів.
Читати КОМЕНТАРІ.

-ридати, --swallow-optional-blank-lines
Проковтніть необов’язкові порожні рядки.
Читати ПУСТО ЛІНІЇ.

-ss, --пробіл-спеціальна-крапка з комою
На одній лінії та цінності та в той час як операторів, примусово поставити пробіл перед крапкою з комою.
Читати ЗАЯВА.

-ст, --стандартний вихід
Запис на стандартний вихід.
Читати ЗАКЛЮЧЕННЯ ВІДступ.

-T Сказати відступ назви назв типів.
Читати ДЕКЛАРАЦІЇ.

-цn, --розмір вкладкиn
Установіть розмір вкладки на n простори.
Читати ВІДСТУП.

-ут, --use-tabs
Використовуйте вкладки. Це значення за замовчуванням.
Читати ВІДСТУП.

-v, -багатослівний
Увімкнути докладний режим.
Читати РІЗНЕ ВАРІАНТИ.

-версія
Виведіть номер версії відступ.
Читати РІЗНЕ ВАРІАНТИ.

ЗАКЛЮЧЕННЯ ВІДступ

Починаючи з версії 1.3, формат файлу відступ команда така:

відступ [опції] [вхідні файли]

відступ [опції] [один вхідний файл] [-о вихідний файл]

Цей формат відрізняється від попередніх версій та інших версій відступ.

У першій формі вказується один або кілька вхідних файлів. відступ створює резервну копію
кожного файлу, а вихідний файл буде замінено його версією з відступом. Подивитися BACKUP ФАЙЛИ,
для пояснення того, як створюються резервні копії.

У другій формі вказується лише один вхідний файл. У цьому випадку або коли стандарт
використовується введення, ви можете вказати вихідний файл після параметра '-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/metabolism.c' за допомогою параметрів '-br' і '-l85', напишіть
вихід назад до 'test/metabolism.c' і запишіть оригінальний вміст
«test/metabolism.c» у файл резервної копії в каталозі «test».

Еквівалентними викликами з використанням довгих імен параметрів для цього прикладу будуть:

відступ -- braces-on-if-line --line-length185 test/metabolism.c

відступ +дужки-якщо-рядка +лінія-довжина185 тест/метаболізм.c

Якщо ви виявите, що часто використовуєте відступ з тими ж параметрами, ви можете поставити ці параметри
у файл з назвою '.indent.pro'. відступ шукатиме файл профілю в трьох місцях.
Спочатку він перевірить змінну середовища INDENT_PROFILE. Якщо це існує, то його значення
очікується назва файлу, який буде використано. Якщо змінна середовища не існує,
indent шукає «.indent.pro» у поточному каталозі
і використовуйте це, якщо знайдено. Нарешті відступ шукатиме у вашому домашньому каталозі «.indent.pro»
і використовуйте цей файл, якщо він знайдений. Ця поведінка відрізняється від поведінки інших версій
of відступ, який завантажує обидва файли, якщо вони обидва існують.

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

Перемикачі командного рядка обробляються після обробка '.indent.pro'. Параметри вказані пізніше
замінити аргументи, зазначені раніше, за одним винятком: явно вказані параметри
завжди замінювати параметри фону (Див ЗАГАЛЬНИЙ СТИЛИ). Ви можете запобігти відступ від
читання файлу ".indent.pro", вказавши параметр "-npro".

BACKUP ФАЙЛИ

Починаючи з версії 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'. The
змінна оточення VERSION_WIDTH контролює кількість цифр, використовуючи лівий нульовий відступ
коли необхідно. Наприклад, встановлення для цієї змінної значення "2" призведе до створення файлу резервної копії
отримав назву 'momeraths.c.~04~'.

Тип створеного файлу резервної копії контролюється значенням змінної середовища
VERSION_CONTROL. Якщо це рядок «simple», то будуть створені лише прості резервні копії. Якщо
його значенням є рядок 'numbered', тоді будуть створені пронумеровані резервні копії. Якщо його значення
'numbered-existing', тоді будуть створені пронумеровані резервні копії, якщо вони є вже існувати пронумерований
резервні копії файлу з відступом; в іншому випадку створюється проста резервна копія. Якщо
VERSION_CONTROL не встановлено, то відступ припускає поведінку «пронумерований-існуючий».

Інші версії відступ використовуйте суфікс '.BAK' для іменування файлів резервних копій. Така поведінка може
емулювати за допомогою налаштування SIMPLE_BACKUP_SUFFIX до ".BAK".

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

ЗАГАЛЬНИЙ СТИЛИ

Існує кілька поширених стилів коду C, включаючи стиль GNU, Керніган і
Стиль Річі та оригінальний стиль Берклі. Стиль можна вибрати за допомогою одного
фон параметр, який визначає набір значень для всіх інших параметрів. однак,
явно вказані параметри завжди перевизначають параметри, що маються на увазі під опцією фону.

Починаючи з версії 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
-пила -нсц -нссоб

Стиль кодування GNU – це той, який надає перевагу проект GNU. Це стиль GNU
Режим C Emacs заохочує і використовується в частинах C GNU Emacs. (Люди
зацікавлені в написанні програм для проекту GNU повинні отримати копію «The GNU Coding
Стандарти», який також охоплює семантичні питання та питання переносимості, такі як використання пам’яті,
розмір цілих чисел тощо)

Стиль Kernighan & Ritchie використовується в їхній відомій книзі «Програмування на C
Мова". Його вмикають за допомогою параметра "-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' (або by
вказавши '--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
-саф -сай -сав -сч -нссоб -нсс -ц8

Стиль 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' є
якщо зазначено, будь-які порожні рядки, присутні у вхідному файлі, будуть скопійовані у вихідний файл.

--пусті рядки-після декларацій

Параметр '-bad' змушує порожній рядок після кожного блоку декларацій. "-nbad"
опція не додає таких порожніх рядків.

Наприклад, з огляду на вхідні дані
char *foo;
char *бар;
/* Це розділяє блоки декларацій. */
int baz;

відступ -погано випускає

char *foo;
char *бар;

/* Це розділяє блоки декларацій. */
int baz;

та відступ -погано випускає

char *foo;
char *бар;
/* Це розділяє блоки декларацій. */
int baz;

--пусті рядки-після-процедур

Параметр '-bap' змушує залишати порожній рядок після кожного тіла процедури.

Наприклад, з огляду на вхідні дані

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

відступ -бап випускає

Int
фу ()
{
ставить («Привіт»);
}

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

та відступ -nbap випускає

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

Після процедури не буде додано порожній рядок Foo.

КОМЕНТАРІ

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

відступ обробляє коментарі по-різному залежно від їх контексту. відступ спроби
розрізняти коментарі, які слідують за заявами, коментарі, які слідують за заявами,
коментарі, що відповідають директивам препроцесора, і коментарі, яким не передує код
будь-якого роду, тобто вони починають текст рядка (хоча не обов'язково в колонці 1).

відступ далі розрізняє коментарі, знайдені поза процедурами, та зведені дані,
і ті, що знаходяться в них. Зокрема, коментарі, що починаються з рядка, знайденого всередині a
процедура буде мати відступ у стовпці, у якому в даний момент зроблено відступ. The
винятком з цього є коментар, що починається в крайньому лівому стовпці; виводиться такий коментар
на тій колонці.

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

Приклади обмежених коментарів:

/*************************
* Коментар у коробці!! *
***********************/

/*
* Інший вид аромату,
* для іншого роду коментарів.
*/

відступ намагається залишити коментарі у вигляді коробки, точно так, як вони знаходяться у вихідному файлі.
Таким чином, відступ коментаря не змінюється, а його довжина ні в якому разі не перевіряється
спосіб. Єдина внесена зміна полягає в тому, що вбудований символ табуляції може бути перетворений на
відповідну кількість місць.

Якщо вказано параметр '-bbb', перед усіма такими коментарями в коробці буде стояти пробіл
рядок, якщо такому коментарю не передує код.

Коментарі, які не заблоковані, коментарі можуть бути відформатовані, що означає, що рядок є
розбитий, щоб умістити в правому полю та заповнений лівим пробілом. Поодинокі нові рядки
еквівалентно пробілу, але порожні рядки (два чи більше нових рядків у рядку) означають
розрив абзацу. Увімкнено форматування коментарів, які починаються після першого стовпця
з опцією '-fca'. Щоб відформатувати їх, які починаються з першого стовпця, вкажіть «-fc1». Такий
форматування вимкнено за замовчуванням.

Праве поле для форматування за замовчуванням дорівнює 78, але його можна змінити за допомогою параметра «-lc».
Якщо вказане поле не дозволяє надрукувати коментар, поле буде
автоматично подовжується на термін дії цього коментаря. Маржа не дотримується, якщо
коментар не форматується.

Якщо коментар починається з рядка (тобто зліва від нього немає тексту програми), він буде
з відступом до стовпця, в якому він був знайдений, якщо коментар не знаходиться в блоці коду. в
у цьому випадку такий коментар буде узгоджено з кодом із відступом цього блоку (якщо не буде
коментар почався з першого стовпця). На це вирівнювання може вплинути параметр '-d',
який визначає кількість, на яку такі коментарі переміщуються до залишити, або без відступу.
Наприклад, '-d2' розміщує коментарі на два пробіли зліва від коду. За замовчуванням коментарі
узгоджені з кодом, якщо вони не починаються з першого стовпця, і в такому випадку їх залишають
там за замовчуванням --- щоб їх узгодити з кодом, вкажіть '-fc1'.

Коментарі праворуч від коду з’являться за замовчуванням у стовпці 33. Це можна змінити
з одним із трьох варіантів. '-c' вказуватиме стовпець для коментарів наступного коду,
'-cd' визначає стовпець для коментарів після декларацій, а '-cp' визначає
стовпець для коментарів відповідно до директив препроцесора #else та #endif. '-dj' разом
з '-cd0' можна використовувати для придушення вирівнювання коментарів праворуч від декларацій,
змушує коментар йти за однією табуляцією від кінця оголошення. Зазвичай '-cd0'
змушує '-c' стати ефективним.

Якщо код зліва від коментаря перевищує початковий стовпець, стовпець коментаря
буде розширено до наступного стовпця табуляції після кінця коду або у випадку
директиви препроцесора на один пробіл після кінця директиви. Це розширення триває
лише для виведення цього конкретного коментаря.

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

/*
Любовні обійми
*/

Зірочки можна поставити на початку багаторядкових коментарів за допомогою параметра '-sc'. таким чином,
однорядковий коментар вище можна трансформувати (за допомогою '-cdb -sc') у:

/*
* Любовні обійми
*/

ЗАЯВА

Параметр '-br' або '-bl' визначає, як форматувати дужки.

Параметр '-br' форматує фігурні дужки таким чином:

якщо (x > 0) {
х--;
}

Параметр '-bl' форматує їх так:

якщо (x > 0)
{
х--;
}

Якщо ви використовуєте параметр '-bl', ви також можете вказати параметр '-bli'. Цей варіант
вказує кількість пробілів, на які мають відступ. '-bli2', за замовчуванням, дає
результат, показаний вище. "-bli0" призводить до наступного:

якщо (x > 0)
{
х--;
}

Якщо ви використовуєте параметр '-br', ви, ймовірно, також захочете використовувати параметр '-ce'. Це
причини ще у конструкції if-then-else, щоб притиснути до безпосередньо попереднього
'}'. Наприклад, за допомогою '-br -ce' ви отримаєте наступне:

якщо (x > 0) {
х--;
} Ще {
fprintf (stderr, "...щось не так?\n");
}

З '-br -nce' цей код буде виглядати як

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

Це спричиняє в той час як у циклі do-while, щоб притиснути до безпосередньо переднього '}'.
Наприклад, за допомогою '-cdw' ви отримаєте наступне:

робити {
х--;
} поки (x);

З '-ncdw' цей код буде виглядати як

робити {
х--;
}
поки (x);

Параметр '-cli' визначає кількість пробілів, до яких мають бути відступи мітки регістру
право містить перемикання Заява

За замовчуванням надається такий код:

перемикач (i)
{
case 0:
break;
case 1:
{
++i;
}
за замовчуванням:
break;
}

Використання '-cli2' стане:

перемикач (i)
{
case 0:
break;
case 1:
{
++i;
}
за замовчуванням:
break;
}

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

перемикач (i)
{
case 0:
break;
case 1:
{
++i;
}
за замовчуванням:
break;
}

Якщо крапка з комою стоїть в одному рядку з a та цінності or в той час як оператор, параметр '-ss' буде
викликати пробіл перед крапкою з комою. Це підкреслює крапку з комою, роблячи її
ясно, що тіло в та цінності or в той час як оператор є порожнім оператором. '-nss' вимикає
ця особливість.

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

Якщо вказано параметр '-cs', відступ розміщує пробіл між оператором приведення та
об'єкт, який потрібно відлити. '-ncs' гарантує, що між оператором приведення і
об'єкт. Пам'ятайте, що відступ знає лише про стандартні типи даних C і тому не може
розпізнавати визначені користувачем типи в приведеннях. Таким чином (мій тип) річ не розглядається як гіпс.

Параметр '-bs' гарантує, що між ключовим словом є пробіл sizeof і її
аргумент. У деяких версіях це відоме як параметр «Bill_Shannon».

Параметр '-saf' встановлює пробіл між a та цінності і наступні дужки. Це
за замовчуванням.

Параметр '-sai' створює пробіл між a if і наступні дужки. Це
за замовчуванням.

Параметр '-saw' створює пробіл між a в той час як і наступні дужки. Це
за замовчуванням.

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

while ( ( e_code - s_code ) < ( dec_ind - 1 ) )
{
set_buf_break (bb_dec_ind);
*e_code++ = ' ';
}

ДЕКЛАРАЦІЇ

За замовчуванням відступ вибудовує ідентифікатори у стовпці, визначеному опцією '-di'.
Наприклад, '-di16' виглядає так:

int foo;
char *бар;

Використання невеликого значення (наприклад, одне або два) для параметра '-di' може бути використано для виклику
ідентифікатори, які розміщуються на першому доступному місці; наприклад:

int foo;
char *бар;

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

Int
foo;

Якщо вказано параметр '-bc', після кожної коми в оголошенні примусово вводиться новий рядок.
Наприклад,

int a,
b,
c;

З опцією "-nbc" це буде виглядати так

int a, b, c;

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

Наприклад,

void foo (int arg1, char arg2, int *arg3, long arg4, char arg5);
З опцією '-bfda' це буде виглядати так

порожній foo (
int arg1,
char arg2,
int *arg3,
довгий arg4,
char arg5);

Крім того, з параметром '-bfde' це буде виглядати так

порожній foo (
int arg1,
char arg2,
int *arg3,
довгий arg4,
char arg5
);

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

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

typedef непідписаний довгий CODE_ADDR;
typedef enum {червоний, синій, зелений} COLOR;

Ви б використовували параметри '-T CODE_ADDR -T COLOR'.

Параметр '-brs' або '-bls' визначає, як форматувати дужки в оголошеннях структур. The
Параметр '-brs' форматує дужки таким чином:

struct foo {
int x;
};

Параметр '-bls' форматує їх так:

struct foo
{
int x;
};

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

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

Параметр '-blf' форматує їх так:

int one (void)
{
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) &&
q == 1) ||
n = 0)

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

якщо ((((i < 2 &&
k > 0) || p == 0) &&
q == 1) ||
n = 0)

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

Відступи в оголошеннях типів у визначеннях функцій старого стилю контролюються за допомогою
параметр '-ip'. Це числовий параметр, який визначає кількість пробілів для відступу
оголошення типу. Наприклад, за замовчуванням '-ip5' визначення виглядають так:

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

Для сумісності з іншими версіями відступу надається параметр '-nip', який є
еквівалентно '-ip0'.

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

Цю опцію можна використовувати, щоб запитати, що можуть бути умовні оператори препроцесора
з відступом на задану кількість пробілів, наприклад з опцією '-ppi 3'

#якщо X
#якщо Y
#визначте Z 1
#else
#визначте Z 0
#endif
#endif
стає
#якщо X
# якщо Y
# визначте Z 1
# ще
# визначте Z 0
# endif
#endif

Ця опція встановлює зміщення, на якому буде розташовуватися мітка (крім міток регістра). Якщо
встановлено на нуль або додатне число, це вказує, наскільки далеко від лівого поля до
зробити відступ мітки. Якщо для нього встановлено від’ємне число, це вказує, наскільки далеко від нього
поточний рівень відступу для розміщення мітки. Налаштування за замовчуванням -2, що відповідає параметру
поведінка попередніх версій відступу. Зауважте, що цей параметр не впливає на
розміщення ярликів футлярів; дивіться параметр '-cli' для цього. Наприклад з опцією
'-il 1'

група
функція()
{
if (do_stuff1() == ПОМИЛКА)
перейти до очищення1;

if (do_stuff2() == ПОМИЛКА)
перейти до очищення2;

повернути УСПІХ;

очищення 2:
do_cleanup2();

очищення 1:
do_cleanup1();

повернути ПОМИЛКУ;
}
стає
група
функція()
{
if (do_stuff1() == ПОМИЛКА)
перейти до очищення1;

if (do_stuff2() == ПОМИЛКА)
перейти до очищення2;

повернути УСПІХ;

очищення 2:
do_cleanup2();

очищення 1:
do_cleanup1();

повернути ПОМИЛКУ;
}

НАРУШЕННЯ ДОВГО ЛІНІЇ

З опцією '-ln' або '--line-lengthn', можна вказати максимальну довжину
рядка коду 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')
|| (mask[1] == '\0' && ((mask[0] == '0') || (mask[0] == '*')))))

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

якщо (маска
&& ((маска[0] == '\0')
|| (маска [1] == '\0' &&
((маска[0] == '0') || (маска[0] == '*')))))

Ідея цієї опції полягає в тому, що рядки, які занадто довгі, але вже розірвані,
GNU не торкнеться відступ. Справді безладний код слід пропустити відступ at
хоча б один раз за допомогою параметра '--ignore-newlines'.

ВІДКЛЮЧЕННЯ ФОРМАТУВАННЯ

Форматування коду C можна вимкнути для частин програми шляхом вбудовування спец
контроль коментарі в програмі. Щоб вимкнути форматування для розділу програми, розмістіть
коментар керування вимкненням /* *Відступ-ВИМК* */ на рядку безпосередньо перед цим
розділ. Текст програми, відсканований після цього контрольного коментаря, виводиться точно як вхідний
без змін, доки відповідний коментар про включення не буде просканований у рядку
себе. Коментар керування вимкненням /* *Відступ-УВІМКНЕНО* */, і будь-який текст після
коментар до рядка також виводиться неформатованим. Форматування починається знову з введення
рядок після коментаря керування увімкненням.

Точніше, відступ не намагається перевірити закриваючий роздільник (*/) для цих C
коментарі, і будь-який пробіл у рядку повністю прозорий.

Ці контрольні коментарі також функціонують у своїх форматах C++, а саме // *Відступ-ВИМК* та //
*Відступ-УВІМКНЕНО*.

Слід зазначити, що внутрішній стан о відступ залишається незмінним протягом
неформатований розділ. Таким чином, наприклад, вимкнення форматування в середині a
функції та продовження її після завершення функції може призвести до дивних результатів. Це
Тому має бути дещо модульним у виборі коду, який не відформатується.

Як історична примітка, деякі попередні версії відступ з'явилися повідомлення про помилки
з *Відступ**. Ці версії відступ були написані так, щоб ігнорувати будь-які рядки введеного тексту
які починалися з таких повідомлень про помилки. Я видалив цю інцестуозну функцію з GNU
відступ.

РІЗНЕ ВАРІАНТИ

Щоб дізнатися, яка версія відступ маєте, скористайтеся командою відступ -версія. Це буде
повідомити номер версії відступ, не виконуючи жодної звичайної обробки.

Параметр '-v' можна використовувати, щоб увімкнути докладний режим. У режимі докладної інформації, відступ звіти
коли він розбиває один рядок введення на ще два рядки виводу і дає певний розмір
статистика на завершення.

Параметр '-pmt' викликає відступ щоб зберегти час доступу та модифікації
вихідні файли. Використання цієї опції має ту перевагу, що запускається відступ на всіх джерелах і
заголовні файли в проекті не викликають зробити відновити всі цілі. Цей варіант тільки
доступні в операційних системах, які мають POSIX utime(2) функції.

Використовуйте відступ онлайн за допомогою служб onworks.net