The setLength(int newLength) spôsob StringBuilder class sa používa na nastavenie novej dĺžky sekvencie znakov. Nová dĺžka sekvencie znakov sa zmení na zadaný argument newLength.

Ak je argument newLength menší ako aktuálna dĺžka, nová dĺžka sekvencie znakov sa zmení na newLength. Na druhej strane, ak je argument newLength väčší ako aktuálna dĺžka, pridajú sa nulové znaky 'u0000', takže dĺžka sa stane argumentom newLength.

Syntax:

 public void setLength(int newLength) 

Parameter:

Vrátenie:

TO

Výnimka:

IndexOutOfBoundsException - ak je argument newLength záporný.

kreslenie obdĺžnika gimp

Verzia kompatibility:

Java 1.5 a vyššie

Príklad 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); } } 

Výkon:

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

Príklad 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); } } 

Výkon:

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

Príklad 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); } } 

Výkon:

 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)