Java.lang.StringBuilder.setLength() Method

Description

The java.lang.StringBuilder.setLength() method sets the length of the character sequence. The sequence is changed to a new character sequence whose length is specified by the argument.
If the newLength argument is greater than or equal to the current length, sufficient null characters ('\u0000') are appended so that length becomes the newLength argument.

Declaration

Following is the declaration for java.lang.StringBuilder.setLength() method

public void setLength(int newLength)

Parameters

• newLength -- This is the new length.

Return Value

This method does not return any value.

Exception

• IndexOutOfBoundsException -- if the newLength argument is negative.

Example

The following example shows the usage of java.lang.StringBuilder.setLength() method.

package com.tutorialspoint;

import java.lang.*;

public class StringBuilderDemo {

  public static void main(String[] args) {
  
    StringBuilder str = new StringBuilder("tutorials");
    System.out.println("string = " + str);  
    // length of StringBuilder
    System.out.println("length = " + str.length());
        
    // set the length of StringBuilder to 5
    str.setLength(5);
        
    // print new StringBuilder value after changing length
    System.out.println("After set, string = " + str);
    // length of StringBuilder after changing length
    System.out.println("length = " + str.length());
  }
}

Let us compile and run the above program, this will produce the following result:

string = tutorials
length = 9
After set, string = tutor
length = 5