TechCodeview

The setLength(int newLength) menetelmä StringBuilder luokkaa käytetään merkkijonon uuden pituuden asettamiseen. Merkkijonon uudesta pituudesta tulee määritetty newLength-argumentti.

Jos newLength-argumentti on pienempi kuin nykyinen pituus, merkkijonon uusi pituus muuttuu arvoksi newLength. Toisaalta, jos newLength-argumentti on suurempi kuin nykyinen pituus, tyhjä merkki(t) u0000 lisätään siten, että pituudesta tulee newLength-argumentti.

Syntaksi:

 public void setLength(int newLength) 

Parametri:

Palautukset:

ETTÄ

Poikkeus:

IndexOutOfBoundsException - jos newLength-argumentti on negatiivinen.

fonttikoot lateksissa

Yhteensopivuusversio:

Java 1.5 ja uudemmat

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

Lähtö:

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

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

Lähtö:

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

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

Lähtö:

 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)