Jump to content
  • Advertisement
Sign in to follow this  
Tutorial Doctor

Ugh! Your shorthand is too short!

This topic is 2050 days old which is more than the 365 day threshold we allow for new replies. Please post a new topic.

If you intended to correct an error in the post then please contact us.

Recommended Posts

One of the most annoying things I keep seeing is people who write shorthand code with variables like:

i = true

Where "i" means "initialize" or some miscellaneous other word that starts with an "i." 


How will you go back later and debug when the code has reached 1,000,000 lines and you forgot what "i" does?


Better yet, even 1,000 lines would throw me for a loop (pun intended). 


I mean, C++ code is already cryptic enough, why the extra brevity?


Sometimes I truly think people initially write the full names in the code, and then go back and make things cryptic on purpose just to scare away code thieves. In that case I understand, but is the stereotype really true that programmers are just lazy?


There is a way to be brief yet descriptive without feeling like you are monologuing in your code. I understand that we can sacrifice a little human readability (according to human language standards) for the sake of "getting it done" but really....


Something like:

init = true

would be better, but even then....


Anyone else know what I'm talking about (I am a beginner)?

Edited by Tutorial Doctor

Share this post

Link to post
Share on other sites

The more annoying thing aboug one-letter variables is about highlighting or finding them (pray you do not have to refactor such code), not so much about understanding what they mean (if the programmer is only somewhat sensible, the purpose of one-letter names is usually still obvious).


But once you find out that your editor lets you conveniently highlight all occurrences of greater-than-N substrings (usually N=3) you start shouting at people who use one-letter variables because it doesn't work with the default settings, nor is there a way you could configure it so it works in a usable way without highlighting every frequently occurring letter in every keyword too.

Share this post

Link to post
Share on other sites

Since I've switched to DVORAK-DEV I sometimes find myself doing very... sad things.

So, on DVORAK-DEV numbers are really difficult to do. They are... on the row you expect but in a different order, with 0-1 being passable, 2-3 ugh. I still don't remember the position of the others. It turns out 9 is on QWERTY-6.

Ah, and you have to hit SHIFT to do numbers, as default those buttons produce symbols.


So, when I don't have expressive names, I end up doing even worse stuff:

void Some::Function(uint argo, uint argi) { ... }

Because you see, o is a small 0. And i is 1. And 2 is... what about t? Cuz it looks like two isn't it? And 3 is e... uuuuh my head!

Share this post

Link to post
Share on other sites
Sign in to follow this  

  • Advertisement

Important Information

By using GameDev.net, you agree to our community Guidelines, Terms of Use, and Privacy Policy.

GameDev.net is your game development community. Create an account for your GameDev Portfolio and participate in the largest developer community in the games industry.

Sign me up!