this post was submitted on 29 Apr 2024
121 points (96.2% liked)

Programming

17509 readers
7 users here now

Welcome to the main community in programming.dev! Feel free to post anything relating to programming here!

Cross posting is strongly encouraged in the instance. If you feel your post or another person's post makes sense in another community cross post into it.

Hope you enjoy the instance!

Rules

Rules

  • Follow the programming.dev instance rules
  • Keep content related to programming in some way
  • If you're posting long videos try to add in some form of tldr for those who don't want to watch videos

Wormhole

Follow the wormhole through a path of communities [email protected]



founded 1 year ago
MODERATORS
 

Short but honestly good advise to rather pull boolean checks apart and re-group them as they make sense in the context of the given situation you're checking for.

I started doing this when building an alert-check system for the company I'm working for right now, and it really helps organize what is a pre-condition, what a syntactical requirement, etc etc.

all 23 comments
sorted by: hot top controversial new old
[–] [email protected] 24 points 7 months ago (2 children)

I was expecting something more profound. Isn't this just the concept of using variables to keep code readable? Not a new concept and likely one most devs learn early on.

[–] [email protected] 21 points 6 months ago (5 children)

I've had at least one code reviewer ask me to put all the logic in the if ... line rather than use a variable or two in order to "simplify code by reducing the number of variables."

At the very least, this article helped me confirm my own bias of "that guy is a moron" and I can send this article to him the next time he reviews my code.

[–] [email protected] 12 points 6 months ago

Yes, you need to push back on those people. They're the type that get high on code golf and end up writing unmaintainable one-liners measured in kilobytes for fun.

[–] nik9000 1 points 6 months ago

I review a ton of code and have a bunch reviewed in turn. I don't remember that last time I've had this come up. Either direction really. I guess I'm lucky. We just split naturally in similar places.

[–] [email protected] 1 points 6 months ago (1 children)

Well it actually depends.

Does it make the code more readable? Like you have several if statements using the same things (and/or else if)? Yeah then it's probably good.

If you have an if (work.lengt() == 0 && stacked_work.length() == 0) and that's it, probably not. Depending of whats happining then of course.

Be creative guys! But also dont be too creative :-) Think about the poor coder doing something with all that in a year or two, let's make his life less miserable (It's probably you, too).

[–] [email protected] 2 points 6 months ago (1 children)

"it actually depends"

Yes, it depends. But in this scenario we're not discussing if statements with one or two conditions. We're exclusively discussing multiple complicated conditions. :)

[–] [email protected] 1 points 6 months ago

Well thei it is probably almost always good to clear things up :-) !

[–] QuadriLiteral 1 points 6 months ago

I guess this is go, and I don't know what the scoping is. In C++ I also suggest putting as much in the if as possible, because it limits the scope of the variables.

[–] [email protected] 4 points 6 months ago

This is "Testing on the Toilet" which are short flyers that are posted in bathrooms at Google. They aren't typically meant to be particularly profound, just to remind people of common code patterns that can be written more clearly or other reminders that are good to keep in mind.

[–] [email protected] 16 points 7 months ago* (last edited 7 months ago) (1 children)

Good advice. The few pages of blog posts I have read are a really great read

[–] [email protected] 6 points 7 months ago

The entire TotT series is pretty good.

[–] [email protected] 12 points 7 months ago

Yes, I've been doing this for years. It's great for both code readability as well as debugging.

[–] [email protected] 10 points 6 months ago (1 children)

Good advice, bad biology: mushrooms aren't plants and therefore nor vegetables.

[–] [email protected] 14 points 6 months ago (2 children)

Vegetable is probably meant in the culinary use here, not in the biological one. And like with many such terms the two do overlap but not entirely.

[–] nik9000 1 points 6 months ago

I think it's a bad analogy because it'll distract some people.

[–] [email protected] 0 points 6 months ago (1 children)

I don't think a lot of people think that mushrooms are vegetables in any sense. If you check culinary lists of vegetables, they don't contain edible fungi.

[–] [email protected] 7 points 6 months ago

I'd consider them vegetables for cooking purposes

[–] robinm 8 points 7 months ago (1 children)

Good advice, clear, simple and to the point.

Stated otherwise: "whenever you need to add comments to an expression, try to use named intermediate variables, method or free function".

[–] bitcrafter 8 points 7 months ago (2 children)

Sometimes this can help, but lately I've been running into the opposite problem where people have been following this advice to such a degree that one cannot ever figure out what is going on without having to constantly jump around to find the actual code involved in doing something.

[–] [email protected] 3 points 7 months ago

Ah I hate that, too. It speaks of bad abstraction, over eager abstraction or unnecessary coupling that is the hidden behind this. Difficult to fix though without essentially starting over.

[–] robinm 2 points 6 months ago

I absolutely agree that method extraction can be abused. One should not forget that locality is important. Functionnal idioms do help to minimise the layer of intermediate functions. Lamda/closure helps too by having the function much closer to its use site. And local variables can sometime be a better choice than having a function that return just an expression.

[–] [email protected] 2 points 6 months ago

I do OOP because it naturally encourages me to do this sort of thing: abstract complicated logic into inspectable, reusable, testable properties of an object.