All Superinterfaces:: AutoCloseable, Channel, Closeable, ReadableByteChannel, Source

All Known Implementing Classes:: Buffer, RealSource

public interface BufferSource extends Source, ReadableByteChannel

内部保存一个缓冲区,以便调用者可以在没有性能的情况下进行少量读取它还允许客户端提前读取,在消费之前进行必要的缓冲输入

Since:: Java 17+
Author:: Kimi Liu

Method Summary

Modifier and Type

Method

Description

boolean

exhausted()

如果此源中没有更多字节，则返回 true。这将阻塞，直到有字节可读取或源确实已耗尽

Buffer

getBuffer()

该源的内部缓冲区

long

indexOf(byte b)

Equivalent to indexOf(b, 0).

long

indexOf(byte b, long fromIndex)

返回缓冲区中第一个 b 的索引，位于 fromIndex 处或之后。这会根据需要扩展缓冲区，直到找到 b。这会将无限数量的字节读入缓冲区。如果在找到请求的字节之前流已耗尽，则返回 -1。

long

indexOf(byte b, long fromIndex, long toIndex)

如果在 fromIndex 到 toIndex 范围内找到 b，则返回其索引。如果未找到 b，或者 fromIndex == toIndex，则返回 -1。

long

indexOf(ByteString bytes)

相当于indexOf(bytes, 0)。

long

indexOf(ByteString bytes, long fromIndex)

返回缓冲区中 bytes 的第一个匹配项的索引，位于 fromIndex 处或之后。这会根据需要扩展缓冲区，直到找到 bytes。这会将无限数量的字节读入缓冲区。如果在找到请求的字节之前流已耗尽，则返回 -1。

long

indexOfElement(ByteString targetBytes)

相当于indexOfElement(targetBytes, 0)。

long

indexOfElement(ByteString targetBytes, long fromIndex)

返回此缓冲区中位于 fromIndex 或之后且包含 targetBytes 中任意字节的第一个索引。这会根据需要扩展缓冲区，直到找到目标字节。这会将无限数量的字节读入缓冲区。如果在找到请求的字节之前流已耗尽，则返回 -1。

InputStream

inputStream()

返回从该源读取的输入流

BufferSource

peek()

返回一个新的 BufferedSource，可从此 BufferedSource读取数据但不使用它。一旦下次读取或关闭此源，返回的源将变为无效。

boolean

rangeEquals(long offset, ByteString bytes)

如果此源中 offset 处的字节等于 bytes，则返回 true。这会根据需要扩展缓冲区，直到某个字节不匹配、所有字节都匹配，或者在足够的字节确定匹配之前流已耗尽。

boolean

rangeEquals(long offset, ByteString bytes, int bytesOffset, int byteCount)

如果此源中 offset 处的 byteCount 个字节等于 bytesOffset 处的 bytes，则返回 true。这会根据需要扩展缓冲区，直到某个字节不匹配、所有字节都匹配，或者在足够的字节确定匹配之前流已耗尽。

int

read(byte[] sink)

从中移除最多 sink.length 个字节并将其复制到 sink。返回读取的字节数，如果此源已耗尽，则返回 -1。

int

read(byte[] sink, int offset, int byteCount)

从此处删除最多 byteCount 个字节并将其复制到 offset 处的 sink。返回读取的字节数，如果此源已耗尽，则返回 -1。

long

readAll(Sink sink)

从中删除所有字节并将其附加到 sink。返回写入 sink 的总字节数，如果已用尽，则为 0。

byte

readByte()

从该源中删除一个字节并返回它

byte[]

readByteArray()

从中删除所有字节并将它们作为字节数组返回。

byte[]

readByteArray(long byteCount)

从中删除 byteCount 个字节并将其作为字节数组返回。

ByteString

readByteString()

从中删除所有字节并将它们作为字节字符串返回

ByteString

readByteString(long byteCount)

从中删除 byteCount 个字节并将其作为字节字符串返回。

long

readDecimalLong()

以有符号十进制形式从此源读取一个长整型值（即以十进制为基数的字符串，前导字符可选为“-”）。此操作将不断迭代，直到找到非数字字符。

void

readFully(byte[] sink)

从中删除恰好 sink.length 个字节并将其复制到 sink。如果无法读取请求的字节数，则抛出 EOFException。

void

readFully(Buffer sink, long byteCount)

从中删除精确的 byteCount 个字节并将其附加到 sink。如果无法读取请求的字节数，则抛出 EOFException。

long

readHexadecimalUnsignedLong()

以十六进制形式（即以 16 进制表示的字符串）读取此源的长格式。此过程将不断迭代，直到找到非十六进制字符

int

readInt()

从此源中删除四个字节并返回一个大整数

int

readIntLe()

从该源中删除四个字节并返回一个小整数

long

readLong()

该源中删除八个字节并返回一个大长整型

long

readLongLe()

从此源中删除八个字节并返回一个小长整型

short

readShort()

从此源中删除两个字节并返回一个短整型

short

readShortLe()

从此源中删除两个字节并返回一个整型

String

readString(long byteCount, Charset charset)

从中删除 byteCount 个字节，将其解码为 charset，并返回字符串。

String

readString(Charset charset)

从中删除所有字节，将其解码为charset，并返回字符串。

String

readUtf8()

从中删除所有字节，将其解码为 UTF-8，然后返回字符串。如果此源为空，则返回空字符串。

String

readUtf8(long byteCount)

从中删除 byteCount 个字节，将其解码为 UTF-8，并返回字符串。

int

readUtf8CodePoint()

删除并返回单个 UTF-8 代码点，根据需要读取 1 到 4 个字节。如果此源不是以正确编码的 UTF-8 代码点开头，则此方法将删除 1 个或多个非 UTF-8 字节并返回替换字符 (U+FFFD)。这包括编码问题（输入不是正确编码的 UTF-8）、字符超出范围（超出 Unicode 的 0x10ffff 限制）、UTF-16 代理的代码点 (U+d800..U+dfff) 和过长编码（例如，修改版 UTF-8 中的 NUL 字符为 0xc080）

String

readUtf8Line()

删除并返回直到下一个换行符（但不包括该换行符）的字符。换行符为 "\n" 或 "\r\n"；这些字符不包含在结果中。

String

readUtf8LineStrict()

删除并返回直到下一个换行符（但不包括该换行符）的字符。换行符为 "\n" 或 "\r\n"；这些字符不包含在结果中

String

readUtf8LineStrict(long limit)

与 readUtf8LineStrict() 类似，不同之处在于它允许调用者指定允许的最长匹配。使用它来防止可能不包含 "\n" 或 "\r\n" 的流。

boolean

request(long byteCount)

如果缓冲区至少包含 byteCount 个字节，则返回 true，并根据需要对其进行扩展。如果在读取请求的字节之前源已耗尽，则返回 false。

void

require(long byteCount)

当缓冲区至少包含 byteCount 个字节时返回。如果在读取所需字节之前源已耗尽，则抛出 EOFException。

int

select(SegmentBuffer segmentBuffer)

在options 中查找第一个作为此缓冲区前缀的字符串，从此缓冲区中使用它，并返回其索引。如果 options 中没有字节字符串是此缓冲区的前缀，则返回 -1，并且不消耗任何字节。如果事先知道预期值集，则可以将其用作 readByteString() 甚至 readUtf8() 的替代。

void

skip(long byteCount)

从此源读取并丢弃 byteCount 个字节

Methods inherited from interface java.nio.channels.Channel
close, isOpen

Methods inherited from interface java.nio.channels.ReadableByteChannel
read

Methods inherited from interface org.miaixz.bus.core.io.source.Source
close, read, timeout

Method Details
- getBuffer
  
  Buffer getBuffer()
  
  该源的内部缓冲区
  
  Returns:
  
  Buffer
- exhausted
  
  boolean exhausted() throws IOException
  
  如果此源中没有更多字节，则返回 true。这将阻塞，直到有字节可读取或源确实已耗尽
  
  Returns:
  
  the true/false
  
  Throws:
  
  IOException - 异常
- require
  
  void require(long byteCount) throws IOException
  
  当缓冲区至少包含 byteCount 个字节时返回。如果在读取所需字节之前源已耗尽，则抛出 EOFException。
  
  Parameters:
  
  byteCount - 字节数
  
  Throws:
  
  IOException - 异常
- request
  
  boolean request(long byteCount) throws IOException
  
  如果缓冲区至少包含 byteCount 个字节，则返回 true，并根据需要对其进行扩展。如果在读取请求的字节之前源已耗尽，则返回 false。
  
  Parameters:
  
  byteCount - 字节数
  
  Returns:
  
  the true/false
  
  Throws:
  
  IOException - 异常
- readByte
  
  byte readByte() throws IOException
  
  从该源中删除一个字节并返回它
  
  Returns:
  
  the true/false
  
  Throws:
  
  IOException - 异常
- readShort
  
  short readShort() throws IOException
  从此源中删除两个字节并返回一个短整型
  Buffer buffer = new Buffer().writeByte(0x7f).writeByte(0xff).writeByte(0x00).writeByte(0x0f); assertEquals(4, buffer.size()); assertEquals(32767, buffer.readShort()); assertEquals(2, buffer.size()); assertEquals(15, buffer.readShort()); assertEquals(0, buffer.size());
  Returns:
  
  the short
  
  Throws:
  
  IOException - 异常
- readShortLe
  
  short readShortLe() throws IOException
  从此源中删除两个字节并返回一个整型
  Buffer buffer = new Buffer().writeByte(0xff).writeByte(0x7f).writeByte(0x0f).writeByte(0x00); assertEquals(4, buffer.size()); assertEquals(32767, buffer.readShortLe()); assertEquals(2, buffer.size()); assertEquals(15, buffer.readShortLe()); assertEquals(0, buffer.size());
  Returns:
  
  the short
  
  Throws:
  
  IOException - 异常
- readInt
  
  int readInt() throws IOException
  从此源中删除四个字节并返回一个大整数
  Buffer buffer = new Buffer().writeByte(0x7f).writeByte(0xff).writeByte(0xff).writeByte(0xff).writeByte(0x00) .writeByte(0x00).writeByte(0x00).writeByte(0x0f); assertEquals(8, buffer.size()); assertEquals(2147483647, buffer.readInt()); assertEquals(4, buffer.size()); assertEquals(15, buffer.readInt()); assertEquals(0, buffer.size());
  Returns:
  
  the int
  
  Throws:
  
  IOException
- readIntLe
  
  int readIntLe() throws IOException
  从该源中删除四个字节并返回一个小整数
  Buffer buffer = new Buffer().writeByte(0xff).writeByte(0xff).writeByte(0xff).writeByte(0x7f).writeByte(0x0f) .writeByte(0x00).writeByte(0x00).writeByte(0x00); assertEquals(8, buffer.size()); assertEquals(2147483647, buffer.readIntLe()); assertEquals(4, buffer.size()); assertEquals(15, buffer.readIntLe()); assertEquals(0, buffer.size());
  Returns:
  
  the int
  
  Throws:
  
  IOException
- readLong
  
  long readLong() throws IOException
  该源中删除八个字节并返回一个大长整型
  Buffer buffer = new Buffer().writeByte(0x7f).writeByte(0xff).writeByte(0xff).writeByte(0xff).writeByte(0xff) .writeByte(0xff).writeByte(0xff).writeByte(0xff).writeByte(0x00).writeByte(0x00).writeByte(0x00) .writeByte(0x00).writeByte(0x00).writeByte(0x00).writeByte(0x00).writeByte(0x0f); assertEquals(16, buffer.size()); assertEquals(9223372036854775807L, buffer.readLong()); assertEquals(8, buffer.size()); assertEquals(15, buffer.readLong()); assertEquals(0, buffer.size());
  Returns:
  
  the long
  
  Throws:
  
  IOException
- readLongLe
  
  long readLongLe() throws IOException
  从此源中删除八个字节并返回一个小长整型
  Buffer buffer = new Buffer().writeByte(0xff).writeByte(0xff).writeByte(0xff).writeByte(0xff).writeByte(0xff) .writeByte(0xff).writeByte(0xff).writeByte(0x7f).writeByte(0x0f).writeByte(0x00).writeByte(0x00) .writeByte(0x00).writeByte(0x00).writeByte(0x00).writeByte(0x00).writeByte(0x00); assertEquals(16, buffer.size()); assertEquals(9223372036854775807L, buffer.readLongLe()); assertEquals(8, buffer.size()); assertEquals(15, buffer.readLongLe()); assertEquals(0, buffer.size());
  Returns:
  
  the long
  
  Throws:
  
  IOException
- readDecimalLong
  
  long readDecimalLong() throws IOException
  以有符号十进制形式从此源读取一个长整型值（即以十进制为基数的字符串，前导字符可选为“-”）。此操作将不断迭代，直到找到非数字字符。
  Buffer buffer = new Buffer().writeUtf8("8675309 -123 00001"); assertEquals(8675309L, buffer.readDecimalLong()); assertEquals(' ', buffer.readByte()); assertEquals(-123L, buffer.readDecimalLong()); assertEquals(' ', buffer.readByte()); assertEquals(1L, buffer.readDecimalLong());
  Returns:
  
  the long
  
  Throws:
  
  NumberFormatException - 如果找到的数字不适合 long 或不存在十进制数。
  
  IOException
- readHexadecimalUnsignedLong
  
  long readHexadecimalUnsignedLong() throws IOException
  以十六进制形式（即以 16 进制表示的字符串）读取此源的长格式。此过程将不断迭代，直到找到非十六进制字符
  Buffer buffer = new Buffer().writeUtf8("ffff CAFEBABE 10"); assertEquals(65535L, buffer.readHexadecimalUnsignedLong()); assertEquals(' ', buffer.readByte()); assertEquals(0xcafebabeL, buffer.readHexadecimalUnsignedLong()); assertEquals(' ', buffer.readByte()); assertEquals(0x10L, buffer.readHexadecimalUnsignedLong());
  Returns:
  
  the long
  
  Throws:
  
  NumberFormatException - 如果找到的十六进制数不适合 long 或未找到十六进制数。
  
  IOException
- skip
  
  void skip(long byteCount) throws IOException
  
  从此源读取并丢弃 byteCount 个字节
  
  Parameters:
  
  byteCount - 字节数
  
  Throws:
  
  IOException - 如果在跳过请求的字节之前源已耗尽，则抛出。
- readByteString
  
  ByteString readByteString() throws IOException
  
  从中删除所有字节并将它们作为字节字符串返回
  
  Returns:
  
  the ByteString
  
  Throws:
  
  IOException - 异常
- readByteString
  
  ByteString readByteString(long byteCount) throws IOException
  
  从中删除 byteCount 个字节并将其作为字节字符串返回。
  
  Returns:
  
  the ByteString
  
  Throws:
  
  IOException - 异常
- select
  
  int select(SegmentBuffer segmentBuffer) throws IOException
  在options 中查找第一个作为此缓冲区前缀的字符串，从此缓冲区中使用它，并返回其索引。如果 options 中没有字节字符串是此缓冲区的前缀，则返回 -1，并且不消耗任何字节。如果事先知道预期值集，则可以将其用作 readByteString() 甚至 readUtf8() 的替代。
  Options FIELDS = Options.of(ByteString.encodeUtf8("depth="), ByteString.encodeUtf8("height="), ByteString.encodeUtf8("width=")); Buffer buffer = new Buffer().writeUtf8("width=640\n").writeUtf8("height=480\n"); assertEquals(2, buffer.select(FIELDS)); assertEquals(640, buffer.readDecimalLong()); assertEquals('\n', buffer.readByte()); assertEquals(1, buffer.select(FIELDS)); assertEquals(480, buffer.readDecimalLong()); assertEquals('\n', buffer.readByte());
  Parameters:
  
  segmentBuffer - 索引值
  
  Returns:
  
  the int
  
  Throws:
  
  IOException - 异常
- readByteArray
  
  byte[] readByteArray() throws IOException
  
  从中删除所有字节并将它们作为字节数组返回。
  
  Returns:
  
  the byte
  
  Throws:
  
  IOException - 异常
- readByteArray
  
  byte[] readByteArray(long byteCount) throws IOException
  
  从中删除 byteCount 个字节并将其作为字节数组返回。
  
  Returns:
  
  the byte
  
  Throws:
  
  IOException - 异常
- read
  
  int read(byte[] sink) throws IOException
  
  从中移除最多 sink.length 个字节并将其复制到 sink。返回读取的字节数，如果此源已耗尽，则返回 -1。
  
  Parameters:
  
  sink - 字节集合
  
  Returns:
  
  the int
  
  Throws:
  
  IOException - 异常
- readFully
  
  void readFully(byte[] sink) throws IOException
  
  从中删除恰好 sink.length 个字节并将其复制到 sink。如果无法读取请求的字节数，则抛出 EOFException。
  
  Parameters:
  
  sink - 字节集合
  
  Throws:
  
  IOException - 异常
- read
  
  int read(byte[] sink, int offset, int byteCount) throws IOException
  
  从此处删除最多 byteCount 个字节并将其复制到 offset 处的 sink。返回读取的字节数，如果此源已耗尽，则返回 -1。
  
  Parameters:
  
  sink - 字节集合
  
  offset - 偏移位
  
  byteCount - 字节数
  
  Returns:
  
  the int
  
  Throws:
  
  IOException - 异常
- readFully
  
  void readFully(Buffer sink, long byteCount) throws IOException
  
  从中删除精确的 byteCount 个字节并将其附加到 sink。如果无法读取请求的字节数，则抛出 EOFException。
  
  Parameters:
  
  sink - 字节集合
  
  byteCount - 字节数
  
  Throws:
  
  IOException - 异常
- readAll
  
  long readAll(Sink sink) throws IOException
  
  从中删除所有字节并将其附加到 sink。返回写入 sink 的总字节数，如果已用尽，则为 0。
  
  Parameters:
  
  sink - 字节集合
  
  Returns:
  
  the long
  
  Throws:
  
  IOException - 异常
- readUtf8
  
  String readUtf8() throws IOException
  从中删除所有字节，将其解码为 UTF-8，然后返回字符串。如果此源为空，则返回空字符串。
  Buffer buffer = new Buffer().writeUtf8("Uh uh uh!").writeByte(' ').writeUtf8("You didn't say the magic word!"); assertEquals("Uh uh uh! You didn't say the magic word!", buffer.readUtf8()); assertEquals(0, buffer.size()); assertEquals("", buffer.readUtf8()); assertEquals(0, buffer.size());
  Returns:
  
  the string
  
  Throws:
  
  IOException - 异常
- readUtf8
  
  String readUtf8(long byteCount) throws IOException
  从中删除 byteCount 个字节，将其解码为 UTF-8，并返回字符串。
  Buffer buffer = new Buffer().writeUtf8("Uh uh uh!").writeByte(' ').writeUtf8("You didn't say the magic word!"); assertEquals(40, buffer.size()); assertEquals("Uh uh uh! You ", buffer.readUtf8(14)); assertEquals(26, buffer.size()); assertEquals("didn't say the", buffer.readUtf8(14)); assertEquals(12, buffer.size()); assertEquals(" magic word!", buffer.readUtf8(12)); assertEquals(0, buffer.size());
  Parameters:
  
  byteCount - 字节数
  
  Returns:
  
  the string
  
  Throws:
  
  IOException - 异常
- readUtf8Line
  
  String readUtf8Line() throws IOException
  删除并返回直到下一个换行符（但不包括该换行符）的字符。换行符为 "\n" 或 "\r\n"；这些字符不包含在结果中。
  Buffer buffer = new Buffer().writeUtf8("I'm a hacker!\n").writeUtf8("That's what I said: you're a nerd.\n") .writeUtf8("I prefer to be called a hacker!\n"); assertEquals(81, buffer.size()); assertEquals("I'm a hacker!", buffer.readUtf8Line()); assertEquals(67, buffer.size()); assertEquals("That's what I said: you're a nerd.", buffer.readUtf8Line()); assertEquals(32, buffer.size()); assertEquals("I prefer to be called a hacker!", buffer.readUtf8Line()); assertEquals(0, buffer.size()); assertEquals(null, buffer.readUtf8Line()); assertEquals(0, buffer.size());
  在流的末尾，此方法返回 null， 就像 BufferedReader 一样。如果源未以换行符结尾，则假定为隐式换行符。一旦源耗尽，将返回 Null。将此方法用于人工生成的数据，其中尾随换行符是可选的。
  Returns:
  
  the string
  
  Throws:
  
  IOException - 异常
- readUtf8LineStrict
  
  String readUtf8LineStrict() throws IOException
  
  删除并返回直到下一个换行符（但不包括该换行符）的字符。换行符为 "\n" 或 "\r\n"；这些字符不包含在结果中
  
  Returns:
  
  the string
  
  Throws:
  
  IOException - 异常
- readUtf8LineStrict
  
  String readUtf8LineStrict(long limit) throws IOException
  与 readUtf8LineStrict() 类似，不同之处在于它允许调用者指定允许的最长匹配。使用它来防止可能不包含 "\n" 或 "\r\n" 的流。
  Buffer buffer = new Buffer(); buffer.writeUtf8("12345\r\n"); // This will throw! There must be \r\n or \n at the limit or before it. buffer.readUtf8LineStrict(4); // No bytes have been consumed so the caller can retry. assertEquals("12345", buffer.readUtf8LineStrict(5));
  Parameters:
  
  limit - 限制
  
  Returns:
  
  the string
  
  Throws:
  
  IOException - 异常
- readUtf8CodePoint
  
  int readUtf8CodePoint() throws IOException
  
  删除并返回单个 UTF-8 代码点，根据需要读取 1 到 4 个字节。如果此源不是以正确编码的 UTF-8 代码点开头，则此方法将删除 1 个或多个非 UTF-8 字节并返回替换字符 (U+FFFD)。这包括编码问题（输入不是正确编码的 UTF-8）、字符超出范围（超出 Unicode 的 0x10ffff 限制）、UTF-16 代理的代码点 (U+d800..U+dfff) 和过长编码（例如，修改版 UTF-8 中的 NUL 字符为 0xc080）
  
  Returns:
  
  the int
  
  Throws:
  
  IOException - 异常
- readString
  
  String readString(Charset charset) throws IOException
  
  从中删除所有字节，将其解码为charset，并返回字符串。
  
  Parameters:
  
  charset - 字符编码
  
  Returns:
  
  the string
  
  Throws:
  
  IOException - 异常
- readString
  
  String readString(long byteCount, Charset charset) throws IOException
  
  从中删除 byteCount 个字节，将其解码为 charset，并返回字符串。
  
  Parameters:
  
  byteCount - 字节数
  
  charset - 字符编码
  
  Returns:
  
  the string
  
  Throws:
  
  IOException - 异常
- indexOf
  
  long indexOf(byte b) throws IOException
  
  Equivalent to indexOf(b, 0).
  
  Parameters:
  
  b -
  
  Returns:
  
  the long
  
  Throws:
  
  IOException - 异常
- indexOf
  
  long indexOf(byte b, long fromIndex) throws IOException
  返回缓冲区中第一个 b 的索引，位于 fromIndex 处或之后。这会根据需要扩展缓冲区，直到找到 b。这会将无限数量的字节读入缓冲区。如果在找到请求的字节之前流已耗尽，则返回 -1。
  Buffer buffer = new Buffer(); buffer.writeUtf8("Don't move! He can't see us if we don't move."); byte m = 'm'; assertEquals(6, buffer.indexOf(m)); assertEquals(40, buffer.indexOf(m, 12));
  Parameters:
  
  b -
  
  fromIndex -
  
  Returns:
  
  the long
  
  Throws:
  
  IOException - 异常
- indexOf
  
  long indexOf(byte b, long fromIndex, long toIndex) throws IOException
  
  如果在 fromIndex 到 toIndex 范围内找到 b，则返回其索引。如果未找到 b，或者 fromIndex == toIndex，则返回 -1。
  
  Parameters:
  
  b - 字节
  
  fromIndex - 开始索引
  
  toIndex - 目标索引
  
  Returns:
  
  the long
  
  Throws:
  
  IOException - 异常
- indexOf
  
  long indexOf(ByteString bytes) throws IOException
  
  相当于indexOf(bytes, 0)。
  
  Parameters:
  
  bytes - 字节
  
  Returns:
  
  the long
  
  Throws:
  
  IOException - 异常
- indexOf
  
  long indexOf(ByteString bytes, long fromIndex) throws IOException
  返回缓冲区中 bytes 的第一个匹配项的索引，位于 fromIndex 处或之后。这会根据需要扩展缓冲区，直到找到 bytes。这会将无限数量的字节读入缓冲区。如果在找到请求的字节之前流已耗尽，则返回 -1。
  ByteString MOVE = ByteString.encodeUtf8("move"); Buffer buffer = new Buffer(); buffer.writeUtf8("Don't move! He can't see us if we don't move."); assertEquals(6, buffer.indexOf(MOVE)); assertEquals(40, buffer.indexOf(MOVE, 12));
  Parameters:
  
  bytes - 字节
  
  fromIndex - 字节索引
  
  Returns:
  
  the long
  
  Throws:
  
  IOException - 异常
- indexOfElement
  
  long indexOfElement(ByteString targetBytes) throws IOException
  
  相当于indexOfElement(targetBytes, 0)。
  
  Parameters:
  
  targetBytes - 目标字节
  
  Returns:
  
  the long
  
  Throws:
  
  IOException - 异常
- indexOfElement
  
  long indexOfElement(ByteString targetBytes, long fromIndex) throws IOException
  返回此缓冲区中位于 fromIndex 或之后且包含 targetBytes 中任意字节的第一个索引。这会根据需要扩展缓冲区，直到找到目标字节。这会将无限数量的字节读入缓冲区。如果在找到请求的字节之前流已耗尽，则返回 -1。
  ByteString ANY_VOWEL = ByteString.encodeUtf8("AEOIUaeoiu"); Buffer buffer = new Buffer(); buffer.writeUtf8("Dr. Alan Grant"); assertEquals(4, buffer.indexOfElement(ANY_VOWEL)); // 'A' in 'Alan'. assertEquals(11, buffer.indexOfElement(ANY_VOWEL, 9)); // 'a' in 'Grant'.
  Parameters:
  
  targetBytes - 目标字节
  
  fromIndex - 开始索引
  
  Returns:
  
  the long
  
  Throws:
  
  IOException - 异常
- rangeEquals
  
  boolean rangeEquals(long offset, ByteString bytes) throws IOException
  如果此源中 offset 处的字节等于 bytes，则返回 true。这会根据需要扩展缓冲区，直到某个字节不匹配、所有字节都匹配，或者在足够的字节确定匹配之前流已耗尽。
  ByteString simonSays = ByteString.encodeUtf8("Simon says:"); Buffer standOnOneLeg = new Buffer().writeUtf8("Simon says: Stand on one leg."); assertTrue(standOnOneLeg.rangeEquals(0, simonSays)); Buffer payMeMoney = new Buffer().writeUtf8("Pay me $1,000,000."); assertFalse(payMeMoney.rangeEquals(0, simonSays));
  Parameters:
  
  offset - 偏移量
  
  bytes - 字节
  
  Returns:
  
  Throws:
  
  IOException - 异常
- rangeEquals
  
  boolean rangeEquals(long offset, ByteString bytes, int bytesOffset, int byteCount) throws IOException
  
  如果此源中 offset 处的 byteCount 个字节等于 bytesOffset 处的 bytes，则返回 true。这会根据需要扩展缓冲区，直到某个字节不匹配、所有字节都匹配，或者在足够的字节确定匹配之前流已耗尽。
  
  Parameters:
  
  offset - 偏移量
  
  bytes - 字节
  
  bytesOffset - 字节偏移量
  
  byteCount - 字节数
  
  Returns:
  
  the true/false
  
  Throws:
  
  IOException - 异常
- peek
  
  BufferSource peek()
  返回一个新的 BufferedSource，可从此 BufferedSource读取数据但不使用它。一旦下次读取或关闭此源，返回的源将变为无效。
  Buffer buffer = new Buffer(); buffer.writeUtf8("abcdefghi"); buffer.readUtf8(3) // returns "abc", buffer contains "defghi" BufferedSource peek = buffer.peek(); peek.readUtf8(3); // returns "def", buffer contains "defghi" peek.readUtf8(3); // returns "ghi", buffer contains "defghi" buffer.readUtf8(3); // returns "def", buffer contains "ghi"
  Returns:
  
  BufferSource
- inputStream
  
  InputStream inputStream()
  
  返回从该源读取的输入流
  
  Returns:
  
  InputStream

Interface BufferSource

Method Summary

Methods inherited from interface java.nio.channels.Channel

Methods inherited from interface java.nio.channels.ReadableByteChannel

Methods inherited from interface org.miaixz.bus.core.io.source.Source

Method Details

getBuffer

exhausted

require

request

readByte

readShort

readShortLe

readInt

readIntLe

readLong

readLongLe

readDecimalLong

readHexadecimalUnsignedLong

skip

readByteString

readByteString

select

readByteArray

readByteArray

read

readFully

read

readFully

readAll

readUtf8

readUtf8

readUtf8Line

readUtf8LineStrict

readUtf8LineStrict

readUtf8CodePoint

readString

readString

indexOf

indexOf

indexOf

indexOf

indexOf

indexOfElement

indexOfElement

rangeEquals

rangeEquals

peek

inputStream