java.lang
인터페이스 Appendable

기존의 구현 클래스의 일람:

BufferedWriter , CharArrayWriter , CharBuffer , FileWriter , FilterWriter , LogStream , OutputStreamWriter , PipedWriter , PrintStream , PrintWriter , StringBuffer , StringBuilder , StringWriter , Writer

public interface Appendable

char 순서와 값을 추가할 수 있는 객체입니다. Appendable 인터페이스는,Formatter 로부터 포맷 된 출력을 받는 인스턴스를 가지는 클래스에 의해 구현되지 않으면 안됩니다.

추가되는 문자는,Unicode 문자 표현으로 정의되고 있는 유효한 Unicode 문자일 필요가 있습니다. 보조 문자는, 복수의 16 비트 char 치로 작성할 수가 있습니다.

Appendable 는, multi-thread 액세스에 대해서 반드시 안전하지는 않습니다. thread의 안전성은, 이 인터페이스를 확장 및 구현하는 클래스가 담당합니다.

이 인터페이스는, 다른 에러 처리 양식을 가지는 기존의 클래스에 의해 구현될 가능성이 있으므로, 호출 바탕으로 에러가 전달되는 보증은 없습니다.

도입된 버젼:

1.5

메소드의 개요

Appendable	append (char c) 이 Appendable 로 지정된 문자를 추가합니다.
Appendable	append (CharSequence csq) 이 Appendable 로 지정된 문자 순서를 추가합니다.
Appendable	append (CharSequence csq, int start, int end) 이 Appendable 로 지정된 문자 순서의 서브 순서를 추가합니다.

메소드의 상세

append

Appendable  append(CharSequence  csq)
                  throws IOException 

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

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

파라미터:

csq - 추가되는 문자 순서. csq 가 null 의 경우는, 이 Appendable 에 「null」라고 하는 4 문자가 추가된다

반환값:

이 Appendable 에의 참조

예외:

IOException - 입출력 에러가 발생했을 경우

append

Appendable  append(CharSequence  csq,
                  int start,
                  int end)
                  throws IOException 

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

이 메소드를 out.append(csq, start, end) (csq 는 null 가 아니다)의 형식에서 호출했을 경우, 다음의 호출과 같은 결과를 얻을 수 있습니다.

out.append(csq.subSequence(start, end)) 

파라미터:

csq - 문자 서브 순서의 추가원이 되는 문자 순서. csq 가 null 의 경우,csq 에 「null」의 4 문자가 포함되는것 같이 문자가 추가되는

start - 문자 서브 순서의 최초의 문자의 인덱스

end - 문자 서브 순서의 마지막 문자에 계속되는 문자의 인덱스

반환값:

이 Appendable 에의 참조

예외:

IndexOutOfBoundsException - start 또는 end 가 0 보다 작은 값의 경우,start 가 end 보다 큰 경우, 또는 end 가 csq.length() 보다 큰 경우

IOException - 입출력 에러가 발생했을 경우

append

Appendable  append(char c)
                  throws IOException 

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

파라미터:

c - 추가되는 문자

반환값:

이 Appendable 에의 참조

예외:

IOException - 입출력 에러가 발생했을 경우