com.fr.design.gui.syntax.io

类 UnicodeReader

java.lang.Object

java.io.Reader

com.fr.design.gui.syntax.io.UnicodeReader

所有已实现的接口:

java.io.Closeable, java.lang.AutoCloseable, java.lang.Readable

public class UnicodeReader
extends java.io.Reader

A reader capable of identifying Unicode streams by their BOMs. This class will recognize the following encodings:

• UTF-8
• UTF-16LE
• UTF-16BE
• UTF-32LE
• UTF-32BE

If the stream is not found to be any of the above, then a default encoding is used for reading. The user can specify this default encoding, or a system default will be used.

For optimum performance, it is recommended that you wrap all instances of UnicodeReader with a java.io.BufferedReader.

This class is mostly ripped off from the workaround in the description of Java Bug 4508058.

版本:

0.9

作者:

Robert Futrell

字段概要

从类继承的字段 java.io.Reader

lock

构造器概要

构造器

构造器和说明
UnicodeReader(java.io.File file) This utility constructor is here because you will usually use a UnicodeReader on files.
UnicodeReader(java.io.File file, java.lang.String defaultEncoding) This utility constructor is here because you will usually use a UnicodeReader on files.
UnicodeReader(java.io.InputStream in) Creates a reader using the encoding specified by the BOM in the file; if there is no recognized BOM, then a system default encoding is used.
UnicodeReader(java.io.InputStream in, java.lang.String defaultEncoding) Creates a reader using the encoding specified by the BOM in the file; if there is no recognized BOM, then defaultEncoding is used.
UnicodeReader(java.lang.String file) This utility constructor is here because you will usually use a UnicodeReader on files.

方法概要

方法

限定符和类型	方法和说明
void	close() Closes this reader.
java.lang.String	getEncoding() Returns the encoding being used to read this input stream (i.e., the encoding of the file).
protected void	init(java.io.InputStream in, java.lang.String defaultEncoding) Read-ahead four bytes and check for BOM marks.
int	read(char[] cbuf, int off, int len) Read characters into a portion of an array.

从类继承的方法 java.io.Reader

mark, markSupported, read, read, read, ready, reset, skip

从类继承的方法 java.lang.Object

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

构造器详细资料

UnicodeReader

public UnicodeReader(java.lang.String file)
              throws java.io.IOException,
                     java.io.FileNotFoundException,
                     java.lang.SecurityException

This utility constructor is here because you will usually use a UnicodeReader on files.

Creates a reader using the encoding specified by the BOM in the file; if there is no recognized BOM, then a system default encoding is used.

参数:

file - The file from which you want to read.

抛出:

java.io.IOException - If an error occurs when checking for/reading the BOM.

java.io.FileNotFoundException - If the file does not exist, is a directory, or cannot be opened for reading.

java.lang.SecurityException - If a security manager exists and its checkRead method denies read access to the file.

UnicodeReader

public UnicodeReader(java.io.File file)
              throws java.io.IOException,
                     java.io.FileNotFoundException,
                     java.lang.SecurityException

This utility constructor is here because you will usually use a UnicodeReader on files.

Creates a reader using the encoding specified by the BOM in the file; if there is no recognized BOM, then a system default encoding is used.

参数:

file - The file from which you want to read.

抛出:

java.io.IOException - If an error occurs when checking for/reading the BOM.

java.io.FileNotFoundException - If the file does not exist, is a directory, or cannot be opened for reading.

java.lang.SecurityException - If a security manager exists and its checkRead method denies read access to the file.

UnicodeReader

public UnicodeReader(java.io.File file,
             java.lang.String defaultEncoding)
              throws java.io.IOException,
                     java.io.FileNotFoundException,
                     java.lang.SecurityException

This utility constructor is here because you will usually use a UnicodeReader on files.

Creates a reader using the encoding specified by the BOM in the file; if there is no recognized BOM, then a specified default encoding is used.

参数:

file - The file from which you want to read.

defaultEncoding - The encoding to use if no BOM is found. If this value is null, a system default is used.

抛出:

java.io.IOException - If an error occurs when checking for/reading the BOM.

java.io.FileNotFoundException - If the file does not exist, is a directory, or cannot be opened for reading.

java.lang.SecurityException - If a security manager exists and its checkRead method denies read access to the file.

UnicodeReader

public UnicodeReader(java.io.InputStream in)
              throws java.io.IOException

Creates a reader using the encoding specified by the BOM in the file; if there is no recognized BOM, then a system default encoding is used.

参数:

in - The input stream from which to read.

抛出:

java.io.IOException - If an error occurs when checking for/reading the BOM.

UnicodeReader

public UnicodeReader(java.io.InputStream in,
             java.lang.String defaultEncoding)
              throws java.io.IOException

Creates a reader using the encoding specified by the BOM in the file; if there is no recognized BOM, then defaultEncoding is used.

参数:

in - The input stream from which to read.

defaultEncoding - The encoding to use if no recognized BOM is found. If this value is null, a system default is used.

抛出:

java.io.IOException - If an error occurs when checking for/reading the BOM.

方法详细资料

close

public void close()
           throws java.io.IOException

Closes this reader.

指定者:

close 在接口中 java.io.Closeable

指定者:

close 在接口中 java.lang.AutoCloseable

指定者:

close 在类中 java.io.Reader

抛出:

java.io.IOException

getEncoding

public java.lang.String getEncoding()

Returns the encoding being used to read this input stream (i.e., the encoding of the file). If a BOM was recognized, then the specific Unicode type is returned; otherwise, either the default encoding passed into the constructor or the system default is returned.

返回:

The encoding of the stream.

init

protected void init(java.io.InputStream in,
        java.lang.String defaultEncoding)
             throws java.io.IOException

Read-ahead four bytes and check for BOM marks. Extra bytes are unread back to the stream, only BOM bytes are skipped.

参数:

defaultEncoding - The encoding to use if no BOM was recognized. If this value is null, then a system default is used.

抛出:

java.io.IOException - If an error occurs when trying to read a BOM.

read

public int read(char[] cbuf,
       int off,
       int len)
         throws java.io.IOException

Read characters into a portion of an array. This method will block until some input is available, an I/O error occurs, or the end of the stream is reached.

指定者:

read 在类中 java.io.Reader

参数:

cbuf - The buffer into which to read.

off - The offset at which to start storing characters.

len - The maximum number of characters to read.

返回:

The number of characters read, or -1 if the end of the stream has been reached.

抛出:

java.io.IOException