Java: valueOf vs copyValueOf

Question

What is the difference between valueOf and copyValueOf. I looked on GrepCode, only to find that both return the exact same thing.

copyValueOf:

Parameters: data the character array.

Returns: a String that contains the characters of the character array.

public static String copyValueOf(char data[]) { return new String(data); }

valueOf:

Returns the string representation of the char array argument. The contents of the character array are copied; subsequent modification of the character array does not affect the returned string.

Parameters: data the character array.

Returns: a String that contains the characters of the character array.

public static String valueOf(char data[]) { return new String(data); }

So if both do the same thing, then how come one isn't deprecated?

Answer 1

As others have pointed out:

• The two methods are equivalent.
• The javadocs clearly state that the two methods are equivalent. And copyValueOf clearly points the reader to the (mildly) preferred valueOf method.
• There is NO performance difference between the two versions. The implementations are identical.
• Deprecating one or other method would be counter-productive because it would prompt people to "fix" code that isn't broken. That is (arguably) a waste of time, and it would annoy a lot of people.
• Removing one or other method would break backwards compatibility ... for no good reason. That would really annoy a lot of people.

The only other issue is why there isn't an annotation to flag a method as "out of date". I think that the answer to that is that it doesn't matter if you use an API method that is out of date. Certainly, it doesn't matter enough for the Java team to implement such a mechanism ... and then spend a lot of time deciding whether such-and-such an API is "out of date enough" to warrant flagging, etc.

(Most folks would not want the Java team to waste their time on such things. We would prefer them to spend their time on delivering improvements to Java that will make a real difference to program performance and programmer productivity.)

A more appropriate way to deal with this issue would for someone to write or enhance 3rd-party a style checker or bug checker tool to flag use of (so-called) out of date methods. This is clearly not Oracle's problem, but if you (Dear Reader) are really concerned about this, you could make it your problem.

Answer 2

A program element annotated @Deprecated is one that programmers are discouraged from using, typically because it is dangerous, or because a better alternative exists. Compilers warn when a deprecated program element is used or overridden in non-deprecated code (Annotation Type Deprecated).

The two methods literally do the same thing; meaning that neither method is dangerous or better. This is perhaps the reason they haven't bothered to deprecate either method.

Answer 3

Both of the methods serves same purpose, but they differ a little in their inner implementation (according comments in String.java - older implementations):

copyValueOf(char data[])

Returns a string that is equivalent to the specified character array. It creates a new array and copies the characters into it.

valueOf(char data[])

Returns a string that is equivalent to the specified character array. Uses the original array as the body of the string (ie. it does not copy it to a new array).

The older version has redudndency in its code. But in newer versions of Java, implementations as same. Older method is made available so that old programmers who are unaware of newer version can use it.