Documente Academic
Documente Profesional
Documente Cultură
indentareaseutilizeazapentruadefiniinmodclarundeincepeunblocdecontrolsiunde seincheie pentru a realiza indentarea codului se recomanda folosirea taburilor si nu a spatiilor (marimearecomandatapentrutabeste4) puneticateunspatiudupafiecarevariabila,operator,paranteza.Codultrebuiesafiecatse poatedeAERISIT. Urmariticuatentieexemplul:
1. INDENTARESISPATIERE
2.AMPLASAREAACOLADELOR
Existasioexceptiedelaregulademaisusincazuldefiniriifunctiilor.Acoladadeschisava fiplasatalainceputullinieiurmatoareconformexempluluidemaijos.
int count( int x ) { body of function }
Atentie!Acoladainchisavafisingurapeliniecuexceptiacazurilorcandesteurmatade continuareaaceleiasideclaratii.Urmaritiexempluldemaijos!
do { body of do-loop } while (condition);
SAU
if (x == y) { .. } else if (x > y) { ... } else { .... }
3. STABILIREANUMELOR
4.FUNCTII
Un programator C nu va da nume frumoase variabilelor cum ar fi ThisVariableIsATemporaryCounter,ovadenumipursisimplutmp. Variabileleglobale(vorfifolositedoardacasuntabsolutnecesare)trebuiesaaibaunnume descriptiv,precumsifunctiileglobale.Deexemplu,dacaofunctienumarautilizatoriiactivi eavatrebuidenumitacount_active_users()siNUcntusr(). Numelevariabilelorlocaletrebuiesafiescurtsilaobiect.Deexempluuncontordecicluse vadenumisimpluisinuloop_counterpentrucaestefoarteneproductiv.
functiiletrebuiesafiescurtesisafacaunsingurlucru.Marimeauneifunctiinutrebuiesa depaseascaunulsaudouaecrane(ISO/ANSImarimeecran80x24). lungimea unei functii trebuie sa fie invers proportionala cu nivelul de indentare si complexitateaacesteia.AstfeldacaavemofunctiealcatuitadintrunCASEfoartemarein interiorulcaruiasefacoperatiisimpleatunciesteinregulasaavemofunctiemailunga. Unaltaspectcaretrebuieavutinvedereincazulfunctiilorestenumaruldevariabilelocale. Daca acesta este mai mare de 510 atunci functia in discutie trebuie reorganizata si impartitiainbucatimaimici.
5.COMENTARII Comentariile sunt un lucru bun, dar exista riscul unei supracomentari. Niciodata nu incercatisaexplicaticumfunctioneazacodul;dacacodulestescrisclaratunciacestlucurva fievident. In generalcomentariile descriu cefaceuncod,sinucum face acel lucru. Incercati de asemeneasaevitatiamplasareacomentariilorininteriorulfunctiilor.Dacafunctiaesteatat decomplexaincattrebuiesacomentatipartialeei,atuncimaicititidecatevaoripunctul4. In interiorul functiilor se pot face mici comentarii pentru a clarifica anumite lucruri speciale,dartotusinutrebuieexageratinaceastaprivinta.Puneticomentariilainceputul functiiloroferinddetaliicuprivirelacefacesidacaestecazuldecefaceacelelucruri.
Documentatiecompleta: http://lxr.linux.no/linux/Documentation/CodingStyle
VladBerteanu2008 ProgramareaCalculatoarelorseriaCC