bcpp - Online sa Cloud

PROGRAMA:

NAME

bcpp - gumawa ng C++ beautifier

SINOPSIS

bcpp [-bcl] [-bnl] [-cc ] [-f ]
[-fi ] [-fnc ] [-fo ] [-h] [-i
] [-lg] [-nc] [-qb] [-s] [-t] [-tbcl] [-tbnl] [ ] [ ]
[ ]

PANGKALAHATAN Opsyon

-bcl Buksan ang mga brace sa linya ng code

-bnl Buksan ang mga braces sa bagong linya

-cc
Column upang ihanay ang mga komento sa code

-f
Function line spacing

-fi
Ipasok ang pangalan ng file

-fnc
Mag-load ng custom na configuration file

-fo
Pangalan ng file output

-h, -? Ipakita ang mensahe ng tulong

-i
I-indent ang haba ng espasyo

-lg Mag-iwan ng mga graphic na karakter

-nc
Column upang ihanay ang mga komento na walang code

-qb
Tukuyin ang panloob na laki ng buffer ng pila

-s Gumamit ng mga puwang sa pag-indent

-t Gumamit ng mga tab sa pag-indent

-tbcl Top-level open braces sa linya ng code

-tbnl Top-level open braces sa bagong linya

PAYAGAN HINDI PAYAGAN Opsyon

Mga opsyon na nagsisimula sa -y o -n enable/disable functions, ayon sa pagkakabanggit.

-oo or nilikha
Buksan ang mga brace sa linya ng code

-yb or -nb
Backup input file na may .bac extension

-ybbi or -nbbi
Indent ang parehong braces ng isang block

-ybi or -nbi
Indent trailing brace ng block

-ykcwc or -nkcwc
Panatilihin ang mga komento sa Code

-ylcnc or -nlcnc
Mag-iwan ng mga komento sa NoCode

-yo or -hindi
Output ng programa

-yq or -nq
Baguhin ang mga hindi ASCII char sa mga quote sa octal

PANGKALAHATANG-IDEYA

Ang program na ito ay nagbibigay-daan sa isang user na i-reformat ang ilang partikular na elemento ng isang C, o C++ na source code. Ito
nakakatulong kung medyo hindi nababasa ang code ng isang tao, o na-indent sa isang istilong iyon
ayaw mo. Ang paggamit ng program na ito ay sana ay makakatulong sa muling pag-istilo ng code upang ito
malapit na nakakatugon sa iyong estilo. Gayunpaman, dahil sa maraming mga istilo ng C(++) na maaaring ma-code,
may mga limitasyon sa kung gaano kahusay pangasiwaan ng program na ito ang source code, at nagreresulta sa muling
na-format na pinagmulan.

Ang sumusunod ay isang listahan ng mga tampok na ipinatupad:

- Muling iposisyon ang mga komento sa ilang partikular na lokasyon.

- Alisin ang mga hindi napi-print na character na wala sa loob ng mga quote.

- I-convert ang mga hindi napi-print na character sa loob ng mga quote sa octal/character notation.

- Re-space line spacing sa pagitan ng mga function.

- I-trim ang mga trailing space mula sa lahat ng linya, pati na rin ang mga blangko na linya sa unahan at trailing
mula sa file.

- I-reposition ang opening braces sa Kernighan/Ritchie style, o sa Pascal style.

- Paggamit ng mga tab, o mga puwang sa pag-indent.

- Indensyon ng solong linyang code, ayon sa ilang partikular na pahayag ng kundisyon ng C,
kabilang ang mga naka-embed na SQL statement.

Kinakailangan

Ang program na ito ay tatakbo sa ilalim ng Microsoft DOS V3.3 at Unix platform.

Gumagamit ito ng humigit-kumulang 50 - 70k (o higit pa, depende sa laki ng panloob na pila) ng memorya
sa panahon ng pagpapatupad.

Ang program code ay isinulat sa paraang tugma sa umiiral na C++
compiler, gayunpaman ang code ay hindi pamantayan ng ANSI at maaaring mangailangan ng pagbabago para sa iyong
kapaligiran. Ang source code ay isinulat na may karaniwang ANSI at Posix function kaya
ang pinakamababang halaga ng muling pagsulat ay dapat na kailanganin kung muling mag-compile sa ibang computer
platform.

Ang kasalukuyang mga mapagkukunan ay pinagsama-sama gamit ang Turbo C++ V3.0, para sa MS-DOS, GNU G++ 2.7.2
sa ilalim ng Sun SPARCstation na tumatakbo sa SunOS, Solaris pati na rin sa mga workstation ng SGI na nagpapatakbo ng IRIX.

OPERASYON

Ang operasyon ng programa ay sa pamamagitan ng command line (CLI), at sa tulong mula sa isang configuration
file na maaari mong tukuyin ang iyong mga kinakailangan sa format. Karaniwang nagsisimula ang bawat direktiba ng command
isang gitling "-" ang sumunod sa aking pangalan ng utos. Kung kailangan ng isa pang parameter para sa utos, ang
Ang parameter ay idinagdag pagkatapos ng utos, at pinaghihiwalay ng puwang (ibig sabihin, bcpp -fi
input.cpp).

NB: Huwag ipasok ang bcpp.exe nang mag-isa para mahanap ang command help nito, gamitin ang bcpp -?, o bcpp -h.
Ito ay dahil sa pag-redirect ng input mula sa O/S. Pagpapanatiling sa Unix CLI convention, a
string na binabasa mula sa CLI at walang command directive ay itinuturing na a
input file. Kung mayroong dalawang ganoong pangyayari sa command line, ang magiging precedence
input file muna, at output file pangalawa (ibig sabihin, bcpp infile.cpp outfile.cpp -lg), isang pangatlo
ang ganitong pangyayari ay bubuo ng mensahe ng error.

Kung walang output file na ipinakita, ang ipinapalagay na output nito ay sa pamamagitan ng karaniwang output. Ito
awtomatikong pinapatay ang output ng programa. Ang mga parameter na ipinasok sa command line ay
i-override ang mga parameter na nabasa mula sa configuration file.

Halimbawa:
bcpp -fi input.cpp -f 2 -qb 5 -na -no -cc 60 > output.cpp

Buod

-fi input.cpp Input file = input.cpp
-f 2 Function spacing = 2
-qb 2 Panloob na Queue Buffer = 5
-na Alisin ang mga hindi ascii na karakter
-walang Pigilan ang output ng programa
-cc 60 Mga komento na lumalabas sa parehong linya bilang
ilalagay ang code sa column 60.
> output.cpp Ang output ng program ay na-redirect sa
"output.cpp"

Maaaring gamitin ang configuration file upang tukuyin ang karamihan sa mga hindi nagbabagong elemento sa
muling pag-format ng code. Ang configuration file ay binubuo ng ilang medyo mahahabang salita na
ay ginagamit upang ipaliwanag ang estilo ng output ng code. Gayunpaman ang pagtatakda ng mga parameter na ito ay napaka
madali, karaniwang binubuo sila ng dalawang uri, Boolean, o mga uri ng Integer. Gamit ang iyong paborito
text editor, maaari mong baguhin ang sumusunod sa loob ng configuration file ...

Ang mga sumusunod na parameter ay ilalagay sa loob ng configuration file (default ay
bcpp.cfg). Susubukan ng program na basahin ang default na configuration file sa program
pinagmulan (ibig sabihin kung aling landas ang bcpp ay pinatakbo). Gamit ang -fnc na opsyon maaari mong tukuyin ang isang custom
pangalan ng configuration file, at path mula sa CLI.

Mga Saklaw ng Uri ng Integer : 0 - 5000 Mga Saklaw ng Uri ng Boolean : Naka-on, Oo, o Naka-off, Hindi

Function_Spacing : Integer
Tinutukoy ng parameter na ito kung gaano karaming mga linya ang naghihiwalay sa dalawang function.

Halimbawa,
function_spacing = 2

CLI
-f 2

Use_Tabs: Boolean
Tinutukoy kung gagamit ng mga tab sa indenting code.

Halimbawa,
use_tabs = hindi

CLI
-t (I-on ang mga tab, ang default ay gumagamit ng mga puwang)
-s (Gumamit ng mga tab para sa pag-indent)

Indent_Spacing : Integer
Tinutukoy kung gaano karaming mga puwang ang i-indent. Itinatakda din ng parameter na ito ang lapad ng mga tab.
Itinuturing ng Bcpp na ang lapad ng isang tab ay kapareho ng lapad ng isang indent.

EG
indent_spacing = 4

CLI
-ako 4

Comments_With_Code : Integer
Tinutukoy ang column kung saan lalabas ang mga komento pagkatapos ng code sa isang linya
inilagay.

Halimbawa,
comments_with_code = 50

CLI
-cc 50

Comments_With_Nocode : Integer
Tinutukoy ang column kung saan ilalagay ang mga komentong lalabas sa isang linya.

Halimbawa,
comments_with_nocode = 0

CLI
-nc 0

Indent_Preprocessor: Boolean
Kung totoo, i-indent ng bcpp ang mga linya ng preprocessor sa indention ng C(++) code.
Kung mali, ang mga linya ng preprocessor ay nasa unang column. Hindi kinikilala (ibig sabihin,
nonstandard) na mga linya ng preprocessor ay palaging inilalagay sa unang column.

Indent_Exec_Sql: Boolean
Kung totoo, naghahanap ang bcpp ng mga naka-embed na SQL statement (hal., EXEC SQL), at mga format
lalo na sa kanila.

Keep_Comments_With_Code : Boolean
Ino-override ng opsyong ito ang opsyong "Comments_With_Code". I-set ang opsyong ito sa On
gagawa ng mga komentong hindi akma habang ang mga inline na komento ay nakadugtong sa code
pa rin.

Leave_Comments_NoCode : Boolean
Ino-override ng opsyong ito ang opsyong "Comments_With_Nocode." I-set ang opsyong ito sa On
ay mag-indent ng mga komento na hindi nangyayari sa parehong linya bilang code sa pareho
indensyon bilang code.

Halimbawa,
leave_comments_nocode = on

CLI
-nlcnc (I-off ang Leave_Comments_NoCode)
-ylcnc (I-on ang Leave_Comments_NoCode)

NonAscii_Quotes_To_Octal : Boolean
Gamitin ang opsyong ito para baguhin ang mga hindi ASCII (hindi napi-print) na mga character sa octal notation kung
namamalagi sila sa loob ng mga quotes. Ang parameter na ito ay hindi magkakabisa maliban kung alinman sa
Naitakda na ang mga parameter ng Ascii_Chars_Only o Leave_Graphic_Chars.

Halimbawa,
NonAscii_Quotes_to_Octal = hindi

CLI
-nq (I-off ang mga non-ascii char sa mga quote sa octal)
-yq (I-on ang mga non-ascii char sa mga quote sa octal)

Leave_Graphic_Chars : Boolean
Ang pagtatakda ng parameter na ito sa oo ay aalisin ang mga hindi napi-print na character mula sa
source file, ngunit iwanan ang anumang mga character na IBM graphics lamang. Anumang hindi-
Ang mga napi-print na character na nasa loob ng mga quote ay gagawing
octal/character notation, kung ang NonAscii_Quotes_To_Octal na parameter ay nakatakda sa True.

EG
leave_graphic_chars = oo

CLI
-lg

Ascii_Chars_Only : Boolean
Ang pagtatakda ng parameter na ito sa oo ay aalisin ang anumang hindi napi-print, hindi ASCII na mga character
mula sa input file. Ang anumang hindi napi-print na mga character na nasa loob ng mga quote ay magiging
binago sa octal/character notation kung ang NonAscii_Quotes_To_Octal ay nakatakda sa
totoo. Ikomento ang parameter na ito kung gumagamit ka ng Leave_Graphic_Chars parameter,
dahil i-override ito ng parameter na ito.

Halimbawa,
ascii_chars_only = oo

CLI
-na (Huwag alisin ang mga hindi ASCII na character)
-ya (Oo alisin ang mga hindi ASCII na character)

Place_Brace_On_New_Line : Boolean
Kapag nakatakda sa 'on' bcpp ay maglalagay ng opening braces sa mga bagong linya ("Pascal" style C
coding), kapag nakatakda sa 'off' bcpp ay gagamit ng "K&R" style C coding.

Pascal style C coding:
kung (kondisyon)
{
mga pahayag;
}

K&R style C coding:
kung (kondisyon) {
mga pahayag;
}

Halimbawa,
place_brace_on_new_line = on

CLI
-bnl (naka-on )
-bcl (naka-off)

Program_Output : Boolean
Ihihinto ng parameter na ito ang output mula sa program na sumisira sa output na maaaring lumabas
mula sa programa sa pamamagitan ng karaniwang output. Kung nakatakda ang parameter na ito sa off/no
pagkatapos ay walang output na nabuo mula sa programa, maliban kung ang isang error ay nakatagpo.
Ang karaniwang error ay ginagamit upang ipakita ang anumang mga error na nakatagpo habang pinoproseso.

EG
program_output = naka-off

CLI
-no (default ay bumuo ng output kung maaari, ito ay
pilitin ang output off)
-yo (i-on ang output ng programa kung maaari)

Queue_Buffer : Integer
Tinutukoy kung ano ang kailangan ng panloob na memorya sa laki ng linya
processing buffer. Ito ay ginagamit para sa open brace relocation sa Kernighan/Ritchie
istilo. Ang pagpapalawak ng buffer na ito sa malalaking halaga ng memorya ay magpapabagal sa pagproseso
maliliit na makina.

Halimbawa,
Queue_Buffer = 2

CLI
-qb 2

; : Hindi maaari
Ang paglalagay ng tuldok-kuwit sa unahan ng teksto ay ginagawa ang lahat pagkatapos ng tuldok-kuwit a
komento

Backup_File : Boolean
I-backup ng opsyong ito ang input file sa isang file na may extension na ".bac" at
i-overwrite ang input file gamit ang reformatted na bersyon.

Halimbawa,
backup_file = oo

CLI
-yb (oo, backup na input file kung maaari)
-nb (hindi, huwag mag-backup ng input file)

Pagkarga Configuration talaksan : CLI lamang

Ang Bcpp ay nagpapatupad ng setting ng configuration upang payagan ang pagpili ng custom na file mula sa isang partikular
path/file na tinukoy ng isang user.

Halimbawa,
bcpp input.cpp -yb (basahin ang bcpp.cfg configuration file
bago iproseso ang mga opsyon sa CLI)

bcpp -fnc /bin/bcpp.cfg (i-load ang configuration file sa
sinabing lokasyon)

CLI
-fnc (gamitin ang tinukoy ng gumagamit)

Pangalan ng File ng Input : CLI lang
Ang pagpipiliang ito ay nagdidirekta sa bcpp na basahin ang data sa isang ibinigay na landas, at pangalan ng file.

EG
bcpp -fi input.cpp > ​​output.cpp

CLI
-fi

Pangalan ng File ng Output : CLI lang
Tinutukoy nito ang pangalan ng file ng output kung saan isusulat ang data.

Halimbawa,
Kailangang maging ganito, (sa DOS, hindi bababa sa):

bcpp -fo output.cpp < input.cpp

ClI
-fo

Online na Tulong : CLI lang
Ang ilang online na tulong na maikli ngunit hanggang sa punto ay umiiral sa loob ng programa. Ang
help ay naglilista ng lahat ng CLI command na magagamit sa loob ng programa.

EG bcpp -h

CLI bcpp -?
bcpp -h

Configuration talaksan pagkakamali post

Kung mali ang pagpasok mo ng command/parameter sa loob ng configuration file, sa
executable program na nagbabasa nito, ang program ay bubuo ng mensahe ng error kasama nito
numero ng linya. Ang sumusunod ay isang paliwanag ng mga mensahe ng error na maaaring mangyari habang
pagbabasa ng mga parameter sa loob ng configuration file.

Syntax Error Pagkatapos ng Key Word :
Nagaganap ang error dahil mali ang character/salita pagkatapos ng isang parameter, o
inaasahan ang isa pang keyword (hal. =, Oo, Hindi, Naka-on, Naka-off)

Error sa Saklaw:
Nagaganap ang error kapag ang mga parameter ng integer ay may di-wastong setting ng numero (ibig sabihin, A
ang numero ay wala sa loob ng 0 - 5000).

Inaasahang Numeric Data :
Ang error na ito ay nangyayari kapag ang alpha-numeric na data ay kapalit ng numeric data para sa integer
uri ng mga parameter.

Hindi matukoy:
Ang parameter sa nasabing linya ay hindi wasto (ibig sabihin, hindi nakikilala).

Kung may anumang mga error na naganap pagkatapos basahin ang configuration file; sinenyasan ang gumagamit
na may [y/n] continuation prompt para ayusin ang (mga) error sa configuration dati
pagpoproseso, o magpatuloy sa kasalukuyang set na mga parameter.

Tumakbo oras Mali Sa panahon ng input talaksan Pagproseso

Nabigo ang Paglalaan ng Memorya :
Ang programa ay hindi nakapaglaan ng memorya upang iproseso ang data. Hihinto ang error na ito
pagproseso ng data.

Error sa Line Construction

Inaasahang Ilang Uri ng Code! Uri ng Data = ? :
Ang error na ito ay nabuo sa loob ng proseso ng pagbuo ng linya. Ang decoded line
mula sa input file ay maaaring masyadong hindi maintindihan para sa program na ito. Hanapin ang linya sa
ang input file, at tingnan kung maaari itong baguhin upang magpatuloy ang pagproseso.

C(++) pampaganda Mga hangganan

Itinatampok ng seksyong ito ang ilang partikular na lugar sa loob ng code kung saan mabibigo ang bcpp na muling buuin ang
output code sa nais na istilo (bagaman maaari pa rin itong mag-compile).

- Ang lahat ng code na pinapakain sa pamamagitan ng program na ito ay dapat nasa isang compilable na estado. Ito
nangangahulugan na dapat may mga closing braces na magkansela ng opening braces. Bcpp
hindi nagsusuri ng syntax sa code, ngunit nire-reformat ito ayon sa bukas,
closing braces, at isang maliit na bilang ng mga pangunahing salita para sa isang linyang indentation.

- May limitasyon din kung gaano kalayo ang galaw ng mga bukas na braces
naproseso. Ito ay dahil sa kasalukuyang disenyo ng programa (ito ay madaling maayos
sa pamamagitan ng pagpapalawak ng panloob na laki ng buffer ng pila), mga kinakailangan sa memorya, pagproseso
bilis. Malawakang ginagamit ang dynamic na memory allocation sa buong programa, at
maaaring lumampas sa kasalukuyang mga limitasyon kung may ilang kundisyon.

Ipinapakita ng halimbawa na ang mga paggalaw ng brace mula sa bagong linya hanggang sa itaas
code line ay hindi magaganap dahil ito ay wala sa saklaw para sa programa kung ang
Ang panloob na queue buffer ay limitado sa 2 linya ang laki.

Halimbawa ng saklaw ng paggalaw ng brace:

kung (a == b)
// Ang brace ay hindi muling ipoposisyon
{
b = c;
}

kung (a == b) // Ang brace ay muling ipoposisyon
{
b = c;
}

Pagtatapos na resulta

kung (a == b)
// Ang brace ay hindi muling ipoposisyon
{
b = c;
}

kung (a == b){ // Ang brace ay muling ipoposisyon
b = c;
}

- May isang hadlang na ang isang linya ng code ay dapat lamang magkaroon ng isang uri ng
komento. Kung mayroong parehong C, at C++ na umiiral sa parehong linya pagkatapos ay ang linya
Ang yugto ng pagtatayo ng programa ay malito, at bubuo ng isang error
mensahe. Ang sumusunod na linya ay maglalabas ng mensahe ng Line Construction Error.

Halimbawa ng maraming komento.

/* C Komento */ a = b; // Komento ng C++

Ang linya sa itaas ay bubuo ng error. Ayusin ito sa pamamagitan ng pag-alis ng isang uri ng
magkomento, pagsamahin ang mga ito, o ilagay ang isa sa isang bagong linya.

MGA AUTHORS

Isinulat Ni Steven De Toni Disyembre 1995
Na-update ni Thomas Dickey Enero 1997-2002

Maaari mong kontakin si Steven De Toni sa pamamagitan ng iba't ibang online network:

Address sa Internet
[protektado ng email]
[protektado ng email]

Net Mail Via Fido-Net (Dog Net)
Steven De Toni,
"Ang Dakilang Pagtakas",
Hamilton,
Niyusiland

Demi-Monde New Zealand National Mail Net Work
(tingnan ang Dog Net)

Kung nabigo ang lahat, magpadala ng snail mail sa:

17 Garden Heights Ave,
Melville,
Hamilton,
Niyusiland

Mapupuntahan si Thomas Dickey sa

[protektado ng email]

Espesyal na salamat kay Glyn Webster para sa patunay sa pagbabasa ng aking manwal, at pagsubok sa aking
programa.

Salamat kay Justin Slootsky para sa kanyang input, at mga pagbabago para sa bersyon na ito.

lahat gramatika ang mga error sa loob ng dokumentong ito ay nariyan para sa iyong kasiyahan. ;-)

DISCLAIMER

Ang mga may-akda ay hindi nagbibigay ng mga garantiya na ang program na ito ay gagana sa ibinigay na mga pagtutukoy
sa pamamagitan ng pagsasaayos, o muling itinayong output ng program ng source code na naging
naproseso. Anumang pinsala na maaaring lumitaw mula sa paggamit ng program na ito (maging ito ay software, o
hardware) ay ang problema ng user, at hindi ng mga may-akda. Ang paggamit ng software na ito ay nagbubuklod sa iyo
disclaimer na ito.=

C++ Beautifier()

Gumamit ng bcpp online gamit ang mga serbisyo ng onworks.net