1. 首页
  2. JavaAPI

Java javax.imageio.stream 接口 ImageOutputStream（JDK5）

145 阅读 0 评论

所有类

概述  软件包   类  使用  树  已过时  索引  帮助 
摘要： 嵌套 | 字段 | 构造方法 | 方法 详细信息： 字段 | 构造方法 | 方法

javax.imageio.stream
接口 ImageOutputStream

所有超级接口：
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

方法摘要
 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 个最低有效位按从左到右的顺序给定）写入到流的当前字节位置中的当前位偏移量。
 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)
          将 char 序列写入到流中的当前位置。
 void writeChars(String s)
          将一个字符串写入输出流。
 void writeDouble(double v)
          将一个 double 值写入输出流，该值由四个字节组成。
 void writeDoubles(double[] d, int off, int len)
          将 double 序列写入到流中的当前位置。
 void writeFloat(float v)
          将一个 float 值写入输出流，该值由四个字节组成。
 void writeFloats(float[] f, int off, int len)
          将 float 序列写入到流中的当前位置。
 void writeInt(int v)
          将 v 的 32 个位写入到流中。
 void writeInts(int[] i, int off, int len)
          将 int 序列写入到流中的当前位置。
 void writeLong(long v)
          将 v 的 64 个位写入到流中。
 void writeLongs(long[] l, int off, int len)
          将 long 序列写入到流中的当前位置。
 void writeShort(int v)
          将 v 的 16 个低位写入到流中。
 void writeShorts(short[] s, int off, int len)
          将 short 序列写入到流中的当前位置。
 void writeUTF(String s)
          将表示长度信息的两个字节按网络字节顺序写入输出流，后跟字符串 s 中每个字符的 UTF-8 修改版表示形式。
 
从接口 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。实现方可使用 ImageOutputStreamImpl 的 flushBits 方法来保证这一点。

指定者：
接口 DataOutput 中的 write
参数：
b - 一个 int，其低 8 位将被写入。
抛出：
IOException - 如果发生 I/O 错误。

write

void write(byte[] b)
           throws IOException
将字节序列写入到流中的当前位置。如果 b.length 为 0，则不写入任何字节。首先写入字节 b[0]，然后写入字节 b[1]，依此类推。

如果流中的位偏移量不为零，则首先将当前字节的余项用 0 填充并将其写出。写出后位偏移量将为 0。

指定者：
接口 DataOutput 中的 write
参数：
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。实现方可使用 ImageOutputStreamImpl 的 flushBits 方法来保证这一点。

指定者：
接口 DataOutput 中的 write
参数：
b - 要写入的 byte 数组。
off - 数据中的初始偏移量。
len - 要写入的 byte 数。
抛出：
IndexOutOfBoundsException - 如果 off 为负、len 为负或者 off + len 大于 b.length。
NullPointerException - 如果 b 为 null。
IOException - 如果发生 I/O 错误。

writeBoolean

void writeBoolean(boolean v)
                  throws IOException
将一个 boolean 值写入到流中。如果 v 为 true，则写入值 (byte)1；如果 v 为 false，则写入值 (byte)0。

如果流中的位偏移量不为零，则首先将当前字节的余项用 0 填充并将其写出。写出后位偏移量将为 0。

指定者：
接口 DataOutput 中的 writeBoolean
参数：
v - 要写入的 boolean 值。
抛出：
IOException - 如果发生 I/O 错误。

writeByte

void writeByte(int v)
               throws IOException
将 v 的 8 个低位写入到流中。忽略 v 的 24 个高位。（这意味着 writeByte 的作用与使用整数做参数的 write 完全相同。）

如果流中的位偏移量不为零，则首先将当前字节的余项用 0 填充并将其写出。写出后位偏移量将为 0。

指定者：
接口 DataOutput 中的 writeByte
参数：
v - 一个 int，包含要写入的 byte 值。
抛出：
IOException - 如果发生 I/O 错误。

writeShort

void writeShort(int v)
                throws IOException
将 v 的 16 个低位写入到流中。忽略 v 的 16 个高位。如果流使用网络字节顺序，则写入的字节将依次为： 
(byte)((v >> 8) & 0xff)
 (byte)(v & 0xff)
否则，写入的字节将为： 
 (byte)(v & 0xff)
(byte)((v >> 8) & 0xff)

如果流中的位偏移量不为零，则首先将当前字节的余项用 0 填充并将其写出。写出后位偏移量将为 0。

指定者：
接口 DataOutput 中的 writeShort
参数：
v - 一个 int，包含要写入的 short 值。
抛出：
IOException - 如果发生 I/O 错误。

writeChar

void writeChar(int v)
               throws IOException
此方法与 writeShort 同义。

指定者：
接口 DataOutput 中的 writeChar
参数：
v - 一个 int，它包含要写入的 char（无符号 short）值。
抛出：
IOException - 如果发生 I/O 错误。
另请参见：
writeShort(int)

微信小程序

微信扫一扫体验

微信公众账号

微信扫一扫加关注

 发表
评论 返回
顶部