ה setLength(int newLength) שיטה של StringBuilder class משמשת להגדרת האורך החדש של רצף התווים. האורך החדש של רצף התווים הופך לארגומנט newLength שצוין.

אם הארגומנט newLength קטן מהאורך הנוכחי, האורך החדש של רצף התווים ישתנה ל-newLength. מצד שני, אם הארגומנט newLength גדול מהאורך הנוכחי אז התווי/ות null '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)