Class StringBuffer

package java.lang

java.lang.Object
  |
  +--java.lang.StringBuffer

설명

extends Object:

문자열 버퍼는 가변 문자 시퀀스를 구현합니다. 문자열 버퍼는 String과 같지만 수정할 수 있습니다. 항상 특정 문자 시퀀스가 포함되지만 특정 메소드 호출을 통해 시퀀스 길이와 내용을 변경할 수 있습니다.

문자열 버퍼는 여러 스레드에서 안전하게 사용할 수 있습니다. 특정 인스턴스의 모든 작업이 관련된 개별 스레드의 메소드 호출 순서에 따라 순차적으로 발생하는 것처럼 동작하도록 필요할 경우 메소드가 동기화됩니다.

컴파일러는 문자열 버퍼를 사용하여 이진 문자열 연결 연산자 +를 구현합니다. 예를 들어, 다음과 같은 코드가 있습니다.

위의 코드는 다음 코드와 같은 값으로 컴파일됩니다.

이 코드는 초기에 비어 있는 새로운 문자열 버퍼를 만들고 각 피연산자의 문자열 표현을 순서대로 문자열 버퍼에 추가한 다음, 문자열 버퍼 내용을 문자열로 변환합니다. 이렇게 하면 많은 임시 문자열을 만들지 않아도 됩니다.

StringBuffer에서의 주요 작업은 append 메소드와 insert 메소드로, 모든 유형의 데이터를 받아들이도록 오버로드됩니다. 각 메소드는 지정된 데이터를 효과적으로 문자열로 변환한 다음, 해당 문자열의 문자를 문자열 버퍼에 추가 또는 삽입합니다. append 메소드는 이러한 문자를 항상 버퍼 끝에 추가하고 insert 메소드는 지정된 위치에 문자를 추가합니다.

예를 들어, z가 현재 내용이 “start”인 문자열 버퍼 객체를 참조하면 메소드 호출 z.append("le")는 문자열 버퍼에 “startle”을 포함시키고 z.insert(4, "le")는 문자열 버퍼에 “starlet”를 포함시킵니다.

일반적으로 sb가 StringBuffer의 한 인스턴스를 참조하면 sb.append(x)는 sb.insert(sb.length(), x)와 동일한 기능을 합니다.

모든 문자열 버퍼에는 용량이 있습니다. 문자열 버퍼에 포함된 문자 시퀀스의 길이가 용량을 초과하지 않으면 새로운 내부 버퍼 배열을 할당할 필요가 없습니다. 내부 버퍼에 오버플로가 발생하면 자동으로 크기가 확대됩니다.

Since:

• JDK1.0, CLDC 1.0

See Also:

• ByteArrayOutputStream, String

생성자 요약

• StringBuffer () 문자가 포함되어 있지 않으며 초기 용량이 16자인 문자열 버퍼를 구성합니다.
• StringBuffer (int length) 문자가 포함되어 있지 않으며 length 인자로 지정된 초기 용량을 가진 문자열 버퍼를 구성합니다.
• StringBuffer ( String str) 문자열 인자와 동일한 문자 시퀀스를 나타내도록 문자열 버퍼를 구성합니다.

메서드 요약

• StringBuffer append (boolean b) — boolean 인자의 문자열 표현을 이 문자열 버퍼에 추가합니다.
• StringBuffer append (char c) — char 인자의 문자열 표현을 이 문자열 버퍼에 추가합니다.
• StringBuffer append (char[] str) — char 배열 인자의 문자열 표현을 이 문자열 버퍼에 추가합니다.
• StringBuffer append (char[] str, int offset, int len) — char 배열 인자의 하위 배열의 문자열 표현을 이 문자열 버퍼에 추가합니다.
• StringBuffer append (double d) — double 인자의 문자열 표현을 이 문자열 버퍼에 추가합니다.
• StringBuffer append (float f) — float 인자의 문자열 표현을 이 문자열 버퍼에 추가합니다.
• StringBuffer append (int i) — int 인자의 문자열 표현을 이 문자열 버퍼에 추가합니다.
• StringBuffer append (long l) — long 인자의 문자열 표현을 이 문자열 버퍼에 추가합니다.
• StringBuffer append ( Object obj) — Object 인자의 문자열 표현을 이 문자열 버퍼에 추가합니다.
• StringBuffer append ( String str) — 문자열을 이 문자열 버퍼에 추가합니다.
• int capacity () — 문자열 버퍼의 현재 용량을 반환합니다.
• char charAt (int index) — 현재 문자열 버퍼가 나타내는 시퀀스에서 index 인자로 지정된 문자가 반환됩니다.
• StringBuffer delete (int start, int end) — 이 StringBuffer 의 하위 문자열에서 문자를 제거합니다.
• StringBuffer deleteCharAt (int index) — 이 StringBuffer 에서 지정된 위치의 문자를 제거하여 StringBuffer 를 한 자 줄입니다.
• void ensureCapacity (int minimumCapacity) — 버퍼 용량이 최소한 지정된 최소값과 같은지 확인합니다.
• void getChars (int srcBegin, int srcEnd, char[] dst, int dstBegin) — 이 문자열 버퍼의 문자를 대상 문자 배열 dst 에 복사합니다.
• StringBuffer insert (int offset, boolean b) — boolean 인자의 문자열 표현을 이 문자열 버퍼에 삽입합니다.
• StringBuffer insert (int offset, char c) — char 인자의 문자열 표현을 이 문자열 버퍼에 삽입합니다.
• StringBuffer insert (int offset, char[] str) — char 배열 인자의 문자열 표현을 이 문자열 버퍼에 삽입합니다.
• StringBuffer insert (int offset, double d) — double 인자의 문자열 표현을 이 문자열 버퍼에 삽입합니다.
• StringBuffer insert (int offset, float f) — float 인자의 문자열 표현을 이 문자열 버퍼에 삽입합니다.
• StringBuffer insert (int offset, int i) — 두 번째 int 인자의 문자열 표현을 이 문자열 버퍼에 삽입합니다.
• StringBuffer insert (int offset, long l) — long 인자의 문자열 표현을 이 문자열 버퍼에 삽입합니다.
• StringBuffer insert (int offset, Object obj) — Object 인자의 문자열 표현을 이 문자열 버퍼에 삽입합니다.
• StringBuffer insert (int offset, String str) — 문자열을 이 문자열 버퍼에 삽입합니다.
• int length () — 이 문자열 버퍼의 길이(문자 수)를 반환합니다.
• StringBuffer reverse () — 이 문자열 버퍼에 포함된 문자 시퀀스가 역순 시퀀스로 바뀝니다.
• void setCharAt (int index, char ch) — 이 문자열 버퍼에서 지정된 색인의 문자는 ch 로 설정됩니다.
• void setLength (int newLength) — 이 문자열 버퍼의 길이를 설정합니다.
• String toString () — 이 문자열 버퍼의 데이터를 나타내는 문자열로 변환합니다.

생성자 상세

StringBuffer

public StringBuffer()

• 문자가 포함되어 있지 않으며 초기 용량이 16자인 문자열 버퍼를 구성합니다.

StringBuffer

public StringBuffer(int length)

• 문자가 포함되어 있지 않으며 length 인자로 지정된 초기 용량을 가진 문자열 버퍼를 구성합니다.

Parameters:

• length - 초기 용량

Throws:

• NegativeArraySizeException - length 인자가 0보다 작은 경우

StringBuffer

public StringBuffer(String str)

• 문자열 인자와 동일한 문자 시퀀스를 나타내도록 문자열 버퍼를 구성합니다. 즉, 문자열 버퍼의 초기 내용은 인자 문자열의 복사본입니다. 문자열 버퍼의 초기 용량은 16에 문자열 인자의 길이를 더한 값입니다.

Parameters:

• str - 버퍼의 초기 내용

length

public int length()

Returns:

• 현재 이 문자열 버퍼가 나타내는 문자 시퀀스의 길이

capacity

public int capacity()

Returns:

• 이 문자열 버퍼의 현재 용량

ensureCapacity

public void ensureCapacity(int minimumCapacity)

Parameters:

• minimumCapacity - 최소 필요 용량

setLength

public void setLength(int newLength)

Parameters:

• newLength - 새로운 버퍼 길이

Throws:

• IndexOutOfBoundsException - newLength 인자가 음수인 경우

See Also:

• length()

charAt

public char charAt(int index)

Parameters:

• index - 원하는 문자의 색인

Returns:

• 이 문자열 버퍼에서 지정된 색인의 문자

Throws:

• IndexOutOfBoundsException - index가 음수이거나 length()보다 크거나 같은 경우

See Also:

• length()

getChars

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

Parameters:

• dstBegin - dst의 오프셋

Throws:

• IndexOutOfBoundsException - 다음 중 최소 하나 이상이 true인 경우

srcBegin이 음수입니다. dstBegin이 음수입니다. srcBegin 인자가 srcEnd 인자보다 큽니다. srcEnd가 이 문자열 버퍼의 현재 길이인 this.length()보다 큽니다. dstBegin+srcEnd-srcBegin이 dst.length보다 큽니다.

setCharAt

public void setCharAt(int index,
                      char ch)

Parameters:

• ch - 새 문자

Throws:

• IndexOutOfBoundsException - index가 음수이거나 length()보다 크거나 같은 경우

See Also:

• length()

append

public StringBuffer append(Object obj)

Parameters:

• obj - Object

Returns:

• StringBuffer 객체 참조

See Also:

• String.valueOf(java.lang.Object), append(java.lang.String)

append

public StringBuffer append(String str)

Parameters:

• str - 문자열

Returns:

• StringBuffer 참조

append

public StringBuffer append(char[] str)

Parameters:

• str - 추가되는 문자

Returns:

• StringBuffer 객체 참조

append

public StringBuffer append(char[] str,
                           int offset,
                           int len)

Parameters:

• len - 추가할 문자 수

Returns:

• StringBuffer 객체 참조

append

public StringBuffer append(boolean b)

Parameters:

• b - boolean

Returns:

• StringBuffer 참조

See Also:

• String.valueOf(boolean), append(java.lang.String)

append

public StringBuffer append(char c)

Parameters:

• c - char

Returns:

• StringBuffer 객체 참조

append

public StringBuffer append(int i)

Parameters:

• i - int

Returns:

• StringBuffer 객체 참조

See Also:

• String.valueOf(int), append(java.lang.String)

append

public StringBuffer append(long l)

Parameters:

• l - long

Returns:

• StringBuffer 객체 참조

See Also:

• String.valueOf(long), append(java.lang.String)

append

public StringBuffer append(float f)

Parameters:

• f - float

Returns:

• StringBuffer 객체 참조

Since:

• CLDC 1.1

See Also:

• String.valueOf(float), append(java.lang.String)

append

public StringBuffer append(double d)

Parameters:

• d - double

Returns:

• StringBuffer 객체 참조

Since:

• CLDC 1.1

See Also:

• String.valueOf(double), append(java.lang.String)

delete

public StringBuffer delete(int start,
                           int end)

Parameters:

• end - 끝 색인(포함하지 않음)

Returns:

• 이 문자열 버퍼

Throws:

• StringIndexOutOfBoundsException - start가 음수이거나 length()보다 크거나 end보다 큰 경우

Since:

• JDK1.2

deleteCharAt

public StringBuffer deleteCharAt(int index)

Parameters:

• index - 제거할 문자의 색인

Returns:

• 이 문자열 버퍼

Throws:

• StringIndexOutOfBoundsException - index가 음수이거나 length()보다 크거나 같은 경우

Since:

• JDK1.2

insert

public StringBuffer insert(int offset,
                           Object obj)

Parameters:

• obj - Object

Returns:

• StringBuffer 객체 참조

Throws:

• StringIndexOutOfBoundsException - 오프셋이 유효하지 않은 경우

See Also:

• String.valueOf(java.lang.Object), insert(int, java.lang.String), length()

insert

public StringBuffer insert(int offset,
                           String str)

Parameters:

• str - 문자열

Returns:

• StringBuffer 객체 참조

Throws:

• StringIndexOutOfBoundsException - 오프셋이 유효하지 않은 경우

See Also:

• length()

insert

public StringBuffer insert(int offset,
                           char[] str)

Parameters:

• str - 문자 배열

Returns:

• StringBuffer 객체 참조

Throws:

• StringIndexOutOfBoundsException - 오프셋이 유효하지 않은 경우

insert

public StringBuffer insert(int offset,
                           boolean b)

Parameters:

• b - boolean

Returns:

• StringBuffer 객체 참조

Throws:

• StringIndexOutOfBoundsException - 오프셋이 유효하지 않은 경우

See Also:

• String.valueOf(boolean), insert(int, java.lang.String), length()

insert

public StringBuffer insert(int offset,
                           char c)

Parameters:

• c - char

Returns:

• StringBuffer 객체 참조

Throws:

• IndexOutOfBoundsException - 오프셋이 유효하지 않은 경우

See Also:

• length()

insert

public StringBuffer insert(int offset,
                           int i)

Parameters:

• i - int

Returns:

• StringBuffer 객체 참조

Throws:

• StringIndexOutOfBoundsException - 오프셋이 유효하지 않은 경우

See Also:

• String.valueOf(int), insert(int, java.lang.String), length()

insert

public StringBuffer insert(int offset,
                           long l)

Parameters:

• l - long

Returns:

• StringBuffer 객체 참조

Throws:

• StringIndexOutOfBoundsException - 오프셋이 유효하지 않은 경우

See Also:

• String.valueOf(long), insert(int, java.lang.String), length()

insert

public StringBuffer insert(int offset,
                           float f)

Parameters:

• f - float

Returns:

• StringBuffer 객체 참조

Throws:

• StringIndexOutOfBoundsException - 오프셋이 유효하지 않은 경우

Since:

• CLDC 1.1

See Also:

• String.valueOf(float), insert(int, java.lang.String), length()

insert

public StringBuffer insert(int offset,
                           double d)

Parameters:

• d - double

Returns:

• StringBuffer 객체 참조

Throws:

• StringIndexOutOfBoundsException - 오프셋이 유효하지 않은 경우

Since:

• CLDC 1.1

See Also:

• String.valueOf(double), insert(int, java.lang.String), length()

reverse

public StringBuffer reverse()

Returns:

• StringBuffer 객체 참조

Since:

• JDK1.0.2

toString

public String toString()

Overrides:

• toString in class Object

Returns:

• 문자열 버퍼의 문자열 표현

메서드 상세

length

public int length()

Returns:

• 현재 이 문자열 버퍼가 나타내는 문자 시퀀스의 길이

capacity

public int capacity()

Returns:

• 이 문자열 버퍼의 현재 용량

ensureCapacity

public void ensureCapacity(int minimumCapacity)

Parameters:

• minimumCapacity - 최소 필요 용량

setLength

public void setLength(int newLength)

Parameters:

• newLength - 새로운 버퍼 길이

Throws:

• IndexOutOfBoundsException - newLength 인자가 음수인 경우

See Also:

• length()

charAt

public char charAt(int index)

Parameters:

• index - 원하는 문자의 색인

Returns:

• 이 문자열 버퍼에서 지정된 색인의 문자

Throws:

• IndexOutOfBoundsException - index가 음수이거나 length()보다 크거나 같은 경우

See Also:

• length()

getChars

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

Parameters:

• dstBegin - dst의 오프셋

Throws:

• IndexOutOfBoundsException - 다음 중 최소 하나 이상이 true인 경우

srcBegin이 음수입니다. dstBegin이 음수입니다. srcBegin 인자가 srcEnd 인자보다 큽니다. srcEnd가 이 문자열 버퍼의 현재 길이인 this.length()보다 큽니다. dstBegin+srcEnd-srcBegin이 dst.length보다 큽니다.

setCharAt

public void setCharAt(int index,
                      char ch)

Parameters:

• ch - 새 문자

Throws:

• IndexOutOfBoundsException - index가 음수이거나 length()보다 크거나 같은 경우

See Also:

• length()

append

public StringBuffer append(Object obj)

Parameters:

• obj - Object

Returns:

• StringBuffer 객체 참조

See Also:

• String.valueOf(java.lang.Object), append(java.lang.String)

append

public StringBuffer append(String str)

Parameters:

• str - 문자열

Returns:

• StringBuffer 참조

append

public StringBuffer append(char[] str)

Parameters:

• str - 추가되는 문자

Returns:

• StringBuffer 객체 참조

append

public StringBuffer append(char[] str,
                           int offset,
                           int len)

Parameters:

• len - 추가할 문자 수

Returns:

• StringBuffer 객체 참조

append

public StringBuffer append(boolean b)

Parameters:

• b - boolean

Returns:

• StringBuffer 참조

See Also:

• String.valueOf(boolean), append(java.lang.String)

append

public StringBuffer append(char c)

Parameters:

• c - char

Returns:

• StringBuffer 객체 참조

append

public StringBuffer append(int i)

Parameters:

• i - int

Returns:

• StringBuffer 객체 참조

See Also:

• String.valueOf(int), append(java.lang.String)

append

public StringBuffer append(long l)

Parameters:

• l - long

Returns:

• StringBuffer 객체 참조

See Also:

• String.valueOf(long), append(java.lang.String)

append

public StringBuffer append(float f)

Parameters:

• f - float

Returns:

• StringBuffer 객체 참조

Since:

• CLDC 1.1

See Also:

• String.valueOf(float), append(java.lang.String)

append

public StringBuffer append(double d)

Parameters:

• d - double

Returns:

• StringBuffer 객체 참조

Since:

• CLDC 1.1

See Also:

• String.valueOf(double), append(java.lang.String)

delete

public StringBuffer delete(int start,
                           int end)

Parameters:

• end - 끝 색인(포함하지 않음)

Returns:

• 이 문자열 버퍼

Throws:

• StringIndexOutOfBoundsException - start가 음수이거나 length()보다 크거나 end보다 큰 경우

Since:

• JDK1.2

deleteCharAt

public StringBuffer deleteCharAt(int index)

Parameters:

• index - 제거할 문자의 색인

Returns:

• 이 문자열 버퍼

Throws:

• StringIndexOutOfBoundsException - index가 음수이거나 length()보다 크거나 같은 경우

Since:

• JDK1.2

insert

public StringBuffer insert(int offset,
                           Object obj)

Parameters:

• obj - Object

Returns:

• StringBuffer 객체 참조

Throws:

• StringIndexOutOfBoundsException - 오프셋이 유효하지 않은 경우

See Also:

• String.valueOf(java.lang.Object), insert(int, java.lang.String), length()

insert

public StringBuffer insert(int offset,
                           String str)

Parameters:

• str - 문자열

Returns:

• StringBuffer 객체 참조

Throws:

• StringIndexOutOfBoundsException - 오프셋이 유효하지 않은 경우

See Also:

• length()

insert

public StringBuffer insert(int offset,
                           char[] str)

Parameters:

• str - 문자 배열

Returns:

• StringBuffer 객체 참조

Throws:

• StringIndexOutOfBoundsException - 오프셋이 유효하지 않은 경우

insert

public StringBuffer insert(int offset,
                           boolean b)

Parameters:

• b - boolean

Returns:

• StringBuffer 객체 참조

Throws:

• StringIndexOutOfBoundsException - 오프셋이 유효하지 않은 경우

See Also:

• String.valueOf(boolean), insert(int, java.lang.String), length()

insert

public StringBuffer insert(int offset,
                           char c)

Parameters:

• c - char

Returns:

• StringBuffer 객체 참조

Throws:

• IndexOutOfBoundsException - 오프셋이 유효하지 않은 경우

See Also:

• length()

insert

public StringBuffer insert(int offset,
                           int i)

Parameters:

• i - int

Returns:

• StringBuffer 객체 참조

Throws:

• StringIndexOutOfBoundsException - 오프셋이 유효하지 않은 경우

See Also:

• String.valueOf(int), insert(int, java.lang.String), length()

insert

public StringBuffer insert(int offset,
                           long l)

Parameters:

• l - long

Returns:

• StringBuffer 객체 참조

Throws:

• StringIndexOutOfBoundsException - 오프셋이 유효하지 않은 경우

See Also:

• String.valueOf(long), insert(int, java.lang.String), length()

insert

public StringBuffer insert(int offset,
                           float f)

Parameters:

• f - float

Returns:

• StringBuffer 객체 참조

Throws:

• StringIndexOutOfBoundsException - 오프셋이 유효하지 않은 경우

Since:

• CLDC 1.1

See Also:

• String.valueOf(float), insert(int, java.lang.String), length()

insert

public StringBuffer insert(int offset,
                           double d)

Parameters:

• d - double

Returns:

• StringBuffer 객체 참조

Throws:

• StringIndexOutOfBoundsException - 오프셋이 유효하지 않은 경우

Since:

• CLDC 1.1

See Also:

• String.valueOf(double), insert(int, java.lang.String), length()

reverse

public StringBuffer reverse()

Returns:

• StringBuffer 객체 참조

Since:

• JDK1.0.2

toString

public String toString()

Overrides:

• toString in class Object

Returns:

• 문자열 버퍼의 문자열 표현