Por favor, lembre-se que esta tradução da especificação é resultado de um projeto da comunidade java.net( https://jdk5-api-pt-br.dev.java.net/). A versão oficial da especificação é a versão na língua inglesa que pode ser encontrada em http://java.sun.com/j2se/1.5.0/docs/api/. Em caso de divergências, a versão predominante da especificação é a original em inglês.

Please note that this translation of the specification is the result of a java.net community project ( https://jdk5-api-pt-br.dev.java.net/ ). The official version of the specification is the US English language version which can be found at http://java.sun.com/j2se/1.5.0/docs/api/. In case of disputes, the authoritative version of the specification is the original, English document.

java.lang
Interface Appendable

All Known Implementing Classes:

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

public interface Appendable

Um objeto para o qual seqüências de char (caracteres) podem ser anexadas. A interface Appendable deve ser implementada por qualquer classe cuja as instâncias receberão uma saída formatada de um Formatter.

Os caracteres a serem anexados deveriam ser caracteres Unicode válidos como descrito na Representação de Caracteres Unicode. Note que suplementarmente caracteres podem ser compostos de valores char múltiplos de 16-bit .

Appendables não são necessáriamente seguros para acesso multithreaded. Segurança de thread é responsabilidade de classes que extendem e implementam esta interface.

Desde que esta interface pode ser implementada por classes existentes com diferentes estilos de manipulação de erros não há garantia que erros serão propagados para o invocador.

Since:

1.5

Method Summary

Appendable	append(char c) Anexa o caracter especificado neste Appendable.
Appendable	append(CharSequence csq) Anexa a seqüência de caracteres especificada, neste Appendable.
Appendable	append(CharSequence csq, int start, int end) Anexa uma subseqüência da seqüência de caracteres especificada, neste Appendable.

Method Detail

append

Appendable append(CharSequence csq)
                  throws IOException

Anexa a seqüência de caracteres especificada, neste Appendable.

Dependendo de qual classe implementa a seqüência de caracteres csq, a seqüência inteira pode não ser anexada. Por instância, se csq é um CharBuffer então as subseqüência a anexar é definida pela posição e limite do buffer.

Parameters:

csq - A seqüência de caracteres a ser anexada. Se csq for null, então os quatro caracteres "null" são anexados neste Appendable.

Returns:

Uma referência deste Appendable

Throws:

IOException - If an I/O error occurs

append

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

Anexa uma subseqüência da seqüência de caracteres especificada, neste Appendable.

Uma invocação deste método na forma out.append(csq, start, end) quando csq não é null, se comporta exatamente da mesma maneira como a invocação

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

Parameters:

csq - A seqüência de caracteres da qual uma subseqüência será anexada. Se csq for null, então os caracteres serão anexados como se csq contivesse os quatro caracteres "null".

start - O índice do primeiro caracter na subseqüência

end - O índice do caracter seguinte ao último caracter na subseqüência

Returns:

Uma referência deste Appendable

Throws:

IndexOutOfBoundsException - Se start ou end forem negativos, start for maior do que end, ou end é maior do que csq.length()

IOException - Se um erro de E/S ocorrer

append

Appendable append(char c)
                  throws IOException

Anexa o caracter especificado neste Appendable.

Parameters:

c - O caracter a ser anexado

Returns:

Uma referência deste Appendable

Throws:

IOException - Se um erro de E/S ocorrer