Java.lang.StringBuffer.setLength() Method

---

Description

The java.lang.StringBuffer.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.StringBuffer.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.StringBuffer.setLength() method.

package com.tutorialspoint;

import java.lang.*;

public class StringBufferDemo {
 
   public static void main(String[] args) {
  
      StringBuffer buff = new StringBuffer("tutorials");
      System.out.println("buffer1 = " + buff);  
      
      // length of stringbuffer
      System.out.println("length = " + buff.length());
 
      // set the length of stringbuffer to 5
      buff.setLength(5);

      // print new stringbuffer value after changing length
      System.out.println("buffer2 = " + buff);
      
      // length of stringbuffer after changing length
      System.out.println("length = " + buff.length());
   }
}

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

buffer1 = tutorials
length = 9
buffer2 = tutor
length = 5