27.7 Layout

20200105

Keep lines to less then 80 characters for easier reading and fitting on a printed page.

Align curly braces so that an opening curly brace is on a line by itself. This is at odds with many style guides. My motivation is that the open and close curly braces belong to each other more so than the closing curly brace belonging to the keyword (while in the example). The extra white space helps to reduce code clutter. This style also makes it easier to comment out, for example, just the line containing the while and still have valid syntax. We tend not to need to foucs so much any more on reducing the number of lines in our code, as we had to with punch cards, so we can now avoid Egyptian brackets.

Preferred

while (blue\_sky())
{
  open\_the\_windows()
  do\_some\_research()
}
retireForTheDay()

Alternative

while (blue\_sky()) {
  open\_the\_windows()
  do\_some\_research()
}
retireForTheDay()

If a code block contains a single statement, then curly braces remain useful to emphasise the limit of the code block; however, some prefer to drop them.

Preferred

while (blue\_sky()) 
{
  do\_some\_research()
}
retire\_for\_the\_day()

Alternatives

while (blue\_sky())
  do\_some\_research()
retire\_for\_the\_day()

while (blue\_sky()) do\_some\_research()
retire\_for\_the\_day()

---

If you find this curated material useful then you can consider a donation to support it's ongoing availability and give you access to the PDF version of this book. The material has been scoped up by Generative AI without permission or any kind of recompense so do consider a donation if you can afford it. Unlike Generative AI your access to this materials is freely given. Desktop Survival Guides include Data Science, GNU/Linux, and MLHub. Books available on Amazon include Data Mining with Rattle and Essentials of Data Science. Togaware has a 30 year tradition of making popular open source software which includes sold privacy preserving productivity apps, rattle, wajig, and mlhub. Hosted by Togaware, a pioneer of free and open source software since 1984. Copyright © 1995-2022 Graham.Williams@togaware.com Creative Commons Attribution-ShareAlike 4.0