Differences

This shows you the differences between two versions of the page.

--- coding_style [2016/03/10 12:28] – [Examples] jmgr
+++ coding_style [2016/03/11 12:36] – [Naming] jmgr
@@ Line 26: / Line 26: @@
 | member variable | m_someExample | |
 | global variables | gSomeExample | should be avoided |
-| function | someExample() | |
+| function | someExample() | function names should begin with a verb: computeMap(), displayWindow() |
 | member function | someExample() | |
 | getter function | name() | not getName(), Qt convention |
@@ Line 33: / Line 33: @@
 | template parameter | SomeExample | |
-Never use abbreviations in names, having long names is not an issue: all IDEs have an auto-completion feature.
+**Never use abbreviations in names, having long names is not an issue: all IDEs have an auto-completion feature.**
 <code cpp>
 // Bad
@@ Line 48: / Line 48: @@
     //...
 }
+</code>
+**Prefer using meaningful names instead of "one letter" names like i,j,k.**
+<code cpp>
+// Bad
+for(int i = 0; i < ducks.size(); ++i)
+{
+    //...
+}
+// Good
+for(int duckIndex = 0; duckIndex < ducks.size(); ++duckIndex)
+{
+    //...
+}
+</code>
+**Variables representing GUI elements should be suffixed by their type**
+<code cpp>
+// Bad
+QPushButton *exitApplication;
+QLabel *duckCount;
+// Good
+QPushButton *exitApplicationPushButton;
+QLabel *duckCountLabel;
 </code>
 ===== Code files =====