Если число newLength окажется отрицательным, возникнет исключительная ситуация.
Будьте осторожны, устанавливая новую длину объекта.
Количество символов в строке можно узнать, как и для объекта класса String, методом
length (), а емкость — методом capacity ().
Создать объект класса StringBuilder можно только конструкторами.
В классе StringBuilder четыре конструктора:
□ StringBuilder () — создает пустой объект с емкостью 16 символов;
□ StringBuilder (int capacity) создает пустой объект заданной емкости capacity;
□ StringBuilder(String str) — создает объект емкостью str.length() + 16, содержащий строку str;
□ StringBuilder(CharSequence str) — создает объект, содержащий строку str.
В классе StringBuilder есть более десяти методов append (), добавляющих подстроку в конец строки. Они не создают новый экземпляр строки, а возвращают ссылку на ту же самую, но измененную строку.
Основной метод append(String str) присоединяет строку str в конец данной строки. Если ссылка str == null, то добавляется строка "null".
Два аналогичных метода работают с параметром типа StringBuffer и CharSequence.
Шесть методов append(type elem) добавляют примитивные типы boolean, char, int, long, float, double, преобразованные в строку.
Два метода присоединяют к строке массив str и подмассив sub символов, преобразованные в строку:
append(char[] str);
append(char[] sub, int offset, int len);
Еще один метод, append(CharSequence sub, int offset, int len), использует параметр типа CharSequence.
Тринадцатый метод, append(Object obj), добавляет просто объект. Перед этим объект obj преобразуется в строку своим методом toString ( ).
Более десяти методов insert () предназначены для вставки строки, указанной вторым параметром метода, в данную строку. Место вставки задается первым параметром метода, индексом символа строки, перед которым будет сделана вставка. Он должен быть неотрицательным и меньше длины строки, иначе возникнет исключительная ситуация. Строка раздвигается, емкость буфера при необходимости увеличивается. Методы возвращают ссылку на ту же самую, но преобразованную строку.
Основной метод insert(int ind, String str) вставляет строку str в данную строку перед ее символом с индексом ind. Если ссылка str == null, вставляется строка "null".
Например, после выполнения
String s = new StringBuilder("3TO большая строка").
insert(4, "не").toString();
получим s == "Это небольшая строка".
Метод sb.insert(sb.length (), "xxx") будет работать так же, как метод sb.append("xxx").
Шесть методов insert(int ind, type elem) вставляют примитивные типы boolean, char,
int, long, float, double, преобразованные в строку.
Два метода вставляют массив str и подмассив sub символов, преобразованные в строку:
insert(int ind, char[] str);
insert(int ind, char[] sub, int offset, int len);
Десятый метод вставляет просто объект: insert(int ind, Object obj). Объект obj перед добавлением преобразуется в строку своим методом toString().
Еще два метода:
insert(int ind, CharSequence str);
insert(int ind, CharSequence sub, int start, int end); работают с параметром типа CharSequence.
Метод delete (int begin, int end) удаляет из строки символы, начиная с индекса begin включительно до индекса end исключительно; если end больше длины строки, то до конца строки.
Например, после выполнения
String s = new StringBuilderC^TO небольшая строка").
delete(4, 6).toString();
получим s == "Это большая строка".
Если begin отрицательно, больше длины строки или больше end, возникает исключительная ситуация.
Если begin == end, удаление не происходит.
Метод deleteCharAt(int ind) удаляет символ с указанным индексом ind. Длина строки уменьшается на единицу.
Если индекс ind отрицателен или больше длины строки, возникает исключительная ситуация.
Метод replace (int begin, int end, String str) удаляет символы из строки, начиная с индекса begin включительно до индекса end исключительно, а если end больше длины строки, то до конца строки, и вставляет вместо них строку str.
Если begin отрицательно, больше длины строки или больше end, возникает исключительная ситуация.
Разумеется, метод replace () — это последовательное выполнение методов delete ()
и insert().
Метод reverse () меняет порядок расположения символов в строке на обратный. Например, после выполнения
String s = new StringBuilderC^TO небольшая строка"). reverse().toString();
получим s == "акортс яашьлобен отЭ".
Синтаксический разбор строки
Задача разбора введенного текста —