-
- All Superinterfaces:
-
AutoCloseable
,Closeable
,DataInput
,DataOutput
,ImageInputStream
- 所有已知实现类:
-
FileCacheImageOutputStream
,FileImageOutputStream
,ImageOutputStreamImpl
,MemoryCacheImageOutputStream
public interface ImageOutputStream extends ImageInputStream, DataOutput
一个可寻求的输出流接口,供ImageWriter
使用。 诸如OutputStream
和File
的各种输出目的地以及未来的快速I / O目的地可能被该接口的适当实现“包裹”,以供Image I / O API使用。与标准
OutputStream
不同,ImageOutputStream扩展了其对应的ImageInputStream
。 因此,可以从流中读取它被写入。 尽管用于处理字节对齐写入之前的非零位偏移的语义必须与用于在字节对齐之前处理非零位偏移的语义不同,对齐阅读 当读取字节时,任何位偏移量在读取之前设置为0; 当写入字节时,非零位偏移使得该字节中的剩余位被写为0。 字节对齐的写入开始于下一个字节位置。- 另请参见:
-
ImageInputStream
-
-
方法摘要
所有方法 接口方法 抽象方法 Modifier and Type 方法 描述 void
flushBefore(long pos)
将给定位置之前的所有数据刷新到基础目的地,例如OutputStream
或File
。void
write(byte[] b)
在当前位置写入一串字节。void
write(byte[] b, int off, int len)
在当前位置写入一串字节。void
write(int b)
将当前位置的单个字节写入流。void
writeBit(int bit)
将由参数的最低有效位给出的单个位写入当前字节位置中当前位偏移量的流。void
writeBits(long bits, int numBits)
将bits
参数的numBits
最低有效位(bits
的顺序)给出的位序列写入当前字节位置当前位偏移量的流。void
writeBoolean(boolean v)
向流中写入一个boolean
值。void
writeByte(int v)
将v
的8位低位写入流。void
writeBytes(String s)
将一个字符串写入输出流。void
writeChar(int v)
该方法是writeShort
的同义词。void
writeChars(char[] c, int off, int len)
在当前位置将一串字符写入流。void
writeChars(String s)
将一个字符串写入输出流。void
writeDouble(double v)
向输出流写入一个由四个字节组成的double
值。void
writeDoubles(double[] d, int off, int len)
将当前位置的一系列双精度写入流。void
writeFloat(float v)
向输出流写入一个由四个字节组成的float
值。void
writeFloats(float[] f, int off, int len)
在当前位置将一系列浮点写入流。void
writeInt(int v)
将v
的32位写入流。void
writeInts(int[] i, int off, int len)
在当前位置写入流的序列。void
writeLong(long v)
将v
的64位写入流。void
writeLongs(long[] l, int off, int len)
在当前位置写入流的序列。void
writeShort(int v)
将v
的16位低位写入流。void
writeShorts(short[] s, int off, int len)
在当前位置写入流的序列。void
writeUTF(String s)
以网络字节顺序将两个字节的长度信息写入输出流,后跟字符串s
中每个字符的 modified UTF-8表示。-
Methods inherited from interface javax.imageio.stream.ImageInputStream
close, flush, getBitOffset, getByteOrder, getFlushedPosition, getStreamPosition, isCached, isCachedFile, isCachedMemory, length, mark, read, read, read, readBit, readBits, readBoolean, readByte, readBytes, readChar, readDouble, readFloat, readFully, readFully, readFully, readFully, readFully, readFully, readFully, readFully, readInt, readLine, readLong, readShort, readUnsignedByte, readUnsignedInt, readUnsignedShort, readUTF, reset, seek, setBitOffset, setByteOrder, skipBytes, skipBytes
-
-
-
-
方法详细信息
-
write
void write(int b) throws IOException
将当前位置的单个字节写入流。 忽略了b
的24个高位。如果流内的位偏移量不为零,则当前字节的剩余部分用0填充并首先写出。 写入后位偏移将为0。 实施者可以使用
flushBits
的方法ImageOutputStreamImpl
来保证这一点。- Specified by:
-
write
在接口DataOutput
- 参数
-
b
- 要写入低8位的int
。 - 异常
-
IOException
- 如果发生I / O错误。
-
write
void write(byte[] b) throws IOException
在当前位置写入一串字节。 如果b.length
为0,则不会写入。 字节b[0]
首先写入,然后字节b[1]
等等。如果流内的位偏移量不为零,则当前字节的剩余部分用0填充并首先写出。 写入后位偏移将为0。
- Specified by:
-
write
在接口DataOutput
- 参数
-
b
- 要写入的byte
的数组。 - 异常
-
NullPointerException
- 如果b
是null
。 -
IOException
- 如果发生I / O错误。
-
write
void write(byte[] b, int off, int len) throws IOException
在当前位置写入一串字节。 如果len
为0,则不会写入。 首先写入字节b[off]
,然后字节b[off + 1]
等等。如果流内的位偏移量不为零,则当前字节的剩余部分用0填充并首先写出。 写入后位偏移将为0。 实施者可以使用
flushBits
的方法ImageOutputStreamImpl
来保证这一点。- Specified by:
-
write
在接口DataOutput
- 参数
-
b
- 要写入的byte
的数组。 -
off
- 数据中的起始偏移量。 -
len
-byte
的len
的数量。 - 异常
-
IndexOutOfBoundsException
- 如果off
为负,len
,否则为off + len
,大于b.length
。 -
NullPointerException
- 如果b
是null
。 -
IOException
- 如果发生I / O错误。
-
writeBoolean
void writeBoolean(boolean v) throws IOException
向流中写入一个boolean
值。 如果v
为真,则写入值(byte)1
; 如果v
为false,则写入值(byte)0
。如果流内的位偏移量不为零,则当前字节的剩余部分用0填充并首先写出。 写入后位偏移将为0。
- Specified by:
-
writeBoolean
在接口DataOutput
- 参数
-
v
-boolean
。 - 异常
-
IOException
- 如果发生I / O错误。
-
writeByte
void writeByte(int v) throws IOException
将v
的8位低位写入流。 忽略了v
的24个高位。 (这意味着writeByte
与整数参数的作用完全一样)write
)如果流内的位偏移量不为零,则当前字节的剩余部分用0填充并首先写出。 写入后位偏移将为0。
- Specified by:
-
writeByte
在接口DataOutput
- 参数
-
v
- 包含要写入的字节值的int
。 - 异常
-
IOException
- 如果发生I / O错误。
-
writeShort
void writeShort(int v) throws IOException
将v
的16位低位写入流。v
的16位v
被忽略。 如果流使用网络字节顺序,则按顺序写入的字节为:(byte)((v >> 8) & 0xff) (byte)(v & 0xff)
否则写入的字节将为:(byte)(v & 0xff) (byte)((v >> 8) & 0xff)
如果流内的位偏移量不为零,则当前字节的剩余部分用0填充并首先写出。 写入后位偏移将为0。
- Specified by:
-
writeShort
在接口DataOutput
- 参数
-
v
- 包含要写入的短值的int
。 - 异常
-
IOException
- 如果发生I / O错误。
-
writeChar
void writeChar(int v) throws IOException
这个方法是writeShort
的同义词。- Specified by:
-
writeChar
在接口DataOutput
- 参数
-
v
- 一个包含要写入的char(unsigned short)值的int
。 - 异常
-
IOException
- 如果发生I / O错误。 - 另请参见:
-
writeShort(int)
-
writeInt
void writeInt(int v) throws IOException
将v
的32位写入流。 如果流使用网络字节顺序,则按顺序写入的字节为:(byte)((v >> 24) & 0xff) (byte)((v >> 16) & 0xff) (byte)((v >> 8) & 0xff) (byte)(v & 0xff)
Otheriwse,写入的字节将是:(byte)(v & 0xff) (byte)((v >> 8) & 0xff) (byte)((v >> 16) & 0xff) (byte)((v >> 24) & 0xff)
如果流内的位偏移量不为零,则当前字节的剩余部分用0填充并首先写出。 写入后位偏移将为0。
- Specified by:
-
writeInt
在接口DataOutput
- 参数
-
v
- 一个包含要写入的值的int
。 - 异常
-
IOException
- 如果发生I / O错误。
-
writeLong
void writeLong(long v) throws IOException
将v
的64位写入流。 如果流使用网络字节顺序,则按顺序写入的字节为:(byte)((v >> 56) & 0xff) (byte)((v >> 48) & 0xff) (byte)((v >> 40) & 0xff) (byte)((v >> 32) & 0xff) (byte)((v >> 24) & 0xff) (byte)((v >> 16) & 0xff) (byte)((v >> 8) & 0xff) (byte)(v & 0xff)
否则写入的字节将为:(byte)(v & 0xff) (byte)((v >> 8) & 0xff) (byte)((v >> 16) & 0xff) (byte)((v >> 24) & 0xff) (byte)((v >> 32) & 0xff) (byte)((v >> 40) & 0xff) (byte)((v >> 48) & 0xff) (byte)((v >> 56) & 0xff)
如果流内的位偏移量不为零,则当前字节的剩余部分用0填充并首先写出。 写入后位偏移将为0。
- Specified by:
-
writeLong
在接口DataOutput
- 参数
-
v
- along
包含要写入的值。 - 异常
-
IOException
- 如果发生I / O错误。
-
writeFloat
void writeFloat(float v) throws IOException
向输出流写入一个由四个字节组成的float
值。 它这样做是因为,如果它首先将这个float
值到int
在完全相同的方式Float.floatToIntBits
方法,然后在的完全相同的方式写入的int值writeInt
方法。如果流内的位偏移量不为零,则当前字节的剩余部分用0填充并首先写出。 写入后位偏移将为0。
- Specified by:
-
writeFloat
在接口DataOutput
- 参数
-
v
- afloat
包含要写入的值。 - 异常
-
IOException
- 如果发生I / O错误。
-
writeDouble
void writeDouble(double v) throws IOException
double
四个字节组成的double
值写入输出流。 它这样做是因为,如果它首先将这个double
值到long
在完全相同的方式Double.doubleToLongBits
方法,然后在完全相同的方式写入长值writeLong
方法。如果流内的位偏移量不为零,则当前字节的剩余部分用0填充并首先写出。 写入后位偏移将为0。
- Specified by:
-
writeDouble
在接口DataOutput
- 参数
-
v
- adouble
包含要写入的值。 - 异常
-
IOException
- 如果发生I / O错误。
-
writeBytes
void writeBytes(String s) throws IOException
将一个字符串写入输出流。 对于字符串s
中的每个字符,按顺序,一个字节被写入输出流。 如果s
为null
,则抛出NullPointerException
。如果
s.length
为零,则不会写入任何字节。 否则,首先写入字符s[0]
,然后写入s[1]
,等等; 写最后一个字符是s[s.length-1]
。 对于每个字符,写入一个字节,低字节,按照writeByte
方式。 字符串中每个字符的高8位被忽略。如果流内的位偏移量不为零,则当前字节的剩余部分用0填充并首先写出。 写入后位偏移将为0。
- Specified by:
-
writeBytes
接口DataOutput
- 参数
-
s
- aString
包含要写入的值。 - 异常
-
NullPointerException
- 如果s
是null
。 -
IOException
- 如果发生I / O错误。
-
writeChars
void writeChars(String s) throws IOException
将一个字符串写入输出流。 对于字符串s
中的每个字符,按顺序,将两个字节写入输出流,根据当前字节顺序设置进行排序。 如果正在使用网络字节顺序,则首先写入高字节; 否则订单相反。 如果s
为null
,则抛出NullPointerException
。如果
s.length
为零,则不会写入任何字节。 否则,首先写入字符s[0]
,然后写入s[1]
,等等; 写最后一个字符是s[s.length-1]
。如果流内的位偏移量不为零,则当前字节的剩余部分用0填充并首先写出。 写入后位偏移将为0。
- Specified by:
-
writeChars
在接口DataOutput
- 参数
-
s
- aString
包含要写入的值。 - 异常
-
NullPointerException
- 如果s
是null
。 -
IOException
- 如果发生I / O错误。
-
writeUTF
void writeUTF(String s) throws IOException
以网络字节顺序将两个字节的长度信息写入输出流,后跟字符串s
中每个字符的modified UTF-8表示。 如果s
为null
,则抛出NullPointerException
。 字符串s
中的每个字符根据字符的值转换为一个,两个或三个字节的组。如果字符
c
在\u0001
至\u007f
的范围内,则由一个字节表示:(byte)c
如果字符
c
是\u0000
或是在\u0080
到\u07ff
的范围内,那么它由两个字节表示,按照显示的顺序写:(byte)(0xc0 | (0x1f & (c >> 6))) (byte)(0x80 | (0x3f & c))
如果一个字符
c
在\u0800
到uffff
,那么它由三个字节表示,按照显示的顺序写:(byte)(0xe0 | (0x0f & (c >> 12))) (byte)(0x80 | (0x3f & (c >> 6))) (byte)(0x80 | (0x3f & c))
首先,计算表示
s
所有字符所需的总字节数。 如果这个数字大于65535
,则抛出一个UTFDataFormatException
。 否则,这个长度以writeShort
方式的方式写入输出流; 之后,写入字符串s
中每个字符的一字节,二字节或三字节表示。当前字节顺序设置被忽略。
如果流内的位偏移量不为零,则当前字节的剩余部分用0填充并首先写出。 写入后位偏移将为0。
注意:此方法不应用于执行使用标准UTF-8的图像格式,因为此处使用的修改后的UTF-8与标准UTF-8不兼容。
- Specified by:
-
writeUTF
在接口DataOutput
- 参数
-
s
- aString
包含要写入的值。 - 异常
-
NullPointerException
- 如果s
是null
。 -
UTFDataFormatException
-如果的改性UTF-8表示s
需要超过65536个字节。 -
IOException
- 如果发生I / O错误。
-
writeShorts
void writeShorts(short[] s, int off, int len) throws IOException
在当前位置写入流的序列。 如果len
为0,则不会写入。 短s[off]
先写,然后短s[off + 1]
等等。 流的字节顺序用于确定写入单个字节的顺序。如果流内的位偏移量不为零,则当前字节的剩余部分用0填充并首先写出。 写入后位偏移将为0。
- 参数
-
s
- 要写入的short
的数组。 -
off
- 数据中的起始偏移量。 -
len
-short
的len
的数量。 - 异常
-
IndexOutOfBoundsException
- 如果off
为负,len
,否则为off + len
,大于s.length
。 -
NullPointerException
- 如果s
是null
。 -
IOException
- 如果发生I / O错误。
-
writeChars
void writeChars(char[] c, int off, int len) throws IOException
在当前位置将一串字符写入流。 如果len
为0,len
写任何内容。 charc[off]
是先写的,然后是charc[off + 1]
,等等。 流的字节顺序用于确定写入单个字节的顺序。如果流内的位偏移量不为零,则当前字节的剩余部分用0填充并首先写出。 写入后位偏移将为0。
- 参数
-
c
- 要写入的char
的数组。 -
off
- 数据中的起始偏移量。 -
len
-char
的len
的数量。 - 异常
-
IndexOutOfBoundsException
- 如果off
为负数,len
,否则为off + len
,大于c.length
。 -
NullPointerException
- 如果c
是null
。 -
IOException
- 如果发生I / O错误。
-
writeInts
void writeInts(int[] i, int off, int len) throws IOException
在当前位置写入流的序列。 如果len
为0,则不会写入。 inti[off]
先写,然后是inti[off + 1]
,等等。 流的字节顺序用于确定写入单个字节的顺序。如果流内的位偏移量不为零,则当前字节的剩余部分用0填充并首先写出。 写入后位偏移将为0。
- 参数
-
i
- 要写入的int
的数组。 -
off
- 数据中的起始偏移量。 -
len
-int
的len
的数量。 - 异常
-
IndexOutOfBoundsException
- 如果off
为负,len
为负数,或off + len
为大于i.length
。 -
NullPointerException
- 如果i
是null
。 -
IOException
- 如果发生I / O错误。
-
writeLongs
void writeLongs(long[] l, int off, int len) throws IOException
在当前位置写入流的序列。 如果len
为0,则不会写入。 长l[off]
先写,然后长l[off + 1]
,等等。 流的字节顺序用于确定写入单个字节的顺序。如果流内的位偏移量不为零,则当前字节的剩余部分用0填充并首先写出。 写入后位偏移将为0。
- 参数
-
l
- 要写入的long
的数组。 -
off
- 数据中的起始偏移量。 -
len
-long
的len
的数量。 - 异常
-
IndexOutOfBoundsException
- 如果off
为负数,len
为负数,或off + len
为大于l.length
。 -
NullPointerException
- 如果l
是null
。 -
IOException
- 如果发生I / O错误。
-
writeFloats
void writeFloats(float[] f, int off, int len) throws IOException
在当前位置将一系列浮点写入流。 如果len
为0,则不会写入。 浮动f[off]
先写,然后浮动f[off + 1]
等等。 流的字节顺序用于确定写入单个字节的顺序。如果流内的位偏移量不为零,则当前字节的剩余部分用0填充并首先写出。 写入后位偏移将为0。
- 参数
-
f
- 要编写的float
的数组。 -
off
- 数据中的起始偏移量。 -
len
-float
的len
的数量。 - 异常
-
IndexOutOfBoundsException
- 如果off
为负,len
,否则为off + len
,大于f.length
。 -
NullPointerException
- 如果f
是null
。 -
IOException
- 如果发生I / O错误。
-
writeDoubles
void writeDoubles(double[] d, int off, int len) throws IOException
将当前位置的一系列双精度写入流。 如果len
为0,len
写任何内容。 双d[off]
先写,然后双d[off + 1]
等等。 流的字节顺序用于确定写入单个字节的顺序。如果流内的位偏移量不为零,则当前字节的剩余部分用0填充并首先写出。 写入后位偏移将为0。
- 参数
-
d
- 要写入的doubles
的数组。 -
off
- 数据中的起始偏移量。 -
len
-double
的len
的数量。 - 异常
-
IndexOutOfBoundsException
- 如果off
为负数,len
,否则为off + len
,大于d.length
。 -
NullPointerException
- 如果d
是null
。 -
IOException
- 如果发生I / O错误。
-
writeBit
void writeBit(int bit) throws IOException
将由参数的最低有效位给出的单个位写入当前字节位置中当前位偏移量的流。 参数的高31位被忽略。 给定位替换该位置上的前一位。 位偏移前进一并减少模8。如果特定字节的任何位在字节被刷新到目的地时从未被设置,则这些位将自动设置为0。
- 参数
-
bit
- 其最低有效位bit
的int
。 - 异常
-
IOException
- 如果发生I / O错误。
-
writeBits
void writeBits(long bits, int numBits) throws IOException
将bits
参数的bits
参数的从左到右顺序的numBits
位给出的位序列写入当前字节位置当前位偏移量的流。 上限的64 - numBits
位的参数被忽略。 位偏移提前numBits
并减小模8。注意,0的位偏移总是表示字节的最高有效位,并且在遇到位时,位的字节顺序写出。 因此,位写入总是以网络字节顺序有效。 实际流字节顺序设置被忽略。位数据可以无限期地累积在存储器中,直到
flushBefore
。 那时候,闪存位置之前的所有位数据将被写入。如果特定字节的任何位在字节被刷新到目的地时从未被设置,则这些位将自动设置为0。
- 参数
-
bits
-along
包含要写入的位,从位置numBits - 1
的位开始到最低有效位。 -
numBits
- 一个在0和64之间的int
(含)。 - 异常
-
IllegalArgumentException
- 如果numBits
不在0和64之间,包括0和64之间。 -
IOException
- 如果发生I / O错误。
-
flushBefore
void flushBefore(long pos) throws IOException
将给定位置之前的所有数据刷新到基础目标,例如OutputStream
或File
。 试图寻求流的冲洗部分将导致一个IndexOutOfBoundsException
。- Specified by:
-
flushBefore
在接口ImageInputStream
- 参数
-
pos
- 一个long
其中包含可能被刷新到目的地的流前缀的长度。 - 异常
-
IndexOutOfBoundsException
- 如果pos
位于流的冲洗部分或超过当前流位置。 -
IOException
- 如果发生I / O错误。
-
-