Programmeren in C/Stijl en structuur: verschil tussen versies

==Leesbaarheid==

Alle hogere programmeertalen zijn bedoeld voor de mens. Het is vrijwel onmogelijk om een substantiëel programma in machinetaal te schrijven, aangezien dat uitsluitend uit numerieke codes bestaat. Leesbaarheid van de code is dan ook geen onbelangrijk detail, maar is essentieel omdat, als het eenmaal geschreven is, een programma moet worden onderhouden en onderhoud nu eenmaal onmogelijk is als de broncode niet te begrijpen is.

 

 

===Inspringen===

Het is gebruikelijk om elk blok code met een bepaald aantal spaties in te springen. Het gebruik van tabs is hierbij af te raden, want tenzij exact dezelfde tabinstellingen worden gebruikt, zal de broncode schots en scheef komen te staan, wat de leesbaarheid niet bevordert. Verder is het een goede gewoonte accolades altijd op een aparte regel te zetten, zodat in een oogopslag duidelijk is welke '''}''' bij een gegeven '''{''' hoort.

 

 

===Commentaar===

Commentaar is tekst die genegeerd wordt door de compiler, maar de code verduidelijkt voor andere programmeurs die uw werk lezen. Een paar zinnen commentaar kan veel duidelijk maken over de bedoeling van broncode. Commentaar staat tussen '''/*''' en '''*/''' en kunnen meerdere regels beslaan.

 

 

=== Naamgeving ===

Het is zonder problemen mogelijk om variabelen namen te geven als ''Pipo'', ''Mammeloe'' of ''Kluk-kluk'' te geven, en functies namen als ''doe_het'', ''doe_iets'' of ''doe_wat_anders'', maar begrijpelijker wordt de broncode er niet van. Namen als ''aantal_records'' of ''lees_config'' zijn al veel duidelijker. Het is dus van belang namen te kiezen die iets zeggen over de functie de bijbehorende entiteiten in het programma hebben. Het is echter een goede gewoonte namen in het engels te kiezen omdat de taal ''C'' op het engels gebaseerd is en de softwarewereld tamelijk internationaal is.

 

 

== Meer over dit onderwerp ==

* [http://www.psgd.org/paul/docs/cstyle/cstyle.htm Indian Hill Recommended C Style and Coding Standards]