java.lang
클래스 StringBuilder

java.lang.Object 
  java.lang.StringBuilder

모든 구현된 인터페이스:

Serializable, Appendable, CharSequence

public final class StringBuilder
extends Object 
implements Serializable,
 CharSequence 

문자의 가변 순서입니다. 이 클래스는 StringBuffer와 호환성이 있는 API를 제공합니다만, 동기화는 보증되지 않습니다. 이 클래스는 캐릭터 라인 버퍼가 단일의 thread (일반적인 케이스)에 의해 사용되고 있었을 경우의 StringBuffer 의 간단한 대체로서 사용되도록 설계되고 있습니다. 이 클래스는 대부분의 구현으로 고속으로 실행되므로 가능한 경우는 StringBuffer 보다 우선해 사용하는 것을 추천합니다.

StringBuilder 기본적인 오퍼레이션에는 append 메서드 및 insert 메서드가 있어, 이러한 메서드는 어떤 종류의 데이터도 받을 수가 있도록 overload 되고 있습니다. 메서드는 각각 주어진 데이터를 효율적으로 캐릭터 라인으로 변환해, 캐릭터 라인중의 문자를 캐릭터 라인 빌더에 추가 또는 삽입합니다. append 메서드는 항상, 빌더 의 말미에게 줄 수 있었던 문자를 추가해, insert 메서드는 지정된 위치에 문자를 추가합니다.

예를 들어, z를, 현재 「start」를 포함한 캐릭터 라인 빌더 오브제크트라고 보는 경우, z.append("le") 메서드 호출은 캐릭터 라인 빌더 의 내용이 「startle」가 되도록 변경하는데 대해, z.insert(4, "le") 라고 하는 메서드 호출은 캐릭터 라인 빌더 의 내용이 「starlet」가 되도록 작용합니다.

일반적으로 sb가 StringBuilder 인스턴스를 참조하고 있는 경우, sb.append(x)는 sb.insert(sb.length(), x)와 같은 결과가 됩니다. 각 캐릭터 라인 빌더에 는 용량이 있습니다. 캐릭터 라인 빌더에 포함되는 캐릭터 라인의 길이가 용량을 초과하지 않는 한, 새로운 내부 버퍼를 할당할 필요는 없습니다. 내 부 버퍼가 오버플로우 하는 경우, 자동적으로 용량이 증가합니다.

StringBuilder 의 인스턴스는 복수의 thread로 사용하기에는 안전하지는 않습니다. 이러한 동기가 필요한 경우는 StringBuffer 를 사용하는 것을 추천합니다.

도입된 버전 :

1.5

관련 항목:

StringBuffer, String, 직렬화 된 형태 식

생성자 개요

StringBuilder ()
문자를 가지지 않고, 초기 용량이 16 문자인 캐릭터 라인 빌더 를 구축합니다.

StringBuilder (CharSequence seq)
지정된 CharSequence 인수와 같은 문자를 포함한 캐릭터 라인 빌더 를 구축합니다.

StringBuilder (int capacity)
문자를 가지지 않고, 수용 인수에 따라서 지정된 초기 용량의 캐릭터 라인 빌더 를 구축합니다.

StringBuilder (String str)
지정된 캐릭터 라인의 내용에 초기화된 캐릭터 라인 빌더 를 구축합니다.

메서드 개요

StringBuilder	append (boolean b) boolean 인수의 캐릭터 라인 표현을 이 순서에 추가합니다.
StringBuilder	append (char c) char 인수의 캐릭터 라인 표현을 이 순서에 추가합니다.
StringBuilder	append (char[] str) char 배열 인수의 캐릭터 라인 표현을 이 순서에 추가합니다.
StringBuilder	append (char[] str, int offset, int len) char 배열 인수의 부분 배열의 캐릭터 라인 표현을 이 순서에 추가합니다.
StringBuilder	append (CharSequence s) 이 Appendable (으)로 지정된 문자 순서를 추가합니다.
StringBuilder	append (CharSequence s, int start, int end) 지정된 CharSequence 의 서브 순서를 이 순서에 추가합니다.
StringBuilder	append (double d) double 인수의 캐릭터 라인 표현을 이 순서에 추가합니다.
StringBuilder	append (float f) float 인수의 캐릭터 라인 표현을 이 순서에 추가합니다.
StringBuilder	append (int i) int 인수의 캐릭터 라인 표현을 이 순서에 추가합니다.
StringBuilder	append (long lng) long 인수의 캐릭터 라인 표현을 이 순서에 추가합니다.
StringBuilder	append (Object obj) Object인수의 캐릭터 라인 표현을 이 순서에 추가합니다.
StringBuilder	append (String str) 지정된 캐릭터 라인을 이 문자 순서에 추가합니다.
StringBuilder	append (StringBuffer sb) 지정된 StringBuffer를 이 순서에 추가합니다.
StringBuilder	appendCodePoint (int codePoint) codePoint 인수의 캐릭터 라인 표현을 이 순서에 추가합니다.
int	capacity () 현재의 용량을 리턴합니다.
char	charAt (int index) 지정된 인덱스 위치에 있다 char값을 리턴합니다.
int	codePointAt (int index) 지정된 인덱스 위치의 문자 (Unicode 코드 포인트)를 리턴합니다.
int	codePointBefore (int index) 지정된 인덱스의 전의 문자 (Unicode 코드 포인트)를 리턴합니다.
int	codePointCount (int beginIndex, int endIndex) 이 순서의 지정된 텍스트 범위의 Unicode 코드 포인트의 수를 리턴합니다.
StringBuilder	delete (int start, int end) 이 순서의 부분 캐릭터 라인내의 문자를 모두 삭제합니다.
StringBuilder	deleteCharAt (int index) 이 순서내의 지정된 위치에 있는 문자를 삭제합니다.
void	ensureCapacity (int minimumCapacity) 용량이 지정된 최소값 이상이 되는 것을 보증합니다.
void	getChars (int srcBegin, int srcEnd, char[] dst, int dstBegin) 이 순서로부터, 카피처의 문자 배열 dst에 문자를 카피합니다.
int	indexOf (String str) 이 캐릭터 라인내에서 지정된 부분 캐릭터 라인이 최초로 출현하는 위치의 인덱스를 리턴합니다.
int	indexOf (String str, int fromIndex) 지정된 인덱스 이후로 지정된 부분 캐릭터 라인이 이 캐릭터 라인내에서 최초로 출현하는 위치의 인덱스를 리턴합니다.
StringBuilder	insert (int offset, boolean b) boolean 인수의 캐릭터 라인 표현을 이 순서에 삽입합니다.
StringBuilder	insert (int offset, char c) char 인수의 캐릭터 라인 표현을 이 순서에 삽입합니다.
StringBuilder	insert (int offset, char[] str) char 배열 인수의 캐릭터 라인 표현을 이 순서에 삽입합니다.
StringBuilder	insert (int index, char[] str, int offset, int len) str 배열 인수의 부분 배열의 캐릭터 라인 표현을 이 순서에 삽입합니다.
StringBuilder	insert (int dstOffset, CharSequence s) 지정된 CharSequence를 이 순서에 삽입합니다.
StringBuilder	insert (int dstOffset, CharSequence s, int start, int end) 지정된 CharSequence 의 서브 순서를 이 순서에 삽입합니다.
StringBuilder	insert (int offset, double d) double 인수의 캐릭터 라인 표현을 이 순서에 삽입합니다.
StringBuilder	insert (int offset, float f) float 인수의 캐릭터 라인 표현을 이 순서에 삽입합니다.
StringBuilder	insert (int offset, int i) 2번째의 int 인수의 캐릭터 라인 표현을 이 순서에 삽입합니다.
StringBuilder	insert (int offset, long l) long 인수의 캐릭터 라인 표현을 이 순서에 삽입합니다.
StringBuilder	insert (int offset, Object obj) Object 인수의 캐릭터 라인 표현을 이 문자 순서에 삽입합니다.
StringBuilder	insert (int offset, String str) 캐릭터 라인을 이 문자 순서에 삽입합니다.
int	lastIndexOf (String str) 이 캐릭터 라인내에서 지정된 부분 캐릭터 라인이 제일 오른쪽으로 출현하는 위치의 인덱스를 리턴합니다.
int	lastIndexOf (String str, int fromIndex) 이 캐릭터 라인내에서 지정된 부분 캐릭터 라인이 마지막에 출현하는 위치의 인덱스를 리턴합니다 (검색은 지정된 인덱스로부터 시작되어 선두 방향에 행해진다).
int	length () 이 캐릭터 라인의 길이를 리턴합니다.
int	offsetByCodePoints (int index, int codePointOffset) codePointOffset 코드 포인트에 의해 지정된 index로 부터의 오프셋(offset)인 이 순서내의 인덱스를 리턴합니다.
StringBuilder	replace (int start, int end, String str) 이 순서의 부분 캐릭터 라인의 문자를, 지정된 String 문자에 치환합니다.
StringBuilder	reverse () 이 문자 순서가 역의 줄 순서의 순서에 치환됩니다.
void	setCharAt (int index, char ch) 지정된 인덱스 위치의 문자가 ch가 되도록 설정합니다.
void	setLength (int newLength) 이 문자 순서의 길이를 설정합니다.
CharSequence	subSequence (int start, int end) 이 순서의 서브 순서인 새로운 문자 순서를 리턴합니다.
String	substring (int start) 이 문자 순서에 현재 포함되고 있는 캐릭터 라인의 일부가 들어간 새로운 String를 리턴합니다.
String	substring (int start, int end) 이 순서에 현재 포함되고 있는 캐릭터 라인의 일부가 들어간 새로운 String를 리턴합니다.
String	toString () 이 순서의 데이터를 표현하는 캐릭터 라인을 리턴합니다.
void	trimToSize () 문자 순서에 사용되는 기억 영역을 줄이려고 합니다.

클래스 java.lang. Object (으)로부터 상속된 메서드

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

인터페이스 java.lang. CharSequence (으)로부터 상속된 메서드

charAt, length, subSequence

생성자 상세

StringBuilder

public StringBuilder()

문자를 가지지 않고, 초기 용량이 16 문자인 캐릭터 라인 빌더 를 구축합니다.

StringBuilder

public StringBuilder(int capacity)

문자를 가지지 않고, 수용 인수에 의해 지정된 초기 용량의 캐릭터 라인 빌더 를 구축합니다.

파라미터:

capacity - 초기 용량

예외:

NegativeArraySizeException - 수용 인수가 0 미만의 경우

StringBuilder

public StringBuilder(String  str)

지정된 캐릭터 라인의 내용에 초기화된 캐릭터 라인 빌더 를 구축합니다. 캐릭터 라인 빌더 의 초기 용량은, 16에 캐릭터 라인 인수의 길이를 더한 것입니다.

파라미터:

str - 버퍼의 초기 내용

예외:

NullPointerException - str 하지만 null인 경우

StringBuilder

public StringBuilder(CharSequence  seq)

지정된 CharSequence 인수와 같은 문자를 포함한 캐릭터 라인 빌더 를 구축합니다. 캐릭터 라인 빌더 의 초기 용량은, 16에 CharSequence 인수의 길이를 더한 것입니다.

파라미터:

seq - 복제 대상의 순서

예외:

NullPointerException - seq 하지만 null인 경우

메서드의 상세

append

public StringBuilder  append(Object  obj)

Object인수의 캐릭터 라인 표현을 추가합니다.

인수는 String.valueOf 메서드에 의해 변환되는 경우와 같이 캐릭터 라인에 변환되어 그 캐릭터 라인의 문자가 이 순서에 추가됩니다.

파라미터:

obj - Object

반환값:

객체에의 참조

관련 항목:

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

append

public StringBuilder  append(String  str)

지정된 캐릭터 라인을 이 문자 순서에 추가합니다.

String 인수의 문자가 차례로 이 순서에 추가됩니다. 그 결과, 인수의 길이의 분만큼 이 순서의 길이가 증가합니다. str 하지만 null인 경우, "null" 4 문자가 추가됩니다.

append 메서드의 실행의 직전에 문자 순서에 포함되고 있던 캐릭터 라인의 길이가 n 그리고, k가 n 보다 작은 경우, 새로운 문자 순서내의 인덱스 k에 있는 문자는 이전의 문자 순서내의 인덱스 k에 있는 문자에 동일해집니다. 그렇지 않은 경우는 인수 str 안의 인덱스 k-n에 있는 문자에 동일해집니다.

파라미터:

str - 캐릭터 라인

반환값:

이 객체에의 참조

append

public StringBuilder  append(StringBuffer  sb)

지정된 StringBuffer를 이 순서에 추가합니다.

StringBuffer 인수의 문자가 차례로 이 순서에 추가됩니다. 그 결과, 인수의 길이의 분만큼 이 순서의 길이가 증가합니다. sb가 null 의 경우, "null" 4 문자가 이 순서에 추가됩니다.

append 메서드의 실행 직전의 이 문자 순서의 길이가 n 로 새로운 문자 순서내의 인덱스 k가 n 미만의 경우, 인덱스 k에 있는 문자는 이전의 문자 순서내의 인덱스 k에 있는 문자에 동일해집니다. 그렇지 않은 경우는 인수 sb 내의 인덱스 k-n에 있는 문자에 동일해집니다.

파라미터:

sb - 추가하는 StringBuffer

반환값:

이 객체에의 참조

append

public StringBuilder  append(CharSequence  s)

인터페이스 Appendable 의 기술:

이 Appendable로 지정된 문자 순서를 추가합니다.

문자 순서 csq를 구현하는 클래스에 따라서는 문자 순서 전체가 추가되지 않을 가능성이 있습니다. 예를 들어, csq가 CharBuffer 인 경우, 추가되는 문자 서브 순서는 버퍼의 위치 또는 제한에 의해 정의됩니다.

정의:

인터페이스 Appendable 내의 append

파라미터:

s - 추가되는 문자 순서. csq가 null 의 경우는 이 Appendable에 "null" 4 문자가 추가된다

반환값:

이 Appendable에 의 참조

예외:

IndexOutOfBoundsException

append

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

지정된 CharSequence 서브 순서를 이 순서에 추가합니다.

인수 s 문자는 인덱스 start로 부터 시작되어 인덱스 end (이 값을 포함하지 않는다)까지 차례로 이 순서의 내용에 추가됩니다. 이 순서의 길이는 end - start 치 분 길어집니다.

append 메서드의 실행의 직전에 문자 순서에 포함되고 있던 캐릭터 라인의 길이가 n 로 k가 n 보다 작은 경우, 이 문자 순서내의 인덱스 k 에 있는 문자는 이 순서내의 인덱스 k에 있는 문자에 동일해집니다. 그렇지 않은 경우는 인수 s에 있는 인덱스 k+start-n에 있는 문자에 동일해집니다.

s가 null인 경우, 이 메서드는 s 파라미터가 "null" 의 4 문자를 포함한 순서였다고의해 문자를 추가합니다.

정의:

인터페이스 Appendable 내의 append

파라미터:

s - 추가하는 순서

start - 추가되는 서브 순서의 개시 인덱스

end - 추가되는 서브 순서의 종료 인덱스

반환값:

이 객체에의 참조

예외:

IndexOutOfBoundsException - start 또는 end가 부, 또는 start이 end 보다 긴, 또는 end가 s.length() 보다 긴 경우

append

public StringBuilder  append(char[] str)

char 배열 인수의 캐릭터 라인 표현을 이 순서에 추가합니다.

배열 인수의 문자는 이 순서의 내용에 차례로 추가됩니다. 이 순서의 길이는 인수의 길이의 분만큼 증가합니다.

최종적으로는 String.valueOf(char[]) 메서드에 의해 인수가 캐릭터 라인에 변환되고 나서, 그 캐릭터 라인의 문자가 이 문자 순서에 추가 되었을 경우와 완전히 같은 결과가 됩니다.

파라미터:

str - 추가되는 문자

반환값:

객체에의 참조

append

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

char 배열 인수의 부분 배열의 캐릭터 라인 표현을 이 순서에 추가합니다.

문자 배열 str 문자는 인덱스 offset 의 위치를 시점으로서 이 순서에 차례로 추가됩니다. 이 순서의 길이는 len값의 분만큼 증가합니다.

최종적으로는 String.valueOf(char[], int, int) 메서드에 의해 인수가 캐릭터 라인에 변환되고 나서, 그 캐릭터 라인의 문자가 이 문자 순서에 추가 되었을 경우와 완전히 같은 결과가 됩니다.

파라미터:

str - 추가되는 문자

offset - 최초의 char 인덱스

len - 추가하는 char 수

반환값:

객체에의 참조

append

public StringBuilder  append(boolean b)

boolean인수의 캐릭터 라인 표현을 이 순서에 추가합니다.

인수는 String.valueOf 메서드에 의해 변환되는 경우와 같이 캐릭터 라인에 변환되어 그 캐릭터 라인의 문자가 이 순서에 추가됩니다.

파라미터:

b - boolean

반환값:

이 객체에의 참조

관련 항목:

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

append

public StringBuilder  append(char c)

char인수의 캐릭터 라인 표현을 이 순서에 추가합니다.

인수는 이 순서에 추가됩니다. 이 캐릭터 라인 버퍼의 길이는 1 만 증가합니다.

최종적으로는 String.valueOf(char) 메서드에 의해 인수가 캐릭터 라인에 변환되고 나서, 그 캐릭터 라인의 문자가 이 문자 순서에추가 되었을 경우와 완전히 같은 결과가 됩니다.

정의:

인터페이스 Appendable 내의 append

파라미터:

c - char

반환값:

이 객체에의 참조

append

public StringBuilder  append(int i)

int인수의 캐릭터 라인 표현을 이 순서에 추가합니다.

인수는 String.valueOf 메서드에 의해 변환되는 경우와 같이 캐릭터 라인에 변환되어 그 캐릭터 라인의 문자가 이 순서에 추가됩니다.

파라미터:

i - int

반환값:

이 객체에의 참조

관련 항목:

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

append

public StringBuilder  append(long lng)

long인수의 캐릭터 라인 표현을 이 순서에 추가합니다.

인수는 String.valueOf 메서드에 의해 변환되는 경우와 같이 캐릭터 라인에 변환되어 그 캐릭터 라인의 문자가 이 순서에 추가됩니다.

파라미터:

lng - long

반환값:

이 객체에의 참조

관련 항목:

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

append

public StringBuilder  append(float f)

float인수의 캐릭터 라인 표현을 이 순서에 추가합니다.

인수는 String.valueOf 메서드에 의해 변환되는 경우와 같이 캐릭터 라인에 변환되어 그 캐릭터 라인의 문자가 이 문자 순서에 추가됩니다.

파라미터:

f - float

반환값:

이 객체에의 참조

관련 항목:

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

append

public StringBuilder  append(double d)

double인수의 캐릭터 라인 표현을 이 순서에 추가합니다.

인수는 String.valueOf 메서드에 의해 변환되는 경우와 같이 캐릭터 라인에 변환되어 그 캐릭터 라인의 문자가 이 순서에 추가됩니다.

파라미터:

d - double

반환값:

이 객체에의 참조

관련 항목:

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

appendCodePoint

public StringBuilder  appendCodePoint(int codePoint)

codePoint인수의 캐릭터 라인 표현을 이 순서에 추가합니다.

이 인수는 이 순서의 내용에 추가됩니다.이 순서의 길이는 Character.charCount(codePoint) 의 분 길어집니다.

최종적으로는 Character.toChars(int) 메서드에 의해 인수가 char 배열에 변환되고 나서, 그 배열의 문자가 이 문자 순서에추가 되었을 경우와 완전히 같은 결과가 됩니다.

파라미터:

codePoint - Unicode 코드 포인트

반환값:

이 객체에의 참조

도입된 버전 :

1.5

delete

public StringBuilder  delete(int start, 
                            int end)

이 순서의 부분 캐릭터 라인내의 문자를 모두 삭제합니다. 부분 캐릭터 라인은 지정된 start (으)로부터 시작되어, 인덱스 end - 1 위치에 있는 문자까지, 혹은 이것에 해당하는 문자가 없는 경우는 순서의 끝까지가 됩니다. start와 end가 동일한 경우, 아무것도 변경은 없습니다.

파라미터:

start - 개시 인덱스 (이 값을 포함한다)

end - 종료 인덱스 (이 값을 포함하지 않는다)

반환값:

이 객체

예외:

StringIndexOutOfBoundsException - start이 잘못된 값 의 경우, length() 보다 큰 경우, 혹은 end 보다 큰 경우

deleteCharAt

public StringBuilder  deleteCharAt(int index)

이 순서내의 지정된 위치에 있는 문자를 삭제합니다. 이 순서의 길이는 char 분 짧아집니다.

주의: 임의의 인덱스로 문자가 보조 문자의 경우, 이 메서드는 문자 전체를 삭제하지 않습니다. 보조 문자의 정확한 처리가 필요한 경우는 Character.charCount(thisSequence.codePointAt(index))를 호출해 삭제하는 char 수를 결정해thisSequence를 이 순서로서 주세요.

파라미터:

index - 삭제되는 char 인덱스

반환값:

이 객체

예외:

StringIndexOutOfBoundsException - index가 잘못된 값 의 경우, 혹은 length()에 동일한가 이것보다 큰 경우

replace

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

이 순서의 부분 캐릭터 라인의 문자를, 지정된 String 의 문자에 치환합니다. 부분 캐릭터 라인은 지정된 start로 부터 시작되어, 인덱스 end - 1 의 위치에 있는 문자까지, 혹은 이것에 해당하는 문자가 없는 경우는 순서의 끝까지가 됩니다. 우선, 부분 캐릭터 라인의 문자가 삭제되고 나서, 지정된 String가 start에 삽입됩니다. 순서는 지정된 String가 들어가도록, 필요에 따라서 길어집니다.

파라미터:

start - 개시 인덱스 (이 값을 포함한다)

end - 종료 인덱스 (이 값을 포함하지 않는다)

str - 이전의 내용을 치환하는 String

반환값:

이 객체

예외:

StringIndexOutOfBoundsException - start이 잘못된 값 의 경우, length() 보다 큰 경우, 혹은 end 보다 큰 경우

insert

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

str 배열 인수의 부분 배열의 캐릭터 라인 표현을 이 순서에 삽입합니다. 부분 배열은 지정된 offset 그리고 시작되어, len char (으)로 지정된 문자 몇분의 길이입니다. 부분 배열의 문자는 이 순서의 index 그리고 나타나는 위치에 삽입됩니다. 이 순서의 길이는 len char 분만 증가합니다.

파라미터:

index - 부분 배열을 삽입하는 위치

str - char 배열

offset - 삽입되는 부분 배열의 최초의 char 인덱스

len - 삽입되는 부분 배열의 char 수

반환값:

이 객체

예외:

StringIndexOutOfBoundsException - index가 잘못된 값 또는 length() 보다 큰 경우, offset 인가 len가 잘못된 값 의 경우, 혹은 (offset+len) 이 str.length 보다 큰 경우

insert

public StringBuilder  insert(int offset, 
                            Object  obj)

Object인수의 캐릭터 라인 표현을 이 문자 순서에 삽입합니다.

2번째의 인수가 String.valueOf 메서드의 경우와 같이 캐릭터 라인에 변환되어 그 캐릭터 라인의 문자가 이 순서의 지정된 오프셋(offset)에 삽입됩니다.

offset 인수는 0 이상으로 이 순서의 길이에 동일한가 이것보다 작지 않으면 안됩니다.

파라미터:

offset - 오프셋(offset)

obj - Obect

반환값:

이 객체에의 참조

예외:

StringIndexOutOfBoundsException - 오프셋(offset)가 무효인 경우

관련 항목:

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

insert

public StringBuilder  insert(int offset, 
                            String  str)

캐릭터 라인을 이 문자 순서에 삽입합니다.

String 인수의 문자가 이 순서의 지정된 오프셋(offset) 위치에 차례로 삽입됩니다. 그 위치에 있던 문자는 이동되어 인수의 길이의 분만큼 이 순서의 장 천성 증가합니다. str가 null인 경우는 "null" 의 4 문자가 이 순서에 삽입됩니다.

새로운 문자 순서의 인덱스 k 위치에 있는 문자는 다음의 문자에 동일해집니다.

• k가 offset 보다 작은 경우는 이전의 문자 순서의 인덱스 k 의 위치에 있는 문자
• k가 offset 보다 작지는 않지만, offset+str.length() 보다 작은 경우, 인수 str 인덱스 k-offset 의 위치에 있는 문자
• k가 offset+str.length()이상의 경우는 이전의 문자 순서의 k-str.length() 위치에 있는 문자

offset 인수는 0이상으로 이 순서의 길이에 동일한가 이것보다 작지 않으면 안됩니다.

파라미터:

offset - 오프셋(offset)

str - 캐릭터 라인

반환값:

이 객체에의 참조

예외:

StringIndexOutOfBoundsException - 오프셋(offset)가 무효인 경우

관련 항목:

length()

insert

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

char 배열 인수의 캐릭터 라인 표현을 이 순서에 삽입합니다.

배열 인수의 문자는 이 순서의 offset 그리고 나타나는 위치에 삽입됩니다. 이 순서의 길이는 인수의 길이의 분만큼 증가합니다.

최종적으로는 String.valueOf(char[]) 메서드에 의해 인수가 캐릭터 라인에 변환되고 나서, 그 캐릭터 라인의 문자가 이 문자 순서의 offset 그리고 나타나는 위치에 삽 입 되었을 경우와 완전히 같은 결과가 됩니다.

파라미터:

offset - 오프셋(offset)

str - 문자 배열

반환값:

이 객체에의 참조

예외:

StringIndexOutOfBoundsException - 오프셋(offset)가 무효인 경우

insert

public StringBuilder  insert(int dstOffset, 
                            CharSequence  s)

지정된 CharSequence를 이 순서에 삽입합니다.

CharSequence 인수의 문자는 오프셋(offset)으로 지정된 순서에 차례로 삽입되어 그 위치에 있던 문자를 이동시켜, 이 순서를 인수 s 길이만 길게 합니다.

이 메서드의 결과는 이 객체의 insert(dstOffset, s, 0, s.length()) 메서드를 호출했을 경우와 완전히 같습니다.

s가 null인 경우, "null" 4 문자가 이 순서에 삽입됩니다.

파라미터:

dstOffset - 오프셋(offset)

s - 삽입되는 순서

반환값:

이 객체에의 참조

예외:

IndexOutOfBoundsException - 오프셋(offset)가 무효의 경우

insert

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

지정된 CharSequence 서브 순서를 이 순서에 삽입합니다.

start 및 end로 지정된 인수 s 의 서브 순서는 차례로 이 순서의 지정된 목적 오프셋(offset)에 삽입됩니다. 이 정도치에 있던 문자를 이동시켜, 순서의 길이는 end - start 분 길어집니다.

이 순서의 인덱스 k 위치에 있는 문자는 다음의 문자에 동일해집니다.

• k가 dstOffset 보다 작은 경우는 이 순서의 인덱스 k 의 위치에 있는 문자
• k가 dstOffset 이상이지만 dstOffset+end-start 보다 작은 경우는 인수 s 인덱스 k+start-dstOffset 의 위치에 있는 문자
• k가 dstOffset+end-start이상의 경우는 이 순서의 인덱스 k-(end-start) 위치에 있는 문자

dstOffset 인수는 0이상으로 이 순서의 길이에 동일한가 이것보다 작지 않으면 안됩니다.

start 인수는 부가 아니고, end 보다 작지 않으면 안됩니다.

end 인수는 start 이상으로 s 길이에 동일한가 이것보다 작지 않으면 안됩니다.

s가 null인 경우, 이 메서드는 s 파라미터가 "null" 4 문자를 포함한 순서였다고의해 문자를 삽입합니다.

파라미터:

dstOffset - 이 순서의 오프셋(offset)

s - 삽입되는 순서

start - 삽입되는 서브 순서의 개시 인덱스

end - 삽입되는 서브 순서의 종료 인덱스

반환값:

이 객체에의 참조

예외:

IndexOutOfBoundsException - dstOffset 하지만 부, 또는 this.length() 보다 큰, 또는 start 또는 end 하지만 부, 또는 start이 end 보다 큰, 또는 end 하지만 s.length() 보다 큰 경우

insert

public StringBuilder  insert(int offset, 
                            boolean b)

boolean인수의 문자 표현을 이 순서에 삽입합니다.

2번째의 인수가 메서드 String.valueOf 그리고 변환되도록 변환되어 이 순서의 offset 로 지정되는 위치에 삽입됩니다.

offset 인수는 0 이상으로 이 순서의 길이에 동일한가 이것보다 작지 않으면 안됩니다.

파라미터:

offset - 오프셋(offset)

b - boolean

반환값:

이 객체에의 참조

예외:

StringIndexOutOfBoundsException - 오프셋(offset)가 무효인 경우

관련 항목:

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

insert

public StringBuilder  insert(int offset, 
                            char c)

char인수의 캐릭터 라인 표현을 이 순서에 삽입합니다.

2번째의 인수가 이 순서의 offset 그리고 지정되는 위치에 삽입됩니다. 이 순서의 길이가 1 문자분 증가합니다.

최종적으로는 String.valueOf(char) 메서드에 의해 인수가 캐릭터 라인에 변환되고 나서, 그 캐릭터 라인의 문자가 이 문자 순서의 offset 그리고 지정되는 위치에 삽 입 되었을 경우와 완전히 같은 결과가 됩니다.

offset 인수는 0 이상으로 이 순서의 길이에 동일한가 이것보다 작지 않으면 안됩니다.

파라미터:

offset - 오프셋(offset)

c - char

반환값:

이 객체에의 참조

예외:

IndexOutOfBoundsException - 오프셋(offset)가 무효인 경우

관련 항목:

length()

insert

public StringBuilder  insert(int offset, 
                            int i)

2번째의 int인수의 캐릭터 라인 표현을 이 순서에 삽입합니다.

2번째의 인수가 String.valueOf 메서드의 경우와 같이 캐릭터 라인에 변환되어 그 캐릭터 라인의 문자가 이 순서의 지정된 오프셋(offset)에 삽입됩니다.

offset 인수는 0 이상으로 이 순서의 길이에 동일한가 이것보다 작지 않으면 안됩니다.

파라미터:

offset - 오프셋(offset)

i - int

반환값:

이 객체에의 참조

예외:

StringIndexOutOfBoundsException - 오프셋(offset)가 무효인 경우

관련 항목:

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

insert

public StringBuilder  insert(int offset, 
                            long l)

long인수의 캐릭터 라인 표현을 이 순서에 삽입합니다.

2번째의 인수가 String.valueOf 메서드의 경우와 같이 캐릭터 라인에 변환되어 그 캐릭터 라인의 문자가 이 순서의 offset 그리고 지정된 위치에 삽입됩니다.

offset 인수는 0 이상으로 이 순서의 길이에 동일한가 이것보다 작지 않으면 안됩니다.

파라미터:

offset - 오프셋(offset)

l - long

반환값:

이 객체에의 참조

예외:

StringIndexOutOfBoundsException - 오프셋(offset)가 무효인 경우

관련 항목:

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

insert

public StringBuilder  insert(int offset, 
                            float f)

float인수의 캐릭터 라인 표현을 이 순서에 삽입합니다.

2번째의 인수가 String.valueOf 메서드의 경우와 같이 캐릭터 라인에 변환되어 그 캐릭터 라인의 문자가 이 순서의 지정된 오프셋(offset)에 삽입됩니다.

offset 인수는 0 이상으로 이 순서의 길이에 동일한가 이것보다 작지 않으면 안됩니다.

파라미터:

offset - 오프셋(offset)

f - float

반환값:

이 객체에의 참조

예외:

StringIndexOutOfBoundsException - 오프셋(offset)가 무효인 경우

관련 항목:

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

insert

public StringBuilder  insert(int offset, 
                            double d)

double인수의 캐릭터 라인 표현을 이 순서에 삽입합니다.

2번째의 인수가 String.valueOf 메서드의 경우와 같이 캐릭터 라인에 변환되어 그 캐릭터 라인의 문자가 이 순서의 지정된 오프셋(offset)에 삽입됩니다.

offset 인수는 0 이상으로 이 순서의 길이에 동일한가 이것보다 작지 않으면 안됩니다.

파라미터:

offset - 오프셋(offset)

d - double

반환값:

이 객체에의 참조

예외:

StringIndexOutOfBoundsException - 오프셋(offset)가 무효인 경우

관련 항목:

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

indexOf

public int indexOf(String  str)

이 캐릭터 라인내에서 지정된 부분 캐릭터 라인이 최초로 출현하는 위치의 인덱스를 리턴합니다. 리턴된 정수는

 this.toString(). startsWith(str, k)
 

위의 식이 true가 되는 것 같은 최소의 k 입니다.

파라미터:

str - 임의의 캐릭터 라인

반환값:

캐릭터 라인 인수가 이 객체내의 부분 캐릭터 라인인 경우는 해당하는 최초의 부분 캐릭터 라인의 최초의 문자의 인덱스. 부분 캐릭터 라인이 없다 경우는 -1

예외:

NullPointerException - str 하지만 null인 경우

indexOf

public int indexOf(String  str, 
                   int fromIndex)

지정된 인덱스 이후로 지정된 부분 캐릭터 라인이 이 캐릭터 라인내에서 최초로 출현하는 위치의 인덱스를 리턴합니다. 리턴된 정수는 다음의 최 소치 k가 됩니다.

     k >= Math.min(fromIndex, str.length()) &&
                   this.toString(). startsWith(str, k)
 

이러한 k 값이 존재하지 않는 경우,-1가 리턴됩니다 .

파라미터:

str - 검색 대상의 부분 캐릭터 라인

de>fromIndex

fromIndex - 검색 개시 위치의 인덱스

반환값:

지정된 인덱스로부터 검색을 개시해, 최초로 지정된 부분 캐릭터 라인이 출현하는 이 캐릭터 라인내의 인덱스

예외:

NullPointerException - str 하지만 null인 경우

lastIndexOf

public int lastIndexOf(String  str)

이 캐릭터 라인내에서 지정된 부분 캐릭터 라인이 제일 오른쪽으로 출현하는 위치의 인덱스를 리턴합니다. 비어있는 캐릭터 라인 "" 제일 오른쪽으로 출현한 위치가this.length() (이)라고 보여집니다. 리턴된 인덱스는

 this.toString(). startsWith(str, k)
 

위의 식이 true가 되는 것 같은 최대의 k 입니다.

파라미터:

str - 검색 대상의 부분 캐릭터 라인

반환값:

캐릭터 라인 인수가 이 객체내의 부분 캐릭터 라인으로서 1 회이상 출현하는 경우는 해당하는 마지막 부분 캐릭터 라인의 최초의 문자의 인덱스. 부분 캐릭터 라인으로서 출현하지 않는 경우는 -1

예외:

NullPointerException - str 하지만 null인 경우

lastIndexOf

public int lastIndexOf(String  str, 
                       int fromIndex)

이 캐릭터 라인내에서 지정된 부분 캐릭터 라인이 마지막에 출현하는 위치의 인덱스를 리턴합니다. 리턴된 정수는 이하에 적합하는 최대값 k 입니다.

     k <= Math.min(fromIndex, str.length()) &&
                   this.toString(). startsWith(str, k)
 

이러한 k 값이 존재하지 않는 경우,-1가 리턴됩니다 .

파라미터:

str - 검색 대상의 부분 캐릭터 라인

fromIndex - 검색 개시 위치의 인덱스

반환값:

이 캐릭터 라인내에서 지정된 부분 캐릭터 라인이 마지막에 출현하는 위치의 인덱스

예외:

NullPointerException - str 하지만 null인 경우

reverse

public StringBuilder  reverse()

이 문자 순서가 역의 줄 순서의 순서에 치환됩니다. 순서에 사로 게이트 페어가 포함되는 경우, 이러한 페어는 1 문자로서 다루어집니다. 즉, 상위-하위 사로 게이트의 차례는 거꾸로 되지 않습니다. reverse 메서드의 실행전에 문자 순서에 포함되고 있던 이전의 캐릭터 라인의 길이가 n 의 경우, 새로운 문자 순서내의 인덱스 k에 있는 문자는 이전의 문자 순서내의 인덱스 n-k-1 의 위치에 있던 문자에 동일해집니다.

reverse 조작을 실시하는 경우, 페어로 되어 있지 않은 하위 사로 게이트 및 상위 사로 게이트가 조작전에 작성될 가능성이 있습니다. 예를 들어,"\uDC00\uD800"를 반대로 하면, 유효한 사로 게이트 페어인 "\uD800\uDC00"를 작성합니다.

반환값:

이 객체에의 참조

toString

public String  toString()

이 순서의 데이터를 표현하는 캐릭터 라인을 리턴합니다. 새로운 String 객체를 할당해 현재 이 객체가 나타내는 문자 순서를 포함하도록 초기화합니다. 마지막으로 작성된 String를 리턴합니다. 이 조작의 후에 이 순서를 변경해도, String 내용에는 영향을 주지 않습니다.

정의:

인터페이스 CharSequence 내의 toString

반환값:

이 문자 순서의 캐릭터 라인 표현

length

public int length()

길이 (문자수)를 리턴합니다.

정의:

인터페이스 CharSequence 내의 length

반환값:

이 객체에 의해 현재 표시되고 있는 문자 순서의 길이

capacity

public int capacity()

현재의 용량을 리턴합니다. 이 용량은 새롭게 삽입되는 문자로 이용 가능한 기억역의 양을 나타냅니다. 그것을 넘으면 할당이 발생합니다.

반환값:

현재의 용량

ensureCapacity

public void ensureCapacity(int minimumCapacity)

용량이 지정된 최소값 이상이 되는 것을 보증합니다. 이 현재의 용량이 인수보다 작은 경우는 보다 용량의 큰 새로운 내부 배열이 할당. 새로운 용량은 다음의 2개 중 큰 빌트인니다.

• minimumCapacity인수
• 이전의 용량의 2 배의 양에 2를 더한 값

minimumCapacity인수가 정의 값이 아닌 경우, 이 메서드는 아무것도 실시하지 않고 복귀합니다.

파라미터:

minimumCapacity - 보증하고 싶은 최소 용량

trimToSize

public void trimToSize()

문자 순서에 사용되는 기억 영역을 줄이려고 합니다. 버퍼가 현재의 문자의 순서에 필요한 길이보다 긴 경우는 용량이 효율적이 되도록 사이즈를 변경합니다. 이 메서드를 호출하면, capacity() 메서드에의 후속의 호출로 리턴된 값에 영향을 줄 가능성이 있습니다.

setLength

public void setLength(int newLength)

이 문자 순서의 길이를 설정합니다. 이 순서는 길이가 인수에 의해 지정된 새로운 문자 순서를 나타내도록 변경됩니다. newLength 보다 작은 부가 아닌 모든 k 에서는 새로운 문자 순서내의 인덱스 k 위치에 있는 문자는 k 하지만 이전의 문자 순서의 길이보다 작은 경우는 이전의 문자 순서내의 인덱스 k 의 위치에 있는 문자에 동일해집니다. 그렇지 않은 경우는 null 문자 ''가 됩니다. 즉, newLength인수가 현재의 길이보다 작은 경우는 newLength 인수에 의해 지정된 길이로 변경됩니다.

newLength인수가 현재의 길이와 동일한가 큰 경우는 길이가 newLength 인수가 되도록, 캐릭터 라인 버퍼에 필요한 만큼의 null 문자 ('\u0000')가 추가됩니다.

newLength인수는 0 이상이 아니면 안됩니다.

파라미터:

newLength - 새로운 길이

예외:

IndexOutOfBoundsException - newLength 인수가 잘못된 값 의 경우

charAt

public char charAt(int index)

지정된 인덱스 위치에 있는 char값을 리턴합니다. 배열의 인덱스부의 경우와 같이, 순서의 최초의 char 값의 인덱스는 0, 다음의 문자의 인덱스는 1 으로 계속됩니다.

인덱스 인수는 0 이상 또한 순서의 길이보다 작지 않으면 안됩니다.

인덱스로 지정된 char값이 사 로게이트의 경우, 사로 게이트값이 리턴됩니다 .

정의:

인터페이스 CharSequence 내의 charAt

파라미터:

index - char값의 인덱스

반환값:

지정된 인덱스 위치에 있는 char값.

예외:

IndexOutOfBoundsException - index 하지만 잘못된 값, 또는 캐릭터 라인의 길이 이상인 경우

codePointAt

지정된 인덱스 위치의 문자 (Unicode 코드 포인트)를 리턴합니다. 인덱스는 char값 (Unicode 코드 단위)를 참조해, 범위는 0 ~ length() - 1 입니다.

지정된 인덱스로 지정된 char 값이 상위 사로 게이트 범위에 있는 경우, 거기에 계속되는 인덱스는 이String 의 길이 미만입니다. 또, 이후의 인덱스의 char 값이 하위 사로 게이트 범위에 있는 경우, 이 사로 게이트 페어에 대응하는 보조 코드 포인트가 리턴됩니다 . 그렇지 않은 경우, 지정된 인덱스에 있는 char 값이 리턴됩니다 .

파라미터:

index - char값의 인덱스

반환값:

지정된 index에 있는 문자의 코드 포인트치

예외:

IndexOutOfBoundsException - index 인수가 잘못된 값 의 경우, 혹은 이 순서와 동일한가 큰 경우

codePointBefore

public int codePointBefore(int index)

지정된 인덱스의 전의 문자 (Unicode 코드 포인트)를 리턴합니다. 인덱스는 char 값 (Unicode 코드 단위)을 참조해, 범위는 1 ~ length 입니다.

(index - 1) 위치의 char 값이 하위 사로 게이트의 범위에 있는 경우, (index - 2)가 부가 아닌 경우, (index - 2) 위치의 char값이 상위 사로 게이트의 범위에 있는 경우, 사로 게이트 페어의 보조 코드 포인트값이 리턴됩니다 . index - 1 위치의 char 값이 페어로 되어 있지 않은 하위 또는 상위 사로 게이트의 경우, 사로 게이트값이 리턴됩니다 .

파라미터:

index - 리턴된 코드 포인트에 계속되는 인덱스

반환값:

지정된 인덱스의 전에 있는 Unicode 코드 포인트치

예외:

IndexOutOfBoundsException - index 인수가 1 보다 작은 경우, 혹은 이 순서보다 큰 경우

codePointCount

public int codePointCount(int beginIndex, 
                          int endIndex)

이 순서의 지정된 텍스트 범위의 Unicode 코드 포인트의 수를 리턴합니다. 텍스트 범위는 지정된 beginIndex로 부터 인덱스 endIndex - 1 위치의 char 까지입니다. 따라서, 텍스트 범위의 길이 (char 사이)는 endIndex-beginIndex 입니다. 텍스트 범위내에서 페어로 되어 있지 않은 사로 게이트는 각각 1 개의 코드 포인트로서 셀 수 있습니다.

파라미터:

beginIndex - 텍스트 범위내의 최초의 char에 의 인덱스

endIndex - 텍스트 범위내의 마지막 char 의 뒤의 인덱스

반환값:

지정된 텍스트 범위내의 Unicode 코드 포인트의 수

예외:

IndexOutOfBoundsException - beginIndex가 부의 경우, 또는 endIndex가 순서보다 큰 경우, 또는 beginIndex가 endIndex 보다 큰 경우

offsetByCodePoints

public int offsetByCodePoints(int index, 
                              int codePointOffset)

codePointOffset 코드 포인트에 의해 지정된 index (으)로부터의 오프셋(offset)인, 이 순서내의 인덱스를 리턴합니다. index와 codePointOffset에 의해 지정된 텍스트 범위내에서 페어로 되어 있지 않은 사로 게이트는 각각 1개의 코드 포인트로서 셀 수 있습니다.

파라미터:

index - 오프셋(offset)에의 인덱스

codePointOffset - 코드 포인트내의 오프셋(offset)

반환값:

이 순서내의 인덱스

예외:

IndexOutOfBoundsException - 인덱스가 부, 또는 이 순서의 길이보다 긴, 또는 codePointOffset이 정 또한 index 그리고 시작되는 서브 순서의 코드 포인트가 codePointOffset 코드 포인트보다 적은 또는 codePointOffset 하지만 부 또한 index 전의 서브 순서가 codePointOffset 코드 포인트의 절대치보다 적은 경우

getChars

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

이 순서로부터, 카피처의 문자 배열 dst에 문자를 카피합니다. 카피되는 최초의 문자의 인덱스는 srcBegin, 카피되는 마지막 문자의 인덱스는 srcEnd-1 입니다. 따라서, 카피되는 문자수는 srcEnd-srcBegin가 됩니다. 문자는 dst 의 부분 배열에 복사됩니다. 시점의 인덱스는 dstBegin로 종점의 인덱스는 다음과 같이 됩니다.

 dstbegin + (srcEnd-srcBegin) - 1
 

파라미터:

srcBegin - 오프셋(offset)의 복제의 개시

srcEnd - 오프셋(offset)의 복제의 마지막

dst - 데이터를 카피하는 배열

dstBegin - dst에 의 오프셋(offset)

예외:

NullPointerException - dst 하지만 null인 경우

IndexOutOfBoundsException - 다음의 어떤 것인가에 들어맞는 경우

• srcBegin가 부
• dstBegin가 부
• srcBegin인수가 srcEnd인수보다 크다
• srcEnd가 this.length()보다 크다
• dstBegin+srcEnd-srcBegin가 dst.length 보다 크다

setCharAt

public void setCharAt(int index, 
                      char ch)

지정된 인덱스 위치의 문자가 ch가 되도록 설정합니다. 이 순서는 index 의 위치의 문자가 ch인 것을 제외해, 이전의 문자 순서와 동일한 문자 순서를 표현하도록 변경됩니다.

index 인수는 0 이상으로 이 순서의 길이 미만이 아니면 안됩니다.

파라미터:

index - 변경 대상의 문자의 인덱스

ch - 새로운 문자

예외:

IndexOutOfBoundsException - index 하지만 잘못된 값 의 경우, 혹은 length()에 동일한가 이것보다 큰 경우

substring

public String  substring(int start)

문자 순서에 현재 포함되고 있는 캐릭터 라인의 일부가 들어간 새로운 String를 리턴합니다. 부분 캐릭터 라인은 지정된 인덱스로부터 시작되어, 이 순서의 끝까지가 됩니다.

파라미터:

start - 개시 인덱스 (이 값을 포함한다)

반환값:

새로운 캐릭터 라인

예외:

StringIndexOutOfBoundsException - start이 0 보다 작은 경우, 혹은 이 객체의 길이보다 큰 경우

subSequence

public CharSequence  subSequence(int start, 
                                int end)

이 순서의 서브 순서인 새로운 문자 순서를 리턴합니다.

다음의 폼의 메서드 호출은,

 sb.subSequence(begin,  end)

다음의 호출과 정확하게 같은 동작이 됩니다.

 sb.substring(begin,  end)

이 메서드에의해 이 클래스가 CharSequence 인터페이스를 구현 가능하게 됩니다.

정의:

인터페이스 CharSequence 내의 subSequence

파라미터:

start - 개시 인덱스 (이 값을 포함한다)

end - 종료 인덱스 (이 값을 포함하지 않는다)

반환값:

지정된 서브 순서

예외:

IndexOutOfBoundsException - start 또는 end가 잘못된 값 의 경우, end가 length() 보다 큰 경우, 혹은 start가 end 보다 큰 경우

substring

public String  substring(int start, 
                        int end)

이 순서에 현재 포함되고 있는 캐릭터 라인의 일부가 들어간 새로운 String를 리턴합니다. 부분 캐릭터 라인은 지정된 start로 부터 시작되어, 인덱스 end - 1에 있는 문자까지 됩니다.

파라미터:

start - 개시 인덱스 (이 값을 포함한다)

end - 종료 인덱스 (이 값을 포함하지 않는다)

반환값:

새로운 캐릭터 라인

예외:

StringIndexOutOfBoundsException - start 또는 end가 잘못된 값 의 경우, length() 보다 큰 경우, 혹은 start이 end 보다 큰 경우