wcięcie - Online w chmurze

PROGRAM:

IMIĘ

wcięcie - zmienia wygląd programu C poprzez wstawienie lub usunięcie spacji.

STRESZCZENIE

wcięcie [opcje] [pliki wejściowe]

wcięcie [opcje] [pojedynczy plik wejściowy] [-o plik wyjściowy]

wcięcie --wersja

OPIS

Ta strona podręcznika jest generowana z pliku wcięcie.texinfo. To jest wydanie „The wcięcie
Podręcznik”, dla wersji wcięcia , ostatnia aktualizacja .

Połączenia wcięcie programu można użyć do ułatwienia czytania kodu. Może również konwertować z jednego
styl pisania C na inny.

wcięcie rozumie znaczną część składni C, ale także próbuje
radzić sobie z niekompletną i błędnie sformułowaną składnią.

W wersji 1.2 i nowszych wersjach styl wcięć GNU jest domyślny.

OPCJE

-zły, --puste-wiersze-po-deklaracjach
Wymuś puste wiersze po deklaracjach.
See BLANK LINIE.

-bup, --puste-wiersze-po-procedurach
Wymuś puste wiersze po ciałach procedur.
See BLANK LINIE.

-bbb, --puste-linie-przed-komentarzami-blokowymi
Wymuś puste wiersze przed blokowaniem komentarzy.
See BLANK LINIE.

-bbo, --break-przed-operatorem-boolowskim
Wolisz łamać długie linie przed operatorami boolowskimi.
See BREAKING DŁUGIE LINIE.

-pne, --puste-linie-po-przecinkach
Wymuś nową linię po przecinku w deklaracji.
See DEKLARACJE.

-bl, --nawiasy klamrowe-po-jeżeli-wierszu
Umieść szelki na linii po if, itp.
See SPRAWOZDANIA.

-blf, --nawiasy klamrowe-po-funkcji-def-linii
Umieść nawiasy klamrowe w linii następującej po linii definicji funkcji.
See DEKLARACJE.

-blin, --wcięcie nawiasu klamrowegon
Nawiasy klamrowe n spacje.
See SPRAWOZDANIA.

-bls, --braces-after-struct-decl-line
Umieść nawiasy klamrowe na linii po struct wiersze deklaracji.
See DEKLARACJE.

- br, --nawiasy klamrowe-w-lirze
Umieść nawiasy klamrowe w linii z if, itp.
See SPRAWOZDANIA.

-brf, --nawiasy klamrowe na linii-funkcji-def
Umieść nawiasy klamrowe na linii definicji funkcji.
See DEKLARACJE.

-brs, --braces-on-struct-decl-line
Załóż szelki struct wiersz deklaracji.
See DEKLARACJE.

-bs, --Bill-Shannon, --puste-przed-rozmiarem
Wstaw spację pomiędzy rozmiar i jego argument.
See SPRAWOZDANIA.

-cn, --wcięcie-komentarzan
Umieść komentarze po prawej stronie kodu w kolumnie n.
See KOMENTARZE.

-cbin, --wcięcie nawiasów klamrowychn
Wcięcie nawiasów klamrowych po etykiecie sprawy N spacji.
See SPRAWOZDANIA.

-Płyta CDn, --kolumna-komentarza-deklaracjin
Umieść komentarze po prawej stronie deklaracji w kolumnie n.
See KOMENTARZE.

-cdb, --komentarz-ograniczniki-na-pustych-wierszach
Umieść ograniczniki komentarzy w pustych wierszach.
See KOMENTARZE.

-cdw, --przytul-do-na-czasie
Przytul podczas do {} chwila; i poprzedzający „}”.
See KOMENTARZE.

-to, --cuddle-inaczej
Cuddle else i poprzedzające „}”.
See KOMENTARZE.

-ton, --kontynuacja-wcięcian
Kontynuacja tiret n spacje.
See SPRAWOZDANIA.

-klin, --wcięcie-wielkości litern
Wcięcie etykiety koperty z n spacje.
See SPRAWOZDANIA.

-cpn, --else-endif-kolumnan
Umieść komentarze po prawej stronie #else i #endif oświadczenia w kolumnie n.
See KOMENTARZE.

-cs, --spacja-po-rzutowaniu
Umieść spację po operatorze rzutowania.
See SPRAWOZDANIA.

-dn, --linii-komentarze-wcięcien
Ustaw wcięcie komentarzy nie po prawej stronie kodu n spacje.
See KOMENTARZE.

-bfda, --break-funkcja-decl-args
Przerwij linię przed wszystkimi argumentami w deklaracji.
See DEKLARACJE.

-bfde, --break-funkcja-decl-args-end
Przerwij linię po ostatnim argumencie w deklaracji.
See DEKLARACJE.

-Dj, --left-justify-deklaracje
Jeśli użyto -cd 0, to komentarze po deklaracjach zostają wyrównane
deklaracja.
See DEKLARACJE.

-dun, --deklaracja-wcięcien
Umieść zmienne w kolumnie n.
See DEKLARACJE.

-fc1, --format-pierwszej-kolumny-komentarze
Sformatuj komentarze w pierwszej kolumnie.
See KOMENTARZE.

-fca, --format-wszystkie-komentarze
Nie wyłączaj całego formatowania komentarzy.
See KOMENTARZE.

-gnu antylopa, --styl-gnu
Użyj stylu kodowania GNU. To jest ustawienie domyślne.
See WSPÓLNY STYLE.

-hnl, --honor-nowe wiersze
Wolisz łamać długie linie w miejscu nowych linii na wejściu.
See BREAKING DŁUGIE LINIE.

-in, --poziom wcięcian
Ustaw poziom wcięcia na n spacje.
See WCIĘCIE.

-onn, --indent-etykietan
Ustaw przesunięcie dla etykiet na kolumnę n.
See WCIĘCIE.

-IPn, --wcięcie-parametrun
Wcinaj typy parametrów w definicjach funkcji w starym stylu według n spacje.
See WCIĘCIE.

-kr, --k-i-r-styl
Użyj stylu kodowania Kernighan & Ritchie.
See WSPÓLNY STYLE.

-ln, --linia-długośćn
Ustaw maksymalną długość linii dla linii bez komentarza na n.
See BREAKING DŁUGIE LINIE.

-lcn, --długość-linii-komentarzan
Ustaw maksymalną długość linii dla formatowania komentarzy na n.
See KOMENTARZE.

-linux, --w stylu Linuksa
Użyj stylu kodowania Linuksa.
See WSPÓLNY STYLE.

-lp, --kontynuuj-w-nawiasach
Ustaw ciąg dalszy linii w nawiasach.
See WCIĘCIE.

-lps, --leave-preprocesor-space
Pozostaw spację między „#” a dyrektywą preprocesora.
See WCIĘCIE.

-nzły, --brak-pustych-linii-po-deklaracjach
Nie wymuszaj pustych linii po deklaracjach.
See BLANK LINIE.

-nbap, --bez-pustych-linii-po-procedurach
Nie wymuszaj pustych wierszy po ciałach procedur.
See BLANK LINIE.

-nbo, --break-po-boolowskim-operatorze
Nie preferuj łamania długich linii przed operatorami boolowskimi.
See BREAKING DŁUGIE LINIE.

-nbc, --bez-pustych-linii-po-przecinkach
Nie wymuszaj nowych wierszy po przecinkach w deklaracjach.
See DEKLARACJE.

-nbfda, --dont-break-function-decl-args
Nie umieszczaj każdego argumentu w deklaracji funkcji w osobnej linii.
See DEKLARACJE.

-ncdb, --no-comment-ograniczniki-na-pustych-wierszach
Nie umieszczaj ograniczników komentarzy w pustych wierszach.
See KOMENTARZE.

-ncdw, --nie-przytulaj-do-podczas-
Nie przytulaj się } oraz Podczas z do {} chwila;.
See SPRAWOZDANIA.

-ce, --nie-przytulaj-innego
Nie przytulaj się } i więcej.
See SPRAWOZDANIA.

-ncs, --bez spacji po rzutach
Nie stawiaj spacji po operatorach rzutowania.
See SPRAWOZDANIA.

-ndjn, --dont-left-justify-deklaracje
Komentarze po deklaracjach są traktowane tak samo jak komentarze po innych instrukcjach.
See DEKLARACJE.

-NFC1, --dont-format-pierwsza-kolumna-komentarze
Nie formatuj komentarzy w pierwszej kolumnie w normalny sposób.
See KOMENTARZE.

-NFCA, --nie formatuj komentarzy
Nie formatuj żadnych komentarzy.
See KOMENTARZE.

-nhnl, --ignore-nowe wiersze
Nie preferuj łamania długich linii w miejscu znaku nowej linii na wejściu.
See BREAKING DŁUGIE LINIE.

-skakać, --brak wcięcia parametru
Wcięcie o zerowej szerokości dla parametrów.
See WCIĘCIE.

-nlp, --dont-line-up-nawiasów
Nie ustawiaj nawiasów w linii.
See SPRAWOZDANIA.

-nszt, --no-spacja-po-nazwach-wywołań-funkcji
Nie umieszczaj spacji po funkcji w wywołaniach funkcji.
See SPRAWOZDANIA.

-npr, --bez-spacji-po-nawiasach
Nie stawiaj spacji po każdym „(” i przed każdym „)”.
See SPRAWOZDANIA.

-npl, --dont-break-typ-procedury
Umieść typ procedury w tym samym wierszu co jej nazwę.
See DEKLARACJE.

-nsaf, --brak-spacji-po-dla
Nie stawiaj spacji po każdym dla.
See SPRAWOZDANIA.

-nsai, --brak-spacji-po-jeżeli
Nie stawiaj spacji po każdym if.
See SPRAWOZDANIA.

-widzę, --brak-spacji-po-czasie
Nie stawiaj spacji po każdym Podczas.
See SPRAWOZDANIA.

-nsc, --nie-gwiazdkuj-komentarzy
Nie umieszczaj znaku „*” po lewej stronie komentarzy.
See KOMENTARZE.

-nsob, --leave-opcjonalne-puste-linie
Nie połykaj opcjonalnych pustych linii.
See BLANK LINIE.

-nss, --dont-spacja-specjalny-średnik
Nie wymuszaj spacji przed średnikiem po niektórych stwierdzeniach. Wyłącza „-ss”.
See SPRAWOZDANIA.

-orzech, --bez zakładek
Używaj spacji zamiast tabulatorów.
See WCIĘCIE.

-nv, --brak gadatliwości
Wyłącz tryb pełny.
See RÓŻNE OPCJE.

-oryg, --oryginał
Użyj oryginalnego stylu kodowania Berkeley.
See WSPÓLNY STYLE.

-npro, --ignore-profil
Nie czytaj plików „.indent.pro”.
See WYWOŁYWANIE AKAPIT.

-szt, --wywołania-spacji-po-procedurze
Wstaw spację między nazwą wywoływanej procedury a znakiem „(”.
See SPRAWOZDANIA.

-Liczba Pin, --wcięcie-nawiasun
Określ dodatkowe wcięcie w otwartych nawiasach „(”, gdy instrukcja jest zepsuta. Zobacz
SPRAWOZDANIA.

-po południu, --zachowaj-mtime
Zachowaj czasy dostępu i modyfikacji w plikach wyjściowych. Zobacz RÓŻNE OPCJE.

-ppin, --wcięcie-preprocesoran
Określ wcięcie dla instrukcji warunkowych preprocesora. Zobacz WCIĘCIE.

-pr, --spacja-po-nawiasach
Umieść spację po każdym „(” i przed każdym „)”.
See SPRAWOZDANIA.

-psl, --procnames-linie-startowe
Umieść rodzaj procedury w wierszu przed jej nazwą.
See DEKLARACJE.

-bezpieczny, --spacja-po-dla
Po każdym wstaw spację dla.
See SPRAWOZDANIA.

-saj, --odstęp-po-jeśli
Po każdym wstaw spację if.
See SPRAWOZDANIA.

-Piła, --przestrzeń-po-czasie
Po każdym wstaw spację Podczas.
See SPRAWOZDANIA.

-sbin, --struct-brace-indentationn
Wcięcie nawiasów klamrowych struktury, unii lub wyliczenia N spacji.
See SPRAWOZDANIA.

-sc, --start-lewa-strona-komentarzy
Umieść znak „*” po lewej stronie komentarzy.
See KOMENTARZE.

-szloch, --swallow-opcjonalne-puste-linie
Połknij opcjonalne puste linie.
See BLANK LINIE.

-ss, --spacja-specjalny-średnik
Na jednej linii dla i Podczas oświadczenia, wymuś spację przed średnikiem.
See SPRAWOZDANIA.

-st, --standard-wyjście
Wypisz na standardowe wyjście.
See WYWOŁYWANIE AKAPIT.

-T Powiedzieć wcięcie nazwy typów.
See DEKLARACJE.

-tsn, --rozmiar tabulatoran
Ustaw rozmiar karty na n spacje.
See WCIĘCIE.

-ut, --użyj zakładek
Użyj zakładek. To jest ustawienie domyślne.
See WCIĘCIE.

-v, --gadatliwy
Włącz tryb pełny.
See RÓŻNE OPCJE.

-wersja
Wypisz numer wersji wcięcie.
See RÓŻNE OPCJE.

WYWOŁYWANIE AKAPIT

Od wersji 1.3 format pliku wcięcie polecenie to:

akapit [Opcje] [pliki-wejściowe]

akapit [Opcje] [pojedynczy plik wejściowy] [-O plik wyjściowy]

Ten format różni się od wcześniejszych wersji i innych wersji programu wcięcie.

W pierwszym formularzu określony jest jeden lub więcej plików wejściowych. wcięcie wykonuje kopię zapasową
każdy plik, a oryginalny plik jest zastępowany jego wersją z wcięciami. Widzieć BACKUP AKTA,
w celu wyjaśnienia sposobu tworzenia kopii zapasowych.

W drugim formularzu określony jest tylko jeden plik wejściowy. W tym przypadku lub gdy standard
używane jest wejście, możesz określić plik wyjściowy po opcji „-o”.

Powodować wcięcie aby pisać na standardowe wyjście, użyj opcji „-st”. To jest dozwolone
gdy jest tylko jeden plik wejściowy lub gdy używane jest standardowe wejście.

Jeśli żadne pliki wejściowe nie są nazwane, odczytywane jest wejście standardowe. Ponadto, jeśli nazwa pliku
o nazwie „-”, wówczas odczytywane jest standardowe wejście.

Na przykład każde z poniższych poleceń wprowadzi program „slithy_toves.c” i
napisz wcięty tekst do „slithy_toves.out”:

wcięcie slithy_toves.c -o slithy_toves.out

wcięcie -st slithy_toves.c > slithy_toves.out

kot slithy_toves.c | wcięcie -o slithy_toves.out

Większość innych opcji do wcięcie kontrolować sposób formatowania programów. Od wersji 1.2,
wcięcie rozpoznaje również długą nazwę dla każdej nazwy opcji. Długie opcje są poprzedzone przez
„--” lub „+”. [ „+” jest zastępowane przez „--”, aby zachować spójność z
Standard POSIX.]
W większości tego dokumentu dla zachowania zwięzłości używane są tradycyjne, krótkie nazwy.
See OPCJA PODSUMOWANIE, aby wyświetlić listę opcji, zawierającą zarówno długie, jak i krótkie nazwy.

Oto kolejny przykład:

wcięcie -br test/metabolizm.c -l85

Spowoduje to wcięcie programu „test/metabolism.c” przy użyciu opcji „-br” i „-l85”, napisz
wyjście z powrotem do „test/metabolism.c” i zapisz oryginalną zawartość pliku
„test/metabolism.c” do pliku kopii zapasowej w katalogu „test”.

Równoważne wywołania używające długich nazw opcji dla tego przykładu to:

wcięcie --braces-on-line-line-length185 test/metabolism.c

wcięcie +nawiasy klamrowe-w-wierszu +długość-linii185 test/metabolism.c

Jeśli okaże się, że często używasz wcięcie z tymi samymi opcjami, możesz umieścić te opcje
do pliku o nazwie „.indent.pro”. wcięcie będzie szukać pliku profilu w trzech miejscach.
Najpierw sprawdzi zmienną środowiskową INDENT_PROFIL. Jeśli to istnieje, jego wartość jest
oczekuje się nazwy pliku, który ma być użyty. Jeśli zmienna środowiskowa nie istnieje,
indent szuka „.indent.pro” w bieżącym katalogu
i użyj tego, jeśli zostanie znalezione. Wreszcie wcięcie przeszuka twój katalog domowy w poszukiwaniu „.indent.pro”
i użyj tego pliku, jeśli zostanie znaleziony. To zachowanie różni się od zachowania innych wersji
of wcięcie, które ładują oba pliki, jeśli oba istnieją.

Format „.indent.pro” to po prostu lista opcji, tak jak pojawiają się one na
linii poleceń, oddzielonych białymi znakami (tabulacje, spacje i znaki nowej linii). Opcje w
„.indent.pro” może być otoczony komentarzami C lub C++, w takim przypadku są one ignorowane.

Obsługiwane są przełączniki wiersza poleceń po przetwarzanie „.indent.pro”. Opcje określone później
zastąp argumenty określone wcześniej, z jednym wyjątkiem: jawnie określone opcje
zawsze nadpisuj opcje tła (patrz WSPÓLNY STYLE). Możesz zapobiegać wcięcie od
odczytanie pliku „.indent.pro” przez podanie opcji „-npro”.

BACKUP AKTA

Od wersji 1.3 GNU wcięcie tworzy pliki kopii zapasowych w stylu GNU, w ten sam sposób, w jaki robi to GNU Emacs.
Oznacza to, że też prosty or numerowane można utworzyć kopie zapasowe nazw plików.

Proste nazwy plików kopii zapasowych są generowane przez dodanie sufiksu do oryginalnej nazwy pliku.
Wartością domyślną dla tego sufiksu jest jednoznakowy ciąg znaków „~” (tylda). Tym samym kopia zapasowa
plik dla „python.c” to „python.c~”.

Zamiast wartości domyślnej możesz określić dowolny ciąg znaków jako sufiks, ustawiając plik environment
zmienna SIMPLE_BACKUP_SUFFIX do preferowanego sufiksu.

Numerowane kopie zapasowe pliku „momeraths.c” wyglądają jak „momeraths.c.~23~”, gdzie 23 to
wersję tej konkretnej kopii zapasowej. Podczas tworzenia numerowanej kopii zapasowej pliku
„src/momeraths.c”, plik kopii zapasowej otrzyma nazwę „src/momeraths.c.~V~', gdzie V jest jeden
większa niż najwyższa wersja obecnie istniejąca w katalogu „src”. The
zmienna środowiskowa WERSJA_WIDTH kontroluje liczbę cyfr, używając dopełnienia lewym zerem
kiedy konieczne. Na przykład ustawienie tej zmiennej na „2” spowoduje utworzenie pliku kopii zapasowej
nazywa się „momeraths.c.~04~”.

Typ tworzonego pliku kopii zapasowej jest kontrolowany przez wartość zmiennej środowiskowej
KONTROLA WERSJI. Jeśli jest to ciąg „prosty”, wykonywane będą tylko proste kopie zapasowe. Jeśli
jego wartością jest ciąg 'numbered', wtedy zostaną wykonane numerowane kopie zapasowe. Jeśli jego wartość jest
„numerowane-istniejące”, wówczas zostaną wykonane ponumerowane kopie zapasowe, jeśli istnieją już istnieć numerowane
kopie zapasowe wcinanego pliku; w przeciwnym razie wykonywana jest prosta kopia zapasowa. Jeśli
KONTROLA WERSJI nie jest ustawiony, to wcięcie zakłada zachowanie „ponumerowane-istniejące”.

Inne wersje wcięcie używaj sufiksu „.BAK” w nazwach plików kopii zapasowych. To zachowanie może
być emulowane przez ustawienie SIMPLE_BACKUP_SUFFIX do '.BAK'.

Należy również zauważyć, że inne wersje wcięcie tworzyć kopie zapasowe w bieżącym katalogu, zamiast
w katalogu pliku źródłowego jako GNU wcięcie teraz tak.

WSPÓLNY STYLE

Istnieje kilka popularnych stylów kodu C, w tym styl GNU, styl Kernighana i
Styl Ritchiego i oryginalny styl Berkeley. Styl można wybrać za pomocą jednego
tło opcja, która określa zestaw wartości dla wszystkich innych opcji. Jednakże,
jawnie określone opcje zawsze zastępują opcje implikowane przez opcję tła.

Od wersji 1.2 domyślny styl GNU wcięcie jest w stylu GNU. Zatem nie jest
nie jest już konieczne określenie opcji „-gnu”, aby uzyskać ten format, chociaż tak się dzieje
nie spowoduje błędu. Ustawienia opcji odpowiadające stylowi GNU to:

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

Styl kodowania GNU jest preferowany przez projekt GNU. Jest to styl GNU
Tryb C Emacsa zachęca i który jest używany w częściach C GNU Emacsa. (Ludzie
zainteresowani pisaniem programów dla Projektu GNU powinni otrzymać egzemplarz „The GNU Coding
Standards”, który obejmuje również kwestie semantyczne i przenośności, takie jak użycie pamięci,
rozmiar liczb całkowitych itp.)

Styl Kernighana i Ritchie jest używany w ich dobrze znanej książce „Programowanie w C
Język”. Jest włączany za pomocą opcji „-kr”. Styl Kernighan & Ritchie
odpowiada następującemu zestawowi opcji:

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

Styl Kernighan & Ritchie nie umieszcza komentarzy po prawej stronie kodu w tej samej kolumnie w
przez cały czas (ani nie używa tylko jednej spacji po prawej stronie kodu), więc dla tego stylu
wcięcie wybrał arbitralnie kolumnę 33.

Styl oryginalnego Berkeley wcięcie można uzyskać, określając „-orig” (lub przez
określając „--original”, używając długiej nazwy opcji). Ten styl jest równoważny z
następujące ustawienia:

-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

Styl Linuksa jest używany w kodzie i sterownikach jądra Linuksa. Kod ogólnie musi podążać
zaakceptować styl kodowania Linuksa. Ten styl jest odpowiednikiem następującego
ustawienia:

-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

BLANK LINIE

Różne style programowania używają pustych linii w różnych miejscach. wcięcie ma wiele
opcje wstawiania lub usuwania pustych linii w określonych miejscach.

Opcja „-bad” powoduje wcięcie aby wymusić pustą linię po każdym bloku deklaracji.
Opcja „-nbad” powoduje wcięcie żeby nie zmuszać takich pustych linii.

Opcja '-bap' wymusza pustą linię po każdej treści procedury. Opcja „-nbap”.
wymusza brak takiej pustej linii.

Opcja „-bbb” wymusza wstawienie pustej linii przed każdym komentarzem w ramce (zob KOMENTARZE.)
Opcja '-nbbb' nie wymusza takich pustych linii.

Opcja „-sob” powoduje wcięcie do połknięcia opcjonalnych pustych linii (to znaczy dowolnych opcjonalnych
puste wiersze obecne na wejściu zostaną usunięte z wyjścia). Jeśli jest „-nsob”.
określony, wszelkie puste wiersze obecne w pliku wejściowym zostaną skopiowane do pliku wyjściowego.

--puste-wiersze-po-deklaracjach

Opcja '-bad' wymusza pustą linię po każdym bloku deklaracji. „-nzły”
opcja nie dodaje żadnych takich pustych linii.

Na przykład, biorąc pod uwagę dane wejściowe
znak *foo;
znak *pasek;
/* To rozdziela bloki deklaracji. */
int baza;

wcięcie -zły produkuje

znak *foo;
znak *pasek;

/* To rozdziela bloki deklaracji. */
int baza;

i wcięcie -nzły produkuje

znak *foo;
znak *pasek;
/* To rozdziela bloki deklaracji. */
int baza;

--puste-wiersze-po-procedurach

Opcja '-bap' wymusza pustą linię po każdej treści procedury.

Na przykład, biorąc pod uwagę dane wejściowe

int
bla ()
{
puts("Cześć");
}
/* Pasek procedur jest jeszcze mniej interesujący. */
znak *
bar ()
{
puts("Cześć");
}

wcięcie -bup produkuje

int
bla ()
{
stawia („Cześć”);
}

/* Pasek procedur jest jeszcze mniej interesujący. */
znak *
bar ()
{
stawia („Cześć”);
}

i wcięcie -nbap produkuje

int
bla ()
{
stawia („Cześć”);
}
/* Pasek procedur jest jeszcze mniej interesujący. */
znak *
bar ()
{
stawia („Cześć”);
}

Żadna pusta linia nie zostanie dodana po wykonaniu procedury bla.

KOMENTARZE

wcięcie formatuje komentarze C i C++. Komentarze C zaczynają się od '/*', kończą na
„*/” i może zawierać znaki nowej linii. Komentarze C++ zaczynają się od ogranicznika „//” i
koniec na nowej linii.

wcięcie obsługuje komentarze w różny sposób w zależności od ich kontekstu. wcięcie próby
rozróżnić komentarze, które następują po stwierdzeniach, komentarze, które następują po deklaracjach,
komentarze następujące po dyrektywach preprocesora i komentarze, które nie są poprzedzone kodem
dowolnego rodzaju, tj. rozpoczynają tekst wiersza (choć niekoniecznie w kolumnie 1).

wcięcie dalej rozróżnia komentarze znalezione poza procedurami i agregaty,
i tych, które się w nich znajdują. W szczególności komentarze zaczynające się od wiersza znalezionego w a
procedura zostanie wcięta do kolumny, w której kod jest aktualnie wcięty. The
wyjątkiem jest komentarz rozpoczynający się w skrajnej lewej kolumnie; taki komentarz jest wyprowadzany
przy tej kolumnie.

wcięcie próby wyjazdu zapakowane komentarze niemodyfikowany. Ogólna idea takiego komentarza jest taka
że jest zamknięty w prostokącie lub „pudełku” złożonym z gwiazdek lub kresek, aby go wizualnie wyróżnić.
Mówiąc dokładniej, komentarze w ramkach definiuje się jako te, w których następuje początkowy znak „/*”.
bezpośrednio przez znak „*”, „=”, „_” lub „-” lub te, w których początek
ogranicznik komentarza („/*”) znajduje się w osobnej linii, a następna linia zaczyna się od „*”
w tej samej kolumnie co gwiazda separatora otwierającego.

Przykłady komentarzy w ramkach to:

/***********************
* Komentarz w pudełku!! *
*************************/

/*
* Inny rodzaj zapachu,
* za inny rodzaj komentarza.
*/

wcięcie próbuje pozostawić komentarze w ramkach dokładnie tak, jak znajdują się w pliku źródłowym.
Tym samym wcięcie komentarza pozostaje niezmienione, a jego długość nie jest w żaden sposób sprawdzana
sposób. Jedyną wprowadzoną zmianą jest to, że osadzony znak tabulacji może zostać przekonwertowany na
odpowiednią liczbę miejsc.

Jeśli określono opcję „-bbb”, wszystkie takie komentarze w ramkach będą poprzedzone spacją
linii, chyba że taki komentarz jest poprzedzony kodem.

Komentarze, które nie są komentarzami w ramkach, mogą być sformatowane, co oznacza, że ​​linia jest
złamany, aby zmieścił się na prawym marginesie i wypełniony lewymi spacjami. Pojedyncze nowe linie są
odpowiednik spacji, ale puste wiersze (dwa lub więcej znaków nowej linii w rzędzie) oznaczają a
podział akapitu. Włączono formatowanie komentarzy rozpoczynających się po pierwszej kolumnie
z opcją „-fca”. Aby sformatować te, które zaczynają się w pierwszej kolumnie, podaj „-fc1”. Taki
formatowanie jest domyślnie wyłączone.

Prawy margines formatowania domyślnie wynosi 78, ale można go zmienić za pomocą opcji „-lc”.
Jeśli określony margines nie pozwala na wydrukowanie komentarza, zostanie on ustawiony
automatycznie przedłużony na czas trwania tego komentarza. Margines nie jest przestrzegany, jeśli
komentarz nie jest formatowany.

Jeśli komentarz zaczyna linię (tj. po jego lewej stronie nie ma tekstu programu), tak będzie
wcięty do kolumny, w której został znaleziony, chyba że komentarz znajduje się w bloku kodu. W
w takim przypadku taki komentarz zostanie wyrównany z wciętym kodem tego bloku (chyba że
komentarz zaczął się w pierwszej kolumnie). Na to wyrównanie może mieć wpływ opcja „-d”,
który określa kwotę, o jaką takie komentarze są przenoszone do lewolub bez wcięcia.
Na przykład „-d2” umieszcza komentarze o dwie spacje po lewej stronie kodu. Domyślnie komentarze
są wyrównane z kodem, chyba że zaczynają się w pierwszej kolumnie, w takim przypadku są pozostawione
tam domyślnie --- aby wyrównać je z kodem, podaj „-fc1”.

Komentarze po prawej stronie kodu pojawią się domyślnie w kolumnie 33. Można to zmienić
z jedną z trzech opcji. „-c” określi kolumnę dla komentarzy po kodzie,
„-cd” określa kolumnę komentarzy następujących po deklaracjach, a „-cp” określa kolumnę
kolumna dla komentarzy następujących po dyrektywach preprocesora #else i #endif. „-dj” razem
z „-cd0” można użyć do wyeliminowania wyrównania komentarzy na prawo od deklaracji,
powodując, że komentarz podąża za jednym tabulatorem od końca deklaracji. Normalnie „-cd0”
powoduje, że „-c” staje się skuteczne.

Jeśli kod po lewej stronie komentarza przekracza początkową kolumnę, kolumna komentarza
zostanie rozszerzony do następnej kolumny tabulatora poza końcem kodu lub w przypadku
dyrektyw preprocesora, o jedną spację za końcem dyrektywy. To przedłużenie trwa
tylko dla danych wyjściowych tego konkretnego komentarza.

Opcja '-cdb' umieszcza ograniczniki komentarzy w pustych wierszach. W ten sposób pojedyncza linia
komentuj jak /* Kochający przytulić */ można przekształcić w:

/*
Kochający uścisk
*/

Gwiazdki można umieszczać na początku wielowierszowych komentarzy za pomocą opcji „-sc”. Zatem,
powyższy jednowierszowy komentarz można przekształcić (za pomocą „-cdb -sc”) w:

/*
* Kochający uścisk
*/

SPRAWOZDANIA

Opcja „-br” lub „-bl” określa sposób formatowania nawiasów klamrowych.

Opcja „-br” formatuje nawiasy klamrowe w następujący sposób:

jeśli (x > 0) {
X--;
}

Opcja „-bl” formatuje je w następujący sposób:

jeśli (x > 0)
{
X--;
}

Jeśli używasz opcji „-bl”, możesz również określić opcję „-bli”. Ta opcja
określa liczbę spacji, o które są wcięte nawiasy klamrowe. Wartość domyślna „-bli2” daje
wynik pokazany powyżej. „-bli0” skutkuje następującym wynikiem:

jeśli (x > 0)
{
X--;
}

Jeśli używasz opcji „-br”, prawdopodobnie chcesz również użyć opcji „-ce”. Ten
powoduje więcej w konstrukcie „jeżeli-to-jeszcze” przytulić się do bezpośrednio poprzedzającego
'}'. Na przykład z „-br -ce” otrzymasz:

jeśli (x > 0) {
X--;
} Else {
fprintf (stderr, "...coś nie tak?\n");
}

Z „-br -nce” ten kod pojawiłby się jako

jeśli (x > 0) {
X--;
}
else {
fprintf (stderr, "...coś nie tak?\n");
}

To powoduje Podczas w pętli do-while, aby przytulić się do bezpośrednio poprzedzającego „}”.
Na przykład z „-cdw” otrzymasz:

zrobić {
X--;
} podczas (x);

Z „-ncdw” ten kod pojawiłby się jako

zrobić {
X--;
}
podczas gdy (x);

Opcja '-cli' określa liczbę spacji, o jaką powinny być wcięte etykiety przypadków
prawo zawierające wyłącznik komunikat.

Domyślnie daje kod taki jak:

przełącznik (ja)
{
przypadek 0:
break;
przypadek 1:
{
++i;
}
domyślna:
break;
}

Używając „-cli2”, który stałby się:

przełącznik (ja)
{
przypadek 0:
break;
przypadek 1:
{
++i;
}
domyślna:
break;
}

Wcięcie nawiasów klamrowych poniżej instrukcji case można kontrolować za pomocą opcji „-cbin"
opcja. Na przykład użycie „-cli2 -cbi0” powoduje:

przełącznik (ja)
{
przypadek 0:
break;
przypadek 1:
{
++i;
}
domyślna:
break;
}

Jeśli średnik znajduje się w tym samym wierszu co a dla or Podczas instrukcja, opcja „-ss” to zrobi
powoduje wstawienie spacji przed średnikiem. To podkreśla średnik, czyniąc go
jasne, że ciało dla or Podczas stwierdzenie jest pustym stwierdzeniem. „-nss” wyłącza
ta cecha.

Opcja '-pcs' powoduje wstawienie spacji pomiędzy nazwą wykonywanej procedury
o nazwie i „(” (np. stawia ("Cześć");. Opcja „-npcs” dałaby
puts("Cześć");).

Jeśli określono opcję „-cs”, wcięcie wstawia spację między operatorem rzutowania a operatorem
obiekt do odlewania. „-ncs” zapewnia, że ​​nie ma spacji między operatorem rzutowania a
obiekt. Zapamietaj to wcięcie wie tylko o standardowych typach danych C, więc nie może
rozpoznawać typy zdefiniowane przez użytkownika w rzutowaniach. Zatem (mój typ) rzecz nie jest traktowany jako odlew.

Opcja „-bs” zapewnia spację między słowem kluczowym rozmiar i jego
argument. W niektórych wersjach jest to znane jako opcja „Bill_Shannon”.

Opcja „-saf” wymusza spację między a dla i następujący nawias. To jest
domyślna.

Opcja „-sai” wymusza spację między a if i następujący nawias. To jest
domyślna.

Opcja „-saw” wymusza spację między a Podczas i następujący nawias. To jest
domyślny.

Opcja '-prs' powoduje, że wszystkie nawiasy są oddzielone spacją od tego, co jest
między nimi. Na przykład użycie „-prs” skutkuje kodem takim jak:

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

DEKLARACJE

Domyślnie wcięcie ustawi identyfikatory w kolumnie określonej opcją '-di'.
Na przykład „-di16” sprawia, że ​​rzeczy wyglądają tak:

int foo;
znak *pasek;

Użycie małej wartości (takiej jak jeden lub dwa) dla opcji „-di” może spowodować, że
identyfikatory do umieszczenia na pierwszej dostępnej pozycji; Na przykład:

int foo;
znak *pasek;

Wartość podana opcji „-di” nadal będzie miała wpływ na zmienne, które są umieszczane osobno
linie z ich typów, na przykład „-di2” doprowadzą do:

int
bla;

Jeśli podano opcję '-bc', po każdym przecinku w deklaracji wymuszana jest nowa linia.
Na przykład,

int a,
b,
c;

Z opcją „-nbc” wyglądałoby to tak

int a, b, c;

Opcja '-bfda' powoduje wymuszenie nowej linii po przecinku oddzielającym argumenty
deklaracji funkcji. Argumenty pojawią się na poziomie o jedno wcięcie głębszym niż
deklaracja funkcji. Jest to szczególnie przydatne w przypadku funkcji z długimi argumentami
listy. Opcja '-bfde' powoduje wymuszenie nowej linii przed nawiasem zamykającym
deklaracja funkcji. Dla obu opcji wartością domyślną jest ustawienie 'n': -nbdfa i -nbdfe.

Na przykład,

void foo (int arg1, char arg2, int *arg3, long arg4, char arg5);
Z opcją „-bfda” wyglądałoby to tak

pustka foo (
int arg1,
znak arg2,
int *arg3,
długi arg4,
znak arg5);

Z dodatkowo opcją '-bfde' wyglądałoby to tak

pustka foo (
int arg1,
znak arg2,
int *arg3,
długi arg4,
znak arg5
);

Opcja '-psl' powoduje umieszczenie w wierszu typu definiowanej procedury
przed nazwą procedury. Ten styl jest wymagany dla etagi program do pracy
poprawnie, a także niektóre z tryb c funkcje Emacsa.

Aby to stwierdzić, musisz użyć opcji „-T”. wcięcie nazwa wszystkich nazw typów w twoim programie
które są określone przez typedef. „-T” można określić więcej niż jeden raz i wszystkie nazwy
określone są używane. Na przykład, jeśli twój program zawiera

typedef długi bez znaku CODE_ADDR;
typedef enum {czerwony, niebieski, zielony} KOLOR;

użyłbyś opcji „-T CODE_ADDR -T COLOR”.

Opcja „-brs” lub „-bls” określa sposób formatowania nawiasów klamrowych w deklaracjach struktury. The
Opcja „-brs” formatuje nawiasy klamrowe w następujący sposób:

struktura foo {
intx;
};

Opcja „-bls” formatuje je w następujący sposób:

struktura foo
{
intx;
};

Podobnie jak opcje nawiasów strukturalnych '-brs' i '-bls',
opcje nawiasów klamrowych funkcji „-brf” lub „-blf” określają sposób formatowania nawiasów klamrowych w funkcji
definicje. Opcja „-brf” formatuje nawiasy klamrowe w następujący sposób:

int jeden(pusty) {
1 wrócić;
};

Opcja „-blf” formatuje je w następujący sposób:

int jeden (pusty)
{
1 wrócić;
};

WCIĘCIE

Jednym z problemów związanych z formatowaniem kodu jest to, jak daleko należy wciąć każdą linię od lewej strony
margines. Kiedy początek oświadczenia, takiego jak if or dla napotkany,
poziom wcięcia jest zwiększany o wartość określoną opcją '-i'. Na przykład,
użyj „-i8”, aby określić wcięcie ośmiu znaków dla każdego poziomu. Kiedy jest oświadczenie
podzielone na dwie linie, druga linia jest wcięta o kilka dodatkowych spacji
określone przez opcję '-ci'. Wartość domyślna '-ci' to 0. Jednakże, jeśli jest to opcja '-lp'
określony, a linia ma lewy nawias, który nie jest zamknięty w tym wierszu
linie kontynuacji zostaną ustawione tak, aby zaczynały się od pozycji znaku zaraz po lewej stronie
nawias. To przetwarzanie dotyczy również „[” i ma zastosowanie do „{”, gdy występuje w
listy inicjalizacyjne. Na przykład fragment dalszego kodu może wyglądać tak z
Efekt „-nlp -ci3”:

p1 = pierwsza_procedura (druga_procedura (p2, p3),
trzecia_procedura (p4, p5));

Z efektem „-lp” kod wygląda nieco jaśniej:

p1 = pierwsza_procedura (druga_procedura (p2, p3),
trzecia_procedura (p4, p5));

Gdy instrukcja jest podzielona między dwie lub więcej par nadrzędnych (...), każda dodatkowa para
powoduje dodatkowe wcięcie poziomu wcięcia:

jeśli ((((i < 2 &&
k > 0) || p == 0) &&
q == 1) ||
n = 0)

Opcja „-ipN' można użyć do ustawienia dodatkowego przesunięcia na paren. Na przykład „-ip0”
sformatuje powyższe jako:

jeśli ((((i < 2 &&
k > 0) || p == 0) &&
q == 1) ||
n = 0)

wcięcie zakłada, że ​​tabulatory są umieszczane w regularnych odstępach zarówno wejścia, jak i wyjścia
strumienie znaków. Interwały te mają domyślnie szerokość 8 kolumn, ale (od wersji 1.2)
można zmienić opcją '-ts'. Tabulatory są traktowane jako równoważna liczba spacji.

Wcięcie deklaracji typu w definicjach funkcji w starym stylu jest kontrolowane przez
parametr „-ip”. Jest to parametr liczbowy określający liczbę spacji do wcięcia
deklaracje typów. Na przykład domyślna wartość „-ip5” sprawia, że ​​definicje wyglądają następująco:

znak *
utwórz_świat (x, y, skala)
intx;
int y;
skala pływakowa;
{
. . .
}

Aby zapewnić kompatybilność z innymi wersjami wcięcia, dostępna jest opcja „-nip”.
odpowiednik „-ip0”.

ANSI C umożliwia umieszczanie białych znaków w wierszach poleceń preprocesora między znakami
„#” i nazwę polecenia. Domyślnie, wcięcie usuwa to miejsce, ale określając
Opcja „-lps” kieruje wcięcie pozostawić tę przestrzeń niezmienioną. Opcja „-ppi” zastępuje
„-nlps” i „-lps”.

Tej opcji można użyć, aby zażądać, aby instrukcje warunkowe preprocesora mogły być
wcięte przez do podanej liczby spacji, na przykład z opcją „-ppi 3”

#jeśli X
#jeśli Y
#definiuj Z 1
#else
#definiuj Z 0
#endif
#endif
staje się
#jeśli X
# jeśli Y
# zdefiniuj Z 1
# w przeciwnym razie
# zdefiniuj Z 0
# koniec
#endif

Ta opcja ustawia przesunięcie, w którym zostanie umieszczona etykieta (z wyjątkiem etykiet wielkości liter). Jeśli
jest ustawiony na zero lub liczbę dodatnią, wskazuje to, jak daleko od lewego marginesu do
wciąć etykietę. Jeśli jest ustawiona na liczbę ujemną, wskazuje, jak daleko wstecz od
bieżący poziom wcięcia, aby umieścić etykietę. Domyślnym ustawieniem jest -2, co odpowiada
zachowanie wcześniejszych wersji wcięcia. Należy zauważyć, że ten parametr nie wpływa na
umieszczanie etykiet na skrzyniach; zobacz parametr „-cli”. Na przykład z opcją
'-il 1'

grupa
funkcjonować()
{
if (do_stuff1() == BŁĄD)
przejdź do czyszczenia1;

if (do_stuff2() == BŁĄD)
przejdź do czyszczenia2;

powrót SUKCES;

sprzątanie 2:
wykonaj_czyszczenie2();

sprzątanie 1:
wykonaj_czyszczenie1();

powrót BŁĄD;
}
staje się
grupa
funkcjonować()
{
if (do_stuff1() == BŁĄD)
przejdź do czyszczenia1;

if (do_stuff2() == BŁĄD)
przejdź do czyszczenia2;

powrót SUKCES;

sprzątanie 2:
wykonaj_czyszczenie2();

sprzątanie 1:
wykonaj_czyszczenie1();

powrót BŁĄD;
}

BREAKING DŁUGIE LINIE

Z opcją „-ln' lub '--długość-liniin', możliwe jest określenie maksymalnej długości
wiersza kodu C, nie uwzględniając możliwych komentarzy, które po nim następują.

Kiedy linie stają się dłuższe niż określona długość linii, GNU wcięcie próbuje przełamać
linia w logicznym miejscu. Jest to jednak nowość od wersji 2.1 i niezbyt inteligentna
lub jeszcze elastyczny.

Obecnie istnieją dwie opcje, które pozwalają na ingerencję w algorytm
określa, gdzie przerwać linię.

Opcja „-bbo” powoduje, że GNU wcięcie preferować łamanie długich linii przed wartością logiczną
operatorzy && i ||. Opcja „-nbbo” powoduje, że GNU wcięcie nie mieć takich preferencji. Dla
na przykład domyślna opcja „-bbo” (wraz z „--line-length60” i „--ignore-
newlines') sprawia, że ​​kod wygląda tak:

jeśli (maska
&& ((maska[0] == '\0')
|| (maska[1] == '\0'
&& ((maska[0] == '0') || (maska[0] == '*')))))

Użycie opcji „-nbbo” sprawi, że będzie wyglądać tak:

if (maska ​​&&
((maska[0] == '\0') ||
(maska[1] == '\0' &&
((maska[0] == '0') || (maska[0] == '*')))))

Jednak domyślne '-hnl' honoruje znaki nowej linii w pliku wejściowym, nadając im najwyższą wartość
możliwy priorytet przerwania linii w. Na przykład, gdy plik wejściowy wygląda tak:

jeśli (maska
&& ((maska[0] == '\0')
|| (maska[1] == '\0' && ((maska[0] == '0') || (maska[0] == '*')))))

następnie używając opcji „-hnl” lub „--honour-newlines” wraz z poprzednio
wspomniane „-nbbo” i „--line-length60”, spowoduje, że dane wyjściowe nie będą takie, jak podano w
ostatni przykład, ale zamiast tego woli przerwać w pozycjach, w których znajdował się kod
uszkodzony w pliku wejściowym:

jeśli (maska
&& ((maska[0] == '\0')
|| (maska[1] == '\0' &&
((maska[0] == '0') || (maska[0] == '*')))))

Ideą tej opcji jest to, że linie, które są zbyt długie, ale są już podzielone,
nie zostanie dotknięty przez GNU wcięcie. Naprawdę niechlujny kod powinien zostać przejrzany wcięcie at
przynajmniej raz, używając opcji „--ignore-newlines”.

WYŁĄCZENIE FORMATOWANIE

Formatowanie kodu C można wyłączyć dla części programu przez osadzanie specjalnego
kontrola komentarze w programie. Aby wyłączyć formatowanie dla sekcji programu, umieść
wyłączający komentarz kontrolny /* *WCIĘCIE-WYŁ.* */ na samej linii tuż przed tym
Sekcja. Tekst programu zeskanowany po tym komentarzu sterującym jest wyprowadzany dokładnie jako dane wejściowe
bez modyfikacji, dopóki odpowiedni komentarz zezwalający nie zostanie zeskanowany w wierszu
samo. Komentarz kontrolny wyłączający to /* *WCIĘCIE WŁ.* */i dowolny tekst następujący po
komentarz w wierszu jest również wyprowadzany w postaci niesformatowanej. Formatowanie rozpoczyna się ponownie od wprowadzenia
linii następującej po włączającym komentarzu sterującym.

Dokładniej, wcięcie nie próbuje zweryfikować zamykającego ogranicznika (*/) dla tych C
komentarze, a wszelkie białe znaki w wierszu są całkowicie przezroczyste.

Te komentarze kontrolne działają również w ich formatach C++, a mianowicie // *WCIĘCIE-WYŁ.* i //
*WCIĘCIE WŁ.*.

Należy zauważyć, że stan wewnętrzny wcięcie pozostaje niezmieniona przez cały czas
niesformatowana sekcja. Na przykład wyłączenie formatowania w środku pliku a
funkcji i kontynuowanie jej po zakończeniu funkcji może prowadzić do dziwnych rezultatów. To
dlatego mądrze jest być nieco modułowym w wyborze kodu, który ma pozostać niesformatowany.

Jako uwaga historyczna, niektóre wcześniejsze wersje wcięcie produkowane komunikaty o błędach początek
w *AKAPIT**. Te wersje wcięcie zostały napisane tak, aby ignorować wszelkie wprowadzane wiersze tekstu
które zaczęły się od takich komunikatów o błędach. Usunąłem tę kazirodczą funkcję z GNU
wcięcie.

RÓŻNE OPCJE

Aby dowiedzieć się, która wersja wcięcie masz, użyj polecenia wcięcie -wersja. To będzie
podaj numer wersji wcięcie, bez wykonywania normalnego przetwarzania.

Opcja „-v” może być użyta do włączenia trybu szczegółowego. W trybie szczegółowym wcięcie Raporty
kiedy dzieli jedną linię wejścia na dwie kolejne linie wyjścia i podaje pewien rozmiar
statystyki na koniec.

Opcja „-pmt” powoduje wcięcie aby zachować czasy dostępu i modyfikacji w
pliki wyjściowe. Korzystanie z tej opcji ma tę zaletę, że uruchamianie wcięć na wszystkich źródłach i
pliki nagłówkowe w projekcie nie spowodują robić odbudować wszystkie cele. Ta opcja jest tylko
dostępne w systemach operacyjnych z POSIX czas(2) funkcja.

Korzystaj z wcięć online, korzystając z usług onworks.net