Java String formatting FAQ: How can I format Java String output?
You can format Java string output with the
format method of the
String class, which works like a “Java sprintf” method. Here are some examples:
// output a string log.debug( String.format("The rename status is (%d)", RENAME_SUCCEEDED) ); // format some text and assign it to a string String status = String.format("The rename status is (%d)", RENAME_SUCCEEDED); // how to format a string with multiple variables log.debug( String.format("%s is %d years old, er, young", "Al", 45) );
For more information on those examples, see the sections below.
A String.format example
Here’s a quick example of how to use the
String.format method to format a string before I pass it to a Log4J
log.debug( String.format("The rename status is (%d)", RENAME_SUCCEEDED) );
If you’re familiar with the sprintf function from other languages like C, Perl, or Ruby, this syntax will look familiar. But, if you’re not familiar with this syntax, what happens in the line of code above is that the
%d in my Java String is replaced by the value of the variable
RENAME_SUCCEEDED, which in this case happens to be a constant in my class. The
%d symbol is a placeholder that indicates that a decimal value (something like an
long in Java) should be printed in place of this symbol. The value of that decimal comes from the variable that follows my string, in this case the
Java ‘sprintf’: assigning a formatted String to another String
If it helps to see the format method used without the additional
log.debug method, here’s an example where I use the String.format method to assign a similarly formatted String to another String:
String status = String.format("The rename status is (%d)", RENAME_SUCCEEDED);
Using String.format with multiple variables
Finally, here is an example of how to use multiple variables with the String
log.debug( String.format("%s is %d years old, er, young", "Al", 45) );
Note that I keep using the
log.debug method in these examples for a reason, specifically that I want to show this String format method. However, if you’re interested in just printing formatted strings to system output or system error, there are
System.err.format methods that are very similar to the String
format method. Rather than make this tutorial any longer, here’s a link to a Java System.out.format (Java printf) example.
More “printf” style formatting examples
As a final note, if you’re not familiar with the
printf function in other languages, including all the different
printf print formatting options you can use, I’ve put together this printf format examples page, with
printf examples shown in several different programming languages.
Very Useful Info Thanks for the same
SUDDENLY!!! - IT'S THE MIDDLE OF THE NIGHT AND I'M DRAWING A BLANK!!! Thanks, this was very helpful.
Is there any difference in performance of using
String.format("%1s %2s %3s",x,y,z);
String a = x+y+z;
I don't know what the performance difference is there, you'd have to write some tests to see. However, if this is in a production program, I'd use the normal String concatenation operator, or a StringBuilder, as opposed to the String.format approach. The first two are a little more standard and probably more easily maintainable.