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가 잘못된 값 의 경우, start가 end 보다 큰 경우, 또는 end가 csq.length() 보다 큰 경우

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

append

Appendable  append(char c)
                  throws IOException 

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

파라미터:

c - 추가되는 문자

반환값:

이 Appendable에 의 참조

예외:

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