Sunday, June 06, 2010

Complaint Against Pass-by-Reference in C++

Since the day I learned about pass-by-reference in C++, I have had this little peeve about it. The following page describes the advantages of passing by reference: http://www.informit.com/guides/content.aspx?g=cplusplus&seqNum=166
So here is my plug for pass-by-address. Using * to pass the address of a variable makes it clear that, after the called function returns, its value could be different. However, if passed by reference, just looking at the function call does not make it obvious that the value could be changed. One has to look at the signature of the called function to know that. For example, the following code uses pass by value:

void increment (int n)
{
n++;
}

void myFunc ()
{
int k = 10;
increment (k);
std::cout << k << std::endl; // displays 10
}

If we want increment() to actually change the value of its argument in the calling function, then we can use pass-by-address to pass the address of the int variable. This is the only option available in C.

void increment (int* n)
{
(*n)++;
}

void myFunc ()
{
int k = 10;
increment (&k);
std::cout << k << std::endl; // displays 11
}

Looking at the call to increment() in myFunc(), I can say that the value of k that is printed might not be 10. However, consider the pass-by-reference option added in C++:

void increment (int& n)
{
n++;
}

void myFunc ()
{
int k = 10;
increment (k);
std::cout << k << std::endl; // displays 11
}

This is the same as the pass-by-value code (which prints 10) but with just one '&' character added to the signature of the increment() function. The myFunc() function is unchanged. Reading just the code for myFunc(), I have no clue that k is 11 by the time it is printed. To figure out how this happened, I would have to look up the increment() function signature, which may be in one of the many header files for a library that the application may be using. I think that the syntax could be improved by requiring some character in the increment() call that makes it explicitly clear to the programmer that a reference to the variable is being passed and not a copy. For example, it could be:

increment (@k);

Do you find the C++ pass-by-reference syntax irksome, too? Let me know in the comments section.

Sunday, May 02, 2010

Are Java references "pointers"?

The difference between Java references and C++ pointers is a much-discussed topic on the Internet. Java purists mostly shun the word "pointer" as a historical abomination that made code insecure. They insist on never calling a Java reference a pointer. However, I found it interesting that Java has a NullPointerException class - not a NullReferenceException.

A few days ago, I happened to come across an article titled "Java is Pass-by-Value, Dammit!" that gave me a part of the answer. In it, Scott Stanchfield tries to clear the confusion about Java's parameter passing - pass-by-reference or pass-by-value - and in doing so, shows that Java references act more like C/C++ pointers than C++ references. The article also mentions NullPointerException in passing and provides a quote from the Java Language Specification (JLS) , 3rd Edition as part of the legacy of pointers in Java. The JLS states (at http://java.sun.com/docs/books/jls/third_edition/html/typesValues.html#4.3.1 - emphasis not mine):
"The reference values (often just references) are pointers to these objects, and a special null reference, which refers to no object."

However, Java does not allow pointer arithmetic as C++ does. Probably to emphasize this and to distance Java from C++, Sun later tried to create a distinction between Java references and pointers. To be fair to Sun, there is a subtle difference between Java references and C++ pointers but it is in the way they are implemented. This is explained in the Best Rated Answer on the page http://www.geekinterview.com/question_details/32288. However, the behavior of both is the same, as far as programming with them is concerned (except that many memory-related problems are avoided by eliminating pointer arithmetic).