See this page as a slide show

CS253: Increment Methods

Why

If you’re writing a class that is numeric or pointery, then it needs:

• Preincrement (++obj)
• Postincrement (obj++)
• Predecrement (--obj)
• Postdecrement (obj--)

None of these come for free. You have to write them all.

Preincrement

Preincrement is easy:

1. Change the state of the object
2. Return the object by reference

    Whatever &operator++() {	    // No argument means preincrement
        // Do what is needed to change the object
        // which might be *this += 1;
        return *this;
    }

Fast & efficient—no copying is required.

Postincrement

Postincrement is harder, but can be the same for nearly all classes:

1. Save a copy of the object
2. Change the state of the object
3. Return the copy by value

    Whatever operator++(int) {	    // Dummy int arg means postincrement
        const auto save = *this;
        ++*this;		    // Call the preincrement method
        return save;
    }

Less efficient—need to make a copy, and return by value.

Decrement

Pre-/post-decrement is essentially the same. Get pre-/post-increment working, and then (I can’t believe that I’m saying this) use copy & paste.

General Guidelines

• Unless you have a really peculiar class, use the postincrement boilerplate given above. It’s the same for every class!
• Often, operator++ should use operator+= to accomplish the increment. Less duplication of information—good!
• When you have a choice, use preincrement rather than postincrement, because postincrement makes a copy, whereas preincrement doesn’t.
• For built-in integers, it doesn’t matter—the compiler will do the right thing. Follow whatever local coding standards are in force, or use whichever one looks better to you.