Explicit and Automatic String Conversion in Java

Data with other data types can be converted to String using explicit and automatic ways in Java. Explicit String conversion ways include:

  • Use of the toString() method of an object, especially wrapper classes.
  • Use of the static overloaded method String.valueOf, passing in the other data type value.
  • Use of a String constructor to convert a byte array as a String.


Automatic String conversion of other data type values happen when objects are used in the context of a String like:

  • An object or primitive passed as an argument to a println().
  • An object or primitive written as the second operand of the “+ operator” when the first operand is a String.


Code for examples

We will use the below variable declarations for our examples inside a class StringCheck:

public class StringCheck {

  public static void main(String[] args) {

    int i=10;

    char[] myCharArray = { 'a', 'b', 'c' };

    int[] myIntArray={1,2,3,4};

    byte myByteArray[] = "abcd".getBytes();

//Code for each case will go here.




Use of the toString() method

The toString() method is part of the Object class that should return a String representation of the object and hence inherited by all classes in Java. It is recommended that all subclasses override this method. Invoking toString() on a null reference will cause NullPointerException to be thrown.


    System.out.println(new Integer(i).toString());

    System.out.println(new StringCheck().toString());





This will print:






The toString() method is part of the Object class and hence inherited by all classes in Java, but not primitives. The wrapper classes provide a mechanism to "wrap" primitive values in an object so that the primitives can be included in activities only for objects. Hence we need to wrap our primitive inside the corresponding wrapper class and then call the toString() method. Wrapper classes in Java (Integer, Long, Float etc) have overridden this method to return the String representation of the primitive it holds. Read more about wrapper classes at http://javajee.com/wrapper-classes-auto-boxing-and-auto-unboxing.

Since we have not overridden toString for our class StringCheck, it uses the inherited default implementation in the Object class. The toString method for class Object returns a string consisting of the name of the class of which the object is an instance, the at-sign character `@', and the unsigned hexadecimal representation of the hash code of the object.

In case of Arrays, toString prints a symbol [ followed by an alphabet like C, B etc. denoting the type, followed by the at-sign character '@', and the unsigned hexadecimal representation of the hash code of the object. It prints something like [C@9664a1 for char[] and [B@addbf1 for byte[]. Now let us see in detail what [C@9664a1 mean for an array.

  • The [ means array.
  • The C means char.
  • The @ separates the type from the ID.
  • The hex digits are an object ID or hashcode.

Below is a list of possible values for most types.

  • B - byte
  • C - char
  • D - double
  • F - float
  • I - int
  • J - long
  • S - short
  • Z - boolean
  • [ - one [ for every dimension of the array  


Use of String.valueOf

The static overloaded method String.valueOf returns the string representation of the argument data.

String.valueOf() is overloaded for all the primitive types, char array and for the type Object.

For the primitive types, valueOf() returns the string representation of the of the value it contains.

For objects including arrays, but excluding char[], if the argument is null, then a string equal to "null"; otherwise, the value of obj.toString() is returned.

For char array, if the argument is null, then a NullPointerException is thrown; otherwise it will print the contents of the char array.




    System.out.println(String.valueOf(new StringCheck()));




This will produce the output:






You can see that except for character arrays, everything is printed as is for toString(); for char arrays, the contents are printed instead.


Converting a byte array to String using String constructor

Using the  String.valueOf or the toString method of object will work for primitives and wrappers, but not for objects and arrays. For most objects, we need to override the toString. We also saw that a char array contents are converted with String.valueOf.

We can convert a byte array contents to String using a String constructor as:

    System.out.println(new String(myByteArray).toString());

This will print:


Note that toString is overridden for the String class.

You can also specify the charset for conversion using another overloaded String constructor:

System.out.println(new String(myByteArray, "UTF-8").toString());

This can throw an UnsupportedEncodingException. To know more about charsets and endocings, refer to javajee.com/charset-and-encodings


Automatic string conversion inside println method

Java converts any object into its string representation inside a println() by calling one of the overloaded versions of the String.valueOf() method.



    System.out.println(new StringCheck());




This will output:






Note that the output is exactly same as that of String.valueOf.


Automatic String conversion when using String concatenation operator +

Java doesn't allow operator overloading yet, + is overloaded for class String. When you add a non-string operand such as an integer or char to a String, the non-string operand is converted to a string and string concatenation happens. String conversion using concatenation operator for object references, which include all array types, is defined as follows: If the reference is null, it is converted to the string "null". Otherwise, the conversion is performed as if by an invocation of the toString method of the referenced object with no arguments; but if the result of invoking the toString method is null, then the string "null" is used instead. The string concatenation operator + makes use of toString directly whereas println makes use of String.valueOf and gives special treatment to char arrays. StringBuffer.append() also gives special treatement for char[] through overloading.




    System.out.println(""+new StringCheck());




This will print:






Note that the output is exactly same as that of toString() invocation.


Quick Notes Finder Tags

Activities (1) advanced java (1) agile (3) App Servers (6) archived notes (2) ArrayLists (1) Arrays (2) Best Practices (12) Best Practices (Design) (3) Best Practices (Java) (7) Best Practices (Java EE) (1) BigData (3) Chars & Encodings (6) coding problems (2) Collections (15) contests (3) Core Java (All) (53) course plan (2) Database (12) Design patterns (8) dev tools (3) downloads (2) eclipse (9) Essentials (1) examples (14) Exception (1) Exceptions (4) Exercise (1) exercises (6) Getting Started (18) Groovy (2) hadoop (4) hibernate (77) hibernate interview questions (6) History (1) Hot book (5) http monitoring (2) Inheritance (4) intellij (1) java 8 notes (4) Java 9 (1) Java Concepts (7) Java Core (8) java ee exercises (1) java ee interview questions (2) Java Elements (16) Java Environment (1) Java Features (4) java interview points (4) java interview questions (4) javajee initiatives (1) javajee thoughts (3) Java Performance (6) Java Programmer 1 (12) Java Programmer 2 (8) Javascript Frameworks (1) Java SE Professional (1) JPA 1 - Module (6) JPA 1 - Modules (1) JSP (1) Legacy Java (1) linked list (3) maven (1) Multithreading (16) NFR (1) No SQL (1) Object Oriented (9) OCPJP (4) OCPWCD (1) OOAD (3) Operators (4) Overloading (2) Overriding (2) Overviews (1) policies (1) programming (1) Quartz Scheduler (1) Quizzes (17) RabbitMQ (1) references (2) resources (1) restful web service (3) Searching (1) security (10) Servlets (8) Servlets and JSP (31) Site Usage Guidelines (1) Sorting (1) source code management (1) spring (4) spring boot (3) Spring Examples (1) Spring Features (1) spring jpa (1) Stack (1) Streams & IO (3) Strings (11) SW Developer Tools (2) testing (1) troubleshooting (1) user interface (1) vxml (8) web services (1) Web Technologies (1) Web Technology Books (1) youtube (1)