The setLength(int newLength) метод на StringBuilder клас се използва за задаване на новата дължина на последователността от знаци. Новата дължина на последователността от знаци се превръща в указан аргумент newLength.

Ако аргументът newLength е по-малък от текущата дължина, новата дължина на последователността от знаци ще се промени на newLength. От друга страна, ако аргументът newLength е по-голям от текущата дължина, тогава нулевият символ(и) 'u0000' се добавят, така че дължината да стане аргументът newLength.

Синтаксис:

 public void setLength(int newLength) 

Параметър:

Се завръща:

ЧЕ

Изключение:

IndexOutOfBoundsException - ако аргументът newLength е отрицателен.

java уеб услуги

Версия за съвместимост:

Java 1.5 и по-нова версия

Пример 1

 public class StringBuilderSetLengthExample1 { public static void main(String[] args) { StringBuilder sb = new StringBuilder('stringbuilder'); System.out.println('string: '+sb); System.out.println('length: '+sb.length()); //set new length of character sequence sb.setLength(6); System.out.println('set new length: '+sb.length()); System.out.println('new sequence: '+sb); } } 

Изход:

 string: stringbuilder length: 13 set new length: 6 new sequence: string 

Пример 2

 public class StringBuilderSetLengthExample2 { public static void main(String[] args) { StringBuilder sb = new StringBuilder('stringbuilder'); System.out.println('string: '+sb); System.out.println('length: '+sb.length()); //set new length of character sequence sb.setLength(20); System.out.println('set new length: '+sb.length()); System.out.println('new sequence: '+sb); } } 

Изход:

 string: stringbuilder length: 13 set new length: 20 new sequence: stringbuilder 

Пример 3

 public class StringBuilderSetLengthExample3 { public static void main(String[] args) { StringBuilder sb = new StringBuilder('stringbuilder'); System.out.println('string: '+sb); System.out.println('length: '+sb.length()); //set new length of character sequence sb.setLength(-1); System.out.println('set new length: '+sb.length()); System.out.println('new sequence: '+sb); } } 

Изход:

 string: stringbuilder length: 13 Exception in thread 'main' java.lang.StringIndexOutOfBoundsException: String index out of range: -1 at java.lang.AbstractStringBuilder.setLength(Unknown Source) at java.lang.StringBuilder.setLength(Unknown Source) at snippet.StringBuilderSetLengthExample3.main(StringBuilderSetLengthExample3.java:7)