The rule of braces in Qt programming
-
@JNBarchan Maybe Apple should switch to Python then ;-)
-
@JNBarchan Maybe Apple should switch to Python then ;-)
-
@Wieland
It's OK, I don't much like Python, I prefer C's braces etc. :)I think one of the ugliest is, for the elegant:
a = b ? c : d;
I have to use:
a = c if b else d
Put that in your pipe and smoke it! Ridiculous.@JNBarchan Yep, total desaster.
-
Hi,
To add to my fellow developers: there's no "Qt programming". Qt is not a language, it's a C++ framework where the exact same rules applies as any other C++ library/framework.
-
In the particular case of one line statements it doesn't matter to the compiler if the braces are there, but humans make mistakes so it's quite a reasonable policy to always use braces, even when there's just one line.
Your code got badly formatted indents when you pasted it on the forum and that is a great example why that policy is a good idea. Consider this example:if (a) doSomething(); else if (b) doSomethingElse();Now someone takes this code over after you and adds another
elseto it:if (a) doSomething(); else if (b) doSomethingElse(); else doYetAnotherThing();At first glance, because of the formatting you could think that this new
elserefers to the firstifbut that's not the case. Adding braces makes it clearer what's going on:if (a) { doSomething(); } else { if (b) { doSomethingElse(); } else { doYetAnotherThing(); } }People will argue about the increased amount of lines and should you put the opening brace on the same or on the next line, but those are details. The point is that adding these braces saves you from silly formatting mistakes.
& is not only an address operator. It's also a binary AND. See my older post on these operators and how they are used to handle flags.
To compiler it doesn't matter if the braces are there
Please be careful about saying this, especially to a learner. In your example and that given by the OP they don't matter, but in other cases (like
if-if-else) they most certainly do matter vitally to the compiler! K&R did not put braces into language to make it easier for people to read code :) -
To compiler it doesn't matter if the braces are there
Please be careful about saying this, especially to a learner. In your example and that given by the OP they don't matter, but in other cases (like
if-if-else) they most certainly do matter vitally to the compiler! K&R did not put braces into language to make it easier for people to read code :)@JNBarchan Right, I made it more explicit. Thanks.
As a redeeming bonus here's another reason to always use braces: macros!
Consider this example:#define FOOBAR(x) doSomething(x); \ doSomethingElse(x) if(something) FOOBAR(42);It actually expands to:
if (something) doSomething(42); doSomethingElse(42);Not what we wanted at all. Braces would fix that.
K&R did not put braces into language to make it easier for people to read code :)
Is that a fact or you're guessing? ;)
-
@JNBarchan Right, I made it more explicit. Thanks.
As a redeeming bonus here's another reason to always use braces: macros!
Consider this example:#define FOOBAR(x) doSomething(x); \ doSomethingElse(x) if(something) FOOBAR(42);It actually expands to:
if (something) doSomething(42); doSomethingElse(42);Not what we wanted at all. Braces would fix that.
K&R did not put braces into language to make it easier for people to read code :)
Is that a fact or you're guessing? ;)
Is that a fact or you're guessing? ;)
Guessing ;) But I'm quite sure it's true! Even if they (Ritchie, I believe) thought braces might be nice for people to read, they had to be there semantically for
if-if-elseregardless of anything else. You can't do that without some kind of statement grouper. Remember that plenty of other languages use exactly the same principle (e.g. Pascalbegin-end), there's nothing unique to C here other than the (inspired!) choice of selecting{ }. -
Is that a fact or you're guessing? ;)
Guessing ;) But I'm quite sure it's true! Even if they (Ritchie, I believe) thought braces might be nice for people to read, they had to be there semantically for
if-if-elseregardless of anything else. You can't do that without some kind of statement grouper. Remember that plenty of other languages use exactly the same principle (e.g. Pascalbegin-end), there's nothing unique to C here other than the (inspired!) choice of selecting{ }.@JNBarchan Except there are languages that get by with just indenting like Python or F#, so I'd argue that the braces (or Pascalian begin/end) are there mostly for human consumption. The parser would be a lot happier with less braces and more
gotojumps.
Ok, lets not steal the thread for academic disputes. I feel we're on the same page anyway ;) -
@tomy
In the example you give the braces may be omitted.Some people prefer always putting them in for clarity (especially in tutorial books), and to prevent inadvertent errors where it does matter.
elseattaches to nearestifif no braces are used. If the case ofif-if-else, without any braces C always treats it asif (...) if (...) elseYou have to use braces if you mean:
if (...) { if (...) } elseThere is no "reference/address operator '&'" in the code --- those two are both bit-wise ands. They test whether the respective button-bit is set in the
intreturned byevent->buttons().@JNBarchan
There is no "reference/address operator '&'" in the code --- those two are both bit-wise ands. They test whether the respective button-bit is set in the
intreturned byevent->buttons().@Chris-Kawa : I've written numerous C++ apps and have never used braces for one statement except for situations like out of scope of an object calling its destructor. But the code is a simple "if" and "else if" pair.
@Wieland: In your code, we have at least one goto fail; execution.
@SGaist: Please read the first line of my first post here.Thanks to all.
Thanks.
-
@JNBarchan
There is no "reference/address operator '&'" in the code --- those two are both bit-wise ands. They test whether the respective button-bit is set in the
intreturned byevent->buttons().@Chris-Kawa : I've written numerous C++ apps and have never used braces for one statement except for situations like out of scope of an object calling its destructor. But the code is a simple "if" and "else if" pair.
@Wieland: In your code, we have at least one goto fail; execution.
@SGaist: Please read the first line of my first post here.Thanks to all.
Thanks.
There is no "reference/address operator '&'" in the code --- those two are both bit-wise ands.
I'll chime in even if a bit late. C++ has a pretty terrible syntax in a sense, because there's a lot of context-dependent meaning of tokens (operators, braces and such). While this is not a problem semantically (pertaining to the meaning), it may be quite a lot for the learners when they try to acquire command of the language. Think about the asterisk
*can you name at least three distinct meanings for it? Same goes for the different type of parentheses, brackets and braces - one should be able to name at least two meanings of the brackets, at least two meanings for->and variants thereof off the top of one's head. There's even the pointer to member dereference operator->*and three distinct meanings of the&.My point here is that this "suggests" it's a very good idea to adopt a strict (code) style if all those nuances are not to lead to errors/confusion.
As for the braces I personally don't put them around single statements (unless there's a nested
if/else/foretc.), however I impose on my code to be always perfectly indented. This means the matchingelseis to be always at the same column as the correspondingifand so on. Also braces have one more "peculiar" meaning - opening of a block, which allows for shadowing of variable names that is not otherwise possible.Read and abide by the Qt Code of Conduct
-
There is no "reference/address operator '&'" in the code --- those two are both bit-wise ands.
I'll chime in even if a bit late. C++ has a pretty terrible syntax in a sense, because there's a lot of context-dependent meaning of tokens (operators, braces and such). While this is not a problem semantically (pertaining to the meaning), it may be quite a lot for the learners when they try to acquire command of the language. Think about the asterisk
*can you name at least three distinct meanings for it? Same goes for the different type of parentheses, brackets and braces - one should be able to name at least two meanings of the brackets, at least two meanings for->and variants thereof off the top of one's head. There's even the pointer to member dereference operator->*and three distinct meanings of the&.My point here is that this "suggests" it's a very good idea to adopt a strict (code) style if all those nuances are not to lead to errors/confusion.
As for the braces I personally don't put them around single statements (unless there's a nested
if/else/foretc.), however I impose on my code to be always perfectly indented. This means the matchingelseis to be always at the same column as the correspondingifand so on. Also braces have one more "peculiar" meaning - opening of a block, which allows for shadowing of variable names that is not otherwise possible.@kshegunov
Thank you very much for your explanations. -
I think, at the end of the day, this is a style question. Qt has a guideline: https://wiki.qt.io/Qt_Coding_Style , Google has one: https://google.github.io/styleguide/cppguide.html , basically every company has a different one
