logo

Método Java StringBuilder setLength()

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)