O setLength(int novoComprimento) método de StringBuilder class é usada para definir o novo comprimento da sequência de caracteres. O novo comprimento da sequência de caracteres torna-se o argumento newLength especificado.
Se o argumento newLength for menor que o comprimento atual, o novo comprimento da sequência de caracteres será alterado para newLength. Por outro lado, se o argumento newLength for maior que o comprimento atual, os caracteres nulos 'u0000' serão anexados para que o comprimento se torne o argumento newLength.
Sintaxe:
public void setLength(int newLength)
Parâmetro:
Tipo de dados | Parâmetro | Descrição |
---|---|---|
interno | novoComprimento | É um novo comprimento de sequência de caracteres. |
Retorna:
QUE
Exceção:
IndexOutOfBoundsException - se o argumento newLength for negativo.
inteiro duplo java
Versão de compatibilidade:
Java 1.5 e superior
Exemplo 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); } }Teste agora
Saída:
string: stringbuilder length: 13 set new length: 6 new sequence: string
Exemplo 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); } }Teste agora
Saída:
string: stringbuilder length: 13 set new length: 20 new sequence: stringbuilder
Exemplo 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); } }Teste agora
Saída:
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)