Java.lang.StringBuilder Class



Introduction

The java.lang.StringBuilder class is mutable sequence of characters. This provides an API compatible with StringBuffer, but with no guarantee of synchronization.

Class Declaration

Following is the declaration for java.lang.StringBuilder class −

public final class StringBuilder
   extends Object
      implements Serializable, CharSequence

Class constructors

Sr.No. Constructor & Description
1

StringBuilder()

This constructs a string builder with no characters in it and an initial capacity of 16 characters.

2

StringBuilder(CharSequence seq)

This constructs a string builder that contains the same characters as the specified CharSequence.

3

StringBuilder(int capacity)

This constructs a string builder with no characters in it and an initial capacity specified by the capacity argument.

4

StringBuilder(String str)

This constructs a string builder initialized to the contents of the specified string.

Class methods

Sr.No. Method & Description
1 StringBuilder append(boolean b)

This method appends the string representation of the boolean argument to the sequence.

2 StringBuilder append(char c)

This method appends the string representation of the char argument to this sequence.

3 StringBuilder append(char[] str)

This method appends the string representation of the char array argument to this sequence.

4 StringBuilder append(char[] str, int offset, int len)

This method appends the string representation of a subarray of the char array argument to this sequence.

5 StringBuilder append(CharSequence s)

This method appends the specified character sequence to this Appendable.

6 StringBuilder append(CharSequence s, int start, int end)

This method appends a subsequence of the specified CharSequence to this sequence.

7 StringBuilder append(double d)

This method appends the string representation of the double argument to this sequence.

8 StringBuilder append(float f)

This method appends the string representation of the float argument to this sequence.

9 StringBuilder append(int i)

This method appends the string representation of the int argument to this sequence.

10 StringBuilder append(long lng)

This method appends the string representation of the long argument to this sequence.

11 StringBuilder append(Object obj)

This method appends the string representation of the Object argument.

12 StringBuilder append(String str)

This method appends the specified string to this character sequence.

13 StringBuilder append(StringBuffer sb)

This method appends the specified StringBuffer to this sequence.

14 StringBuilder appendCodePoint(int codePoint)

This method appends the string representation of the codePoint argument to this sequence.

15 int capacity()

This method returns the current capacity.

16 char charAt(int index)

This method returns the char value in this sequence at the specified index.

17 int codePointAt(int index)

This method returns the character (Unicode code point) at the specified index.

18 int codePointBefore(int index)

This method returns the character (Unicode code point) before the specified index.

19 int codePointCount(int beginIndex, int endIndex)

This method returns the number of Unicode code points in the specified text range of this sequence.

20 StringBuilder delete(int start, int end)

This method removes the characters in a substring of this sequence.

21 StringBuilder deleteCharAt(int index)

This method removes the char at the specified position in this sequence.

22 void ensureCapacity(int minimumCapacity)

This method ensures that the capacity is at least equal to the specified minimum.

23 void getChars(int srcBegin, int srcEnd, char[] dst, int dstBegin)

Characters are copied from this sequence into the destination character array dst.

24 int indexOf(String str)

This method returns the index within this string of the first occurrence of the specified substring.

25 int indexOf(String str, int fromIndex)

This method returns the index within this string of the first occurrence of the specified substring, starting at the specified index.

26 StringBuilder insert(int offset, boolean b)

This method inserts the string representation of the boolean argument into this sequence.

27 StringBuilder insert(int offset, char c)

This method inserts the string representation of the char argument into this sequence.

28 StringBuilder insert(int offset, char[] str)

This method inserts the string representation of the char array argument into this sequence.

29 StringBuilder insert(int index, char[] str, int offset, int len)

This method inserts the string representation of a subarray of the str array argument into this sequence.

30 StringBuilder insert(int dstOffset, CharSequence s)

This method inserts the specified CharSequence into this sequence.

31 StringBuilder insert(int dstOffset, CharSequence s, int start, int end)

This method inserts a subsequence of the specified CharSequence into this sequence.

32 StringBuilder insert(int offset, double d)

This method inserts the string representation of the double argument into this sequence.

33 StringBuilder insert(int offset, float f)

This method inserts the string representation of the float argument into this sequence.

34 StringBuilder insert(int offset, int i)

This method inserts the string representation of the second int argument into this sequence.

35 StringBuilder insert(int offset, long l)

This method inserts the string representation of the long argument into this sequence.

36 StringBuilder insert(int offset, Object obj)

This method inserts the string representation of the Object argument into this character sequence.

37 StringBuilder insert(int offset, String str)

This method inserts the string into this character sequence.

38 int lastIndexOf(String str)

This method returns the index within this string of the rightmost occurrence of the specified substring.

39 int lastIndexOf(String str, int fromIndex)

This method returns the index within this string of the last occurrence of the specified substring.

40 int length()

This method returns the length (character count).

41 int offsetByCodePoints(int index, int codePointOffset)

This method returns the index within this sequence that is offset from the given index by codePointOffset code points.

42 StringBuilder replace(int start, int end, String str)

This method replaces the characters in a substring of this sequence with characters in the specified String.

43 StringBuilder reverse()

This method causes this character sequence to be replaced by the reverse of the sequence.

44 void setCharAt(int index, char ch)

Character at the specified index is set to ch.

45 void setLength(int newLength)

This method sets the length of the character sequence.

46 CharSequence subSequence(int start, int end)

This method returns a new character sequence that is a subsequence of this sequence.

47 String substring(int start)

This method returns a new String that contains a subsequence of characters currently contained in this character sequence.

48 String substring(int start, int end)

This method returns a new String that contains a subsequence of characters currently contained in this sequence.

49 String toString()

This method returns a string representing the data in this sequence.

50 void trimToSize()

This method attempts to reduce storage used for the character sequence.

Methods inherited

This class inherits methods from the following classes −

  • java.lang.Object
  • java.lang.CharSequence

Advertisements