El setLength(int newLength) mètode de StringBuilder class s'utilitza per establir la nova longitud de la seqüència de caràcters. La nova longitud de la seqüència de caràcters es converteix en l'argument newLength especificat.

Si l'argument newLength és menor que la longitud actual, la nova longitud de la seqüència de caràcters canviarà a newLength. D'altra banda, si l'argument newLength és més gran que la longitud actual, s'afegeixen els caràcters nuls 'u0000' de manera que la longitud es converteixi en l'argument newLength.

Sintaxi:

 public void setLength(int newLength) 

Paràmetre:

Devolucions:

AIXÒ

Excepció:

IndexOutOfBoundsException - si l'argument newLength és negatiu.

clau d'inserció del portàtil

Versió de compatibilitat:

Java 1.5 i superior

Exemple 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); } } 

Sortida:

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

Exemple 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); } } 

Sortida:

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

Exemple 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); } } 

Sortida:

 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)