I often see code that include intentional misspellings of common words that for better or worse have become reserved words:

  • klass or clazz for class: Class clazz = ThisClass.class
  • kount for count in SQL: count(*) AS kount

Personally I find this decreases readability. In my own practice I haven't found too many cases where a better name couldn't have been used — itemClass or recordTotal.

An example from the JavaDocs for Class show this in the parameters:

 public <U> Class<? extends U> asSubclass(Class<U> clazz)

Does this show a reasonable use case?

  • 9
    For the record: In Python, cls is a common (in fact, the one idiomatic) name for variables/arguments contining actual classes (the ones you declare with the class keyword and which everything is an instance of).
    – user7043
    Commented Mar 25, 2011 at 19:48
  • 14
    You don't like typedef char ínt?
    – Jeff
    Commented Mar 25, 2011 at 20:50
  • 14
    @muntoo You're right. I also get compiler errors for iñt. There goes my plan for world domiñation.
    – Jeff
    Commented Mar 25, 2011 at 23:01
  • 1
    I have broken this rule... and now I feel shame.
    – jmq
    Commented Mar 26, 2011 at 0:25
  • 3
    Don't do it. I can honestly say that I've never seen this before, and if I did, I'd immediately rename it. Just abbreviate if you have to use a non-descriptive variable name (Class c). Commented Mar 26, 2011 at 15:14

12 Answers 12


IMHO, this is a very bad idea. Reserved words are reserved for a reason, and doing this does decrease readability.

I also entirely agree with your second point. Naming a variable class, even if you could do it, would be just as bad as naming it tmp or a. What kind of class? A class of what? Names should be descriptive.

  • 15
    "Reserved words are reserved for a reason" <-- This. (Which, ironically enough, is reserved.)
    – trycatch
    Commented Mar 25, 2011 at 20:18
  • 17
    +1 because you are right. But if you were writing classroom scheduling software, or something, class might be a legitimate variable or class name...
    – CaffGeek
    Commented Mar 25, 2011 at 20:26
  • 9
    Meh. "Reserved words are reserved for a reason", which is that language designers are lazy. There are quite a few sophisticated languages where words are only reserved in the specific places where they're used. But Ritchie started this trend when he needed a lightweight compiler for C, and most language designers have learned it from there. Commented Jan 7, 2013 at 12:19
  • 14
    no Ross, it's because programmers (and readers in general) have an expectation of things to have reasonably unambiguous meaning (which is why learning foreign languages is often so hard, all the things with double meaning, or meaning different from the language you were raised in from childhood where you never notice those ambiguities because they're part of your cultural heritage).
    – jwenting
    Commented Jan 7, 2013 at 12:31
  • 3
    @AlexanderMorou Nope, and neither have most language designers, they just start with someone else's design. But look at Algol, Fortran, PL/I, Rexx, and other languages not based on C, and you'll see that grammars without reserved words are certainly possible, just harder. Ritchie had a good reason - the Unix folks felt every keystroke mattered, and on a PDP-11, every CPU cycle mattered. Today? Not so much. Commented Nov 29, 2015 at 22:35

Python's Style Guide calls out this problem specifically, and suggests:

If your public attribute name collides with a reserved keyword, append a single trailing underscore to your attribute name. This is preferable to an abbreviation or corrupted spelling.

This seems like a pretty good general rule, assuming it doesn't conflict with the semantics of a particular language.

  • 8
    I feel this is really poor advice from a style guide. If your attribute name is so close to a keyword, you should find a better name. Simply sticking an underscore on the end doesn't add any meaning and make's it likely to confuse the next guy that reads the code. Commented Mar 26, 2011 at 3:41
  • 18
    @Wayne: How are you going to name the union operation in a union-find structure when union is a keyword (as in C)? Are you going to call it foo just because it shouldn't look like union?
    – Fred Foo
    Commented Mar 26, 2011 at 10:17
  • OTOH, cls is standard argument name for class method. Also for example in Django objects have .id attribute, which of course conflicts with id built-in function.
    – vartec
    Commented Jan 7, 2013 at 13:45
  • 1
    @GoloRoden I've never heard anyone say they were "uniting" two sets when computing the union. It's just not part of the lingo. "Merge" would be better, but a merge method would still need documentation explicitly stating that it implements union and was renamed for purely technical reasons.
    – Fred Foo
    Commented Jan 15, 2014 at 14:13
  • 2
    @GoloRoden According to Merriam-Webster it's not a verb, but see this answer.
    – maaartinus
    Commented May 11, 2015 at 1:29

Code smell.

string stringVariable = "";

The above code tells me nothing about the variables intended usage.

class Klass

Same problem

string UserNameString = "bmackey"

The above code should not require keyword string appended to variable name. If you find yourself needing to identify types by variable name, your code is too long. Condense-refactor.

  • It doesn't tell you anything because it's not "code", it's an isolated variable declaration. A "class" or "klass" may very well tell you all you need to know. For example, a generic method may receive a Class<T> parameter, and this can make sense. So I disagree that it's a code smell.
    – Andres F.
    Commented Nov 30, 2015 at 13:52

Personally, I think it's a perfectly valid option for your code style.

They're reserved words so the compiler doesn't have to decide if you meant the language-mechanic or your variable. With that in mind, it implies that they expect people to have a need for a variable like a reserved word.

Going through the source bundled with JDK 1.6 R21, I find 917 occurrences of "clazz". Apparently, they thought it was acceptable style.

How does your team feel about it? If you think it's bad, but the other 9 guys on your team think it's good, then you have to bite the bullet and accept it. As long as there's communication about what is okay and what isn't, and you're bringing up issues you see as you see them, it should be just fine.

How your team feels about code style is more important than my opinion, or anyone else's in this post. That goes for this and any other code style decisions you might have.

  • 1
    Right, but eventually your team will change. Many years down the road there will be some poor guy looking at your code full of klasses and clazzes and saying "WTF!".
    – MrFox
    Commented Jan 7, 2013 at 17:59
  • 4
    If you are using both klass and clazz that's a bad thing. You need to be consistent so they only have to learn it once. And ideally this is spelled out in the teams style guidelines too, so it's not much of a surprise.
    – corsiKa
    Commented Jan 7, 2013 at 18:25
  • Code is written not just for the people on your team, but for the rest of the world to read. When your team are all on a bus that goes over a cliff, somebody else gets to start reading the code. Use names that completely and concisely describe what the variable is, not how it's represented.
    – Rob K
    Commented May 11, 2015 at 15:00
  • 1
    No, simply no. Your team is far, far more likely to rotate members slowly over time. You can plan for one person getting hit by a bus, but you can't plan for your entire team getting hit by a bus. Most code is written for maybe a dozen people ever needing to read it, half of them during code review.
    – corsiKa
    Commented May 17, 2015 at 6:30

Intentional misspellings to avoid reserved words is a bad idea.

  • Misspellings are hard to distinguish from the correct spelling, therefore they make the code harder to read.

  • Misspellings are hard to remember, so that several inconsistent misspellings are likely to compete within code, which makes code harder to write and harder to read.

  • Reserved words refer to the language being used to solve the problem, not to the problem itself. A variable name should point to a concept related to the problem.

It is therefore better to pick an alternative, descriptive name, or if no satisfying alternative exists, to qualify the reserved word as in:

public static Method findBenchmarkMethod(BenchmarkRecord benchmark) {
    Class<?> benchmarkedClass = ClassUtils.loadClass(benchmark.generatedClass());
    return findBenchmarkMethod(benchmarkedClass, benchmark.generatedMethod());

Class clazz smells like "I did not bother to try to come up with a good name". A variable is always representing something, and a good name describes that. I refuse to imagine that clazz for instance under any circumstances is the best name possible. Is it a reference to a class -> class_reference, is is a copy of a class object -> class_copy, etc. Possibly also dropping "class" and just use the descriptive word, e.g.

java.lang.SecurityManager.checkMemberAccess(Class<?> clazz, int which)
    clazz -- the class that reflection is to be performed on.

Here clazz is the target class that the check is to be performed on, so

checkMemberAccess(Class<?> target, int which)

would much better describe what the parameter is used for than clazz ever will.

  • IMHO it's not better, you could call it 'classToBeAccessed` or whatever, but any more descriptive name just shows the obvious. I like long names only if they provide useful information.
    – maaartinus
    Commented Jan 14, 2014 at 11:52
  • 1
    classToBeAccessed is a good name indeed (classToBeChecked would perhaps be even better).
    – hlovdal
    Commented Jan 14, 2014 at 15:51

If they use a reserved name for a variable, it's a poorly named variable. Even if it is a legitimate name, such as Class for classroom software.

Poorly named variables are a sign of poorly thought out or casual code -- beware of other gotchas in the Piece of Software you are maintaining.


I think intentional misspellings or abbreviations are a good idea if used carefully and consistently.

Consider in Java:

class X { public X() { } }
X x = new X();
x.getClass;  // Wha?  How does "get" help anything?
x.class;     // Best, but requires more lexer/parser work
x.klass;     // At least as good as getClass
x.clazz;     // Same

The place to use misspellings is where the reserved word is clearly the best word for the job. There are two places not to use misspellings where you might be tempted to.

  1. You don't feel like thinking of a good name
  2. You just want a dummy variable and it doesn't need a descriptive name

In the first case, it's pretty obvious that laziness is rarely a good policy for creating quality code. In the second case, choose a really short variable. That's what mathematicians do all the time, and programmers do for indices. There's no reason to limit yourself to doing this for indices if it really is just a dummy variable:

boolean isMyName(String testName) { return myName.equals(testName); }
boolean isMyName(String s) { return myName.equals(s); }

Date nextMeeting(Klass klass) { return /* something */ }
Date nextMeeting(Klass k) { return /* something */ }

You don't lose anything with short variable names when the method or the structure of the code tells you what must be there.

  • 2
    I'm sorry, I can't agree. How does nextMeeting work exactly? The logic is obscure. You are forcing me to look up the definition of Klass every time I'm reading your code because the name is meaningless. If instead you had nextMeeting(MeetingRoom meetingRoom), I would have one less class (klass? clazz?) definition to read and thereby be more productive. Code gets read much more than written.
    – MrFox
    Commented Jan 7, 2013 at 18:05
  • @suslik - nextMeeting(MeetingRoom r) is plenty. What's the meetingRoom getting you there? If ti was nextMeeting(int meetingRoom) I'd understand, but my point is use short variable names when the information is already available from other sources.
    – Rex Kerr
    Commented Jan 7, 2013 at 19:14
  • My post was more about the existance of Klass in the codebase. I agree with short variable names sometimes, but if your methods get long and you I have to keep srcolling up to make sure that "r" is a MeetingRoom then that isn't great either. I'm curious what the downside of meetingRoom is though? Horizontal space? Too long to type?
    – MrFox
    Commented Jan 7, 2013 at 19:19
  • @suslik - Yes, you lose horizontal context with long variable names. You lose vertical context with long methods, so it's best to try to avoid those (but I agree if you do it anyway, you probably want your variable names to be better reminders). Klass was an alternative when there was a reserved word. I don't recommend using a misspelling when the original spelling is available!
    – Rex Kerr
    Commented Jan 7, 2013 at 19:23

I've seen legitimate uses of Class klass when doing reflection where you do actually work with an instance of the Class class.

  • 2
    The question is not whether there is any case where you have an instance, but whether you should use that spelling, or a more descriptive name such as userClass or some other option.
    – Nicole
    Commented Jun 30, 2011 at 21:55
  • 2
    In such case I'd prefer classInstance over klass. Commented Jan 14, 2014 at 10:31
  • 2
    @KonradMorawski: But all object you work with are instances, so classInstance is pretty redundant. Moreover, I could imagine something like class klass; Object classInstance = klass.newInstance;.
    – maaartinus
    Commented Jan 14, 2014 at 11:48

I often see code that include intentional misspellings of common words that for better or worse have become reserved words:

klass or clazz for class: Class clazz = ThisClass.class

kount for count in SQL: count(*) AS kount

Personally I find this decreases readability. In my own practice I haven't found too many cases where a better name couldn't have been used — itemClass or recordTotal.

However, it's so common that I can't help but wonder if I'm the only one? Anyone have any advice or even better, quoted recommendations from well-respected programmers on this practice?

For local variables and formal arguments, it just doesn't matter.

Any name is fine as long as it is not intentionally misleading or annoyingly distracting. In your example:

public static Method findBenchmarkMethod(BenchmarkRecord benchmark) {
    Class<?> clazz = ClassUtils.loadClass(benchmark.generatedClass());
    return findBenchmarkMethod(clazz, benchmark.generatedMethod());

it doesn't matter whether the single local variable is "clazz" or "klass" or "cls" or simply "c". I would probably just inline the expression:

return findBenchmarkMethod(ClassUtils.loadClass(benchmark.generatedClass()),

The length of a variable name should be related to the variable's scope. For local variables in short methods (and they should all be short), very short names are fine.

  • your inline looks incorrect ClassUtils.loadClass(benchmark.generatedClass()) => benchmark.generatedClass() - lost ClassUtils.loadClass along the way
    – gnat
    Commented Jan 14, 2014 at 17:51

I think misspellings are always a bad idea. It's just not nice on your readers. I, for one, would be wondering whether I missed something when I see the word klass. (Did they mean class, or did they mean the pirate?) At least to me, all misspellings that I recognize are irritating.

For the very few cases, where the reserved word is really the only significant thing that is known about the variable, I would use the following alternatives:

  • If it's a function argument, use aClass instead of class.

  • If it's a local or member variable, use myClass instead of class.

  • If it's an accessor, use getClass() instead of class().

Of course, the added prefix is pretty pointless, and should only ever be used as a last resort, consequently. But at least it does not interfere with the mental parser of your reader, and it's a failsafe way to avoid reserved words.


One benefit to creative spelling, is better search-ability. I think it's far easier to do a full code search for unique things, than for common words, where too often you will find all of the wrong things, and 1000 of them. As an example, I used to own kzpg.com. Google that now and you'll see only a few hits. It's unique and therefore very findable.

But to a measure I think this question is one of opinion more than substance. I personally grew up on Forth where it was all about words, and lots of them. One learned to get very creative to save one's fingers. In the end I had about 640,000 characters, more or less in my source base. So keeping words short was important to getting work done.

  • That link is broken now. Commented Nov 29, 2015 at 18:21

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.

Not the answer you're looking for? Browse other questions tagged or ask your own question.