java.lang.StringBuilder setLength(int newLength)
Description
As a general rule, newLength method argument must be greater than or equal to 0.
Notes:
- An IndexOutOfBoundsException will be thrown by the setLength(int newLength) method if the newLength argument is negative.
Method Syntax
public void setLength(int newLength)
Method Argument
Data Type | Parameter | Description |
---|---|---|
int | newLength | the new length of this StringBuilder |
Method Returns
The setLength(int newLength) method returns void.
Compatibility
Requires Java 1.5 and up
Java StringBuilder setLength(int newLength) Example
Below is a java code demonstrates the use of setLength(int newLength) method of StringBuilder class. The example presented might be simple however it shows the behavior of the setLength() method.
package com.javatutorialhq.java.examples; /* * A java example source code to demonstrate * the use of setLength() method of StringBuilder class */ public class StringBuilderSetLengthExample { public static void main(String[] args) { // initialize the StringBuilder object StringBuilder sb = new StringBuilder("java-tutorial"); System.out.println("Length of StringBuilder:" + sb.length()); System.out.println("Contents of StringBuilder:" + sb); // set the length of the buffer to 5 sb.setLength(5); // checking the length and contents after setting the length System.out.println("New Length of StringBuilder:" + sb.length()); System.out.println("New Contents of StringBuilder:" + sb); } }
The java example source code above, demonstrates the use of setCharAt(int index,char ch) method of StringBuilder class. Initially the code assigns a string “java-tutorial” as initial contents of the StringBuilder. The length of the string is 13. Then we have set the length of the StringBuilder to be 5. The code displays the new length and contents of the StringBuilder object. You would noticed that upon setting the length to a shorter value than the contents of the StringBuilder, the contents will be truncated.
It would be interesting to note that if we set the length of the StringBuilder to the higher value than the current length, blank spaces will be appended.