Метод setLength

Метод setLength класса StringBuilder устанавливает новую длину строки. В параметр мы передаем целое число - новую длину. Если переданное значение меньше текущей длины, строка обрезается до указанного количества символов. Если больше - строка дополняется нулевыми символами '\u0000' до нужной длины. Если значение отрицательное - выбрасывается исключение StringIndexOutOfBoundsException.

Синтаксис

sb.setLength(newLength)

Пример

Давайте уменьшим длину строки с 5 до 3:

public class Main
{
	public static void main(String[] args)
	{
		StringBuilder sb = new StringBuilder("abcde");
		sb.setLength(3);
		System.out.println(sb.toString());
	}
}

Результат выполнения кода:

"abc"

Пример

Давайте увеличим длину строки с 5 до 8:

public class Main
{
	public static void main(String[] args)
	{
		StringBuilder sb = new StringBuilder("abcde");
		sb.setLength(8);
		System.out.println(sb.length());
	}
}

Результат выполнения кода:

8

Пример

Давайте проверим, что происходит при попытке установить отрицательную длину:

public class Main
{
	public static void main(String[] args)
	{
		StringBuilder sb = new StringBuilder("abcde");
		try
		{
			sb.setLength(-1);
		}
		catch (StringIndexOutOfBoundsException e)
		{
			System.out.println("Exception caught");
		}
	}
}

Результат выполнения кода:

"Exception caught"

Смотрите также

класс StringBuilder,
который создает изменяемую строку
метод length,
который возвращает длину строки
метод append,
который добавляет символы в конец
метод delete,
который удаляет символы из строки