Stil kodiranja C++

Qt Creator koristi biblioteku Clang LibFormat za automatsko formatiranje i uvučenje C++ koda. Nametanje koda nametne stil kodiranja za projekt ili cijelu organizaciju.

Za postavljanje globalnih postavki uvlačenja za C++ uređivač:

1. Idite na Postavke > C++ > Code Style.

   

2. U Formatting mode u odaberite:
   • Indenting Only za indentiranje koda.
   • Full Formatting da se koristi prečac na tipkovnici Ctrl+I za formatiranje koda umjesto uvlačenja.
   • Use Built-In Indenter da isključite ClangFormat.
3. Odaberite Ignore files greater than kako biste ubrzali analizu ignoriranjem velikih datoteka. Navedite maksimalnu veličinu datoteka za analizu.
4. Da biste primijenili formatiranje dok tipkate, odaberite Format while typing.
5. Da biste primijenili formatiranje na uređeni kod prilikom spremanja datoteke, odaberite Format edited code on file save.

   Za privremeno onemogućavanje ove postavke tijekom spremanja datoteke, idite na File i odaberite Save Without Formatting.

   Za globalnu promjenu stila ClangFormat za sve projekte odaberite xml-ph-0000@deepl.internal .
6. Da biste globalno promijenili stil ClangFormata za sve projekte, odaberite Use custom settings.
7. U Custom settings odaberite postavke koje želite promijeniti, a zatim odaberite Copy.
8. Unesite naziv za postavke i odaberite OK.
9. U ClangFormat u uredite opcije stila ClangFormat. Živi pregled prikazuje kako postavke mijenjaju uvlačenje. Ako unesete nevažeće vrijednosti, vidjet ćete poruke upozorenja.

Korištenje ugrađenog indentera

Ako u Formatting mode odaberete Use Built-In Indenter, možete odrediti kako:

• Tumačiti pritiske tipki Tab i Backspace.
• Dodajte makroe koje indenter interpretira kao potpune naredbe kojima na kraju nije potreban semikolon.
• Uvući sadržaj klasa, funkcija, blokova i imenovnih prostora.
• Uvući zagrade u klasama, imenskim prostorima, enumima, funkcijama i blokovima.
• Kontrolirajte naredbe prebacivanja i njihov sadržaj.
• Poravnajte nastavne retke.
• Povežite pokazivače (*) i reference (&) u tipovima i deklaracijama s identifikatorima, nazivima tipova ili ključnim riječima lijevo ili desno od const ili volatile.

Postavljanje postavki za sadržaj

Možete indentirati javne, zaštićene i privatne izjave i s njima povezane deklaracije unutar klasa.

Također možete uvući izjave unutar funkcija i blokova te deklaracije unutar imennih prostora.

Postavljanje postavki za zagrade

Možete poravnati deklaracije klasa, imennih prostora, enuma i funkcija te blokove koda.

Postavljanje postavki za naredbe switch

Možete poravnati case ili default naredbe, ili naredbe ili blokove povezane s njima unutar switch naredbi.

Postavljanje poravnanja

Za poravnanje nastavnih redaka s tokenima nakon dodjela, kao što su = ili +=, odaberite Align after assignments. Dodatna podešavanja za poravnanje nastavnih redaka možete navesti na kartici General.

Također možete dodati razmake uvjetnim izrazima kako se ne bi poravnali s idućim redom. Obično ovo utječe samo na izraze tipa if.

Povezivanje pokazivača i referenci

Da biste povezali pokazivače (*) i reference (&) u tipovima i deklaracijama s identifikatorima, imenima tipova ili ključnim riječima lijevog ili desnog const ili volatile, odaberite potvrdne okvire na kartici Pointers and References.

Karakter * i & automatski su vezani uz identifikatore pokazivača na funkcije i pokazivače na nizove.

Izrada ClangFormat datoteka s naredbenog retka

Možete stvoriti .clang-format datoteke koje imaju konfiguracijske opcije određenog unaprijed definiranog stila s naredbenog retka. Na primjer, za stvaranje formatne datoteke za stil LLVM unesite sljedeću naredbu:

clang-format -style=llvm -dump-config > .clang-format