BufferedSource (library 3.8.1-SNAPSHOT API)

所有超级接口:

java.lang.AutoCloseable, java.io.Closeable, Source

所有已知实现类:

Buffer
```
public interface BufferedSource
extends Source
```
A source that keeps a buffer internally so that callers can do small reads without a performance penalty. It also allows clients to read ahead, buffering as much as necessary before consuming input.

方法概要

所有方法实例方法抽象方法
限定符和类型	方法和说明
`Buffer`	`buffer()` Returns this source's internal buffer.
`boolean`	`exhausted()` Returns true if there are no more bytes in this source.
`long`	`indexOf(byte b)` Returns the index of the first `b` in the buffer.
`long`	`indexOf(byte b, long fromIndex)` Returns the index of the first `b` in the buffer at or after `fromIndex`.
`long`	`indexOf(ByteString bytes)` Returns the index of the first match for `bytes` in the buffer.
`long`	`indexOf(ByteString bytes, long fromIndex)` Returns the index of the first match for `bytes` in the buffer at or after `fromIndex`.
`long`	`indexOfElement(ByteString targetBytes)` Returns the index of the first byte in `targetBytes` in the buffer.
`long`	`indexOfElement(ByteString targetBytes, long fromIndex)` Returns the index of the first byte in `targetBytes` in the buffer at or after `fromIndex`.
`java.io.InputStream`	`inputStream()` Returns an input stream that reads from this source.
`int`	`read(byte[] sink)` Removes up to `sink.length` bytes from this and copies them into `sink`.
`int`	`read(byte[] sink, int offset, int byteCount)` Removes up to `byteCount` bytes from this and copies them into `sink` at `offset`.
`long`	`readAll(Sink sink)` Removes all bytes from this and appends them to `sink`.
`byte`	`readByte()` Removes a byte from this source and returns it.
`byte[]`	`readByteArray()` Removes all bytes from this and returns them as a byte array.
`byte[]`	`readByteArray(long byteCount)` Removes `byteCount` bytes from this and returns them as a byte array.
`ByteString`	`readByteString()` Removes all bytes bytes from this and returns them as a byte string.
`ByteString`	`readByteString(long byteCount)` Removes `byteCount` bytes from this and returns them as a byte string.
`long`	`readDecimalLong()` Reads a long from this source in signed decimal form (i.e., as a string in base 10 with optional leading '-').
`void`	`readFully(Buffer sink, long byteCount)` Removes exactly `byteCount` bytes from this and appends them to `sink`.
`void`	`readFully(byte[] sink)` Removes exactly `sink.length` bytes from this and copies them into `sink`.
`long`	`readHexadecimalUnsignedLong()` Reads a long form this source in hexadecimal form (i.e., as a string in base 16).
`int`	`readInt()` Removes four bytes from this source and returns a big-endian int.
`int`	`readIntLe()` Removes four bytes from this source and returns a little-endian int.
`long`	`readLong()` Removes eight bytes from this source and returns a big-endian long.
`long`	`readLongLe()` Removes eight bytes from this source and returns a little-endian long.
`short`	`readShort()` Removes two bytes from this source and returns a big-endian short.
`short`	`readShortLe()` Removes two bytes from this source and returns a little-endian short.
`java.lang.String`	`readString(java.nio.charset.Charset charset)` Removes all bytes from this, decodes them as `charset`, and returns the string.
`java.lang.String`	`readString(long byteCount, java.nio.charset.Charset charset)` Removes `byteCount` bytes from this, decodes them as `charset`, and returns the string.
`java.lang.String`	`readUtf8()` Removes all bytes from this, decodes them as UTF-8, and returns the string.
`java.lang.String`	`readUtf8(long byteCount)` Removes `byteCount` bytes from this, decodes them as UTF-8, and returns the string.
`int`	`readUtf8CodePoint()` Removes and returns a single UTF-8 code point, reading between 1 and 4 bytes as necessary.
`java.lang.String`	`readUtf8Line()` Removes and returns characters up to but not including the next line break.
`java.lang.String`	`readUtf8LineStrict()` Removes and returns characters up to but not including the next line break.
`boolean`	`request(long byteCount)` Returns true when the buffer contains at least `byteCount` bytes, expanding it as necessary.
`void`	`require(long byteCount)` Returns when the buffer contains at least `byteCount` bytes.
`void`	`skip(long byteCount)` Reads and discards `byteCount` bytes from this source.

从接口继承的方法 com.meizu.cloud.pushsdk.networking.okio.Source
close, read, timeout

- 方法详细资料
  - buffer
```
Buffer buffer()
```
    Returns this source's internal buffer.
  - exhausted
```
boolean exhausted()
           throws java.io.IOException
```
    Returns true if there are no more bytes in this source. This will block until there are bytes to read or the source is definitely exhausted.
    
    抛出:
    
    java.io.IOException
  - require
```
void require(long byteCount)
      throws java.io.IOException
```
    Returns when the buffer contains at least byteCount bytes. Throws an EOFException if the source is exhausted before the required bytes can be read.
    
    抛出:
    
    java.io.IOException
  - request
```
boolean request(long byteCount)
         throws java.io.IOException
```
    Returns true when the buffer contains at least byteCount bytes, expanding it as necessary. Returns false if the source is exhausted before the requested bytes can be read.
    
    抛出:
    
    java.io.IOException
  - readByte
```
byte readByte()
       throws java.io.IOException
```
    Removes a byte from this source and returns it.
    
    抛出:
    
    java.io.IOException
  - readShort
```
short readShort()
         throws java.io.IOException
```
    Removes two bytes from this source and returns a big-endian short.
    
    抛出:
    
    java.io.IOException
  - readShortLe
```
short readShortLe()
           throws java.io.IOException
```
    Removes two bytes from this source and returns a little-endian short.
    
    抛出:
    
    java.io.IOException
  - readInt
```
int readInt()
     throws java.io.IOException
```
    Removes four bytes from this source and returns a big-endian int.
    
    抛出:
    
    java.io.IOException
  - readIntLe
```
int readIntLe()
       throws java.io.IOException
```
    Removes four bytes from this source and returns a little-endian int.
    
    抛出:
    
    java.io.IOException
  - readLong
```
long readLong()
       throws java.io.IOException
```
    Removes eight bytes from this source and returns a big-endian long.
    
    抛出:
    
    java.io.IOException
  - readLongLe
```
long readLongLe()
         throws java.io.IOException
```
    Removes eight bytes from this source and returns a little-endian long.
    
    抛出:
    
    java.io.IOException
  - readDecimalLong
```
long readDecimalLong()
              throws java.io.IOException
```
    Reads a long from this source in signed decimal form (i.e., as a string in base 10 with optional leading '-'). This will iterate until a non-digit character is found.
    
    抛出:
    
    java.lang.NumberFormatException - if the found digits do not fit into a long or a decimal number was not present.
    
    java.io.IOException
  - readHexadecimalUnsignedLong
```
long readHexadecimalUnsignedLong()
                          throws java.io.IOException
```
    Reads a long form this source in hexadecimal form (i.e., as a string in base 16). This will iterate until a non-hexadecimal character is found.
    
    抛出:
    
    java.lang.NumberFormatException - if the found hexadecimal does not fit into a long or hexadecimal was not found.
    
    java.io.IOException
  - skip
```
void skip(long byteCount)
   throws java.io.IOException
```
    Reads and discards byteCount bytes from this source. Throws an EOFException if the source is exhausted before the requested bytes can be skipped.
    
    抛出:
    
    java.io.IOException
  - readByteString
```
ByteString readByteString()
                   throws java.io.IOException
```
    Removes all bytes bytes from this and returns them as a byte string.
    
    抛出:
    
    java.io.IOException
  - readByteString
```
ByteString readByteString(long byteCount)
                   throws java.io.IOException
```
    Removes byteCount bytes from this and returns them as a byte string.
    
    抛出:
    
    java.io.IOException
  - readByteArray
```
byte[] readByteArray()
              throws java.io.IOException
```
    Removes all bytes from this and returns them as a byte array.
    
    抛出:
    
    java.io.IOException
  - readByteArray
```
byte[] readByteArray(long byteCount)
              throws java.io.IOException
```
    Removes byteCount bytes from this and returns them as a byte array.
    
    抛出:
    
    java.io.IOException
  - read
```
int read(byte[] sink)
  throws java.io.IOException
```
    Removes up to sink.length bytes from this and copies them into sink. Returns the number of bytes read, or -1 if this source is exhausted.
    
    抛出:
    
    java.io.IOException
  - readFully
```
void readFully(byte[] sink)
        throws java.io.IOException
```
    Removes exactly sink.length bytes from this and copies them into sink. Throws an EOFException if the requested number of bytes cannot be read.
    
    抛出:
    
    java.io.IOException
  - read
```
int read(byte[] sink,
         int offset,
         int byteCount)
  throws java.io.IOException
```
    Removes up to byteCount bytes from this and copies them into sink at offset. Returns the number of bytes read, or -1 if this source is exhausted.
    
    抛出:
    
    java.io.IOException
  - readFully
```
void readFully(Buffer sink,
               long byteCount)
        throws java.io.IOException
```
    Removes exactly byteCount bytes from this and appends them to sink. Throws an EOFException if the requested number of bytes cannot be read.
    
    抛出:
    
    java.io.IOException
  - readAll
```
long readAll(Sink sink)
      throws java.io.IOException
```
    Removes all bytes from this and appends them to sink. Returns the total number of bytes written to sink which will be 0 if this is exhausted.
    
    抛出:
    
    java.io.IOException
  - readUtf8
```
java.lang.String readUtf8()
                   throws java.io.IOException
```
    Removes all bytes from this, decodes them as UTF-8, and returns the string.
    
    抛出:
    
    java.io.IOException
  - readUtf8
```
java.lang.String readUtf8(long byteCount)
                   throws java.io.IOException
```
    Removes byteCount bytes from this, decodes them as UTF-8, and returns the string.
    
    抛出:
    
    java.io.IOException
  - readUtf8Line
```
java.lang.String readUtf8Line()
                       throws java.io.IOException
```
    Removes and returns characters up to but not including the next line break. A line break is either "\n" or "\r\n"; these characters are not included in the result.
    On the end of the stream this method returns null, just like BufferedReader. If the source doesn't end with a line break then an implicit line break is assumed. Null is returned once the source is exhausted. Use this for human-generated data, where a trailing line break is optional.
    
    抛出:
    
    java.io.IOException
  - readUtf8LineStrict
```
java.lang.String readUtf8LineStrict()
                             throws java.io.IOException
```
    Removes and returns characters up to but not including the next line break. A line break is either "\n" or "\r\n"; these characters are not included in the result.
    On the end of the stream this method throws. Every call must consume either '\r\n' or '\n'. If these characters are absent in the stream, an EOFException is thrown. Use this for machine-generated data where a missing line break implies truncated input.
    
    抛出:
    
    java.io.IOException
  - readUtf8CodePoint
```
int readUtf8CodePoint()
               throws java.io.IOException
```
    Removes and returns a single UTF-8 code point, reading between 1 and 4 bytes as necessary.
    If this source is exhausted before a complete code point can be read, this throws an EOFException and consumes no input.
    If this source doesn't start with a properly-encoded UTF-8 code point, this method will remove 1 or more non-UTF-8 bytes and return the replacement character (U+FFFD). This covers encoding problems (the input is not properly-encoded UTF-8), characters out of range (beyond the 0x10ffff limit of Unicode), code points for UTF-16 surrogates (U+d800..U+dfff) and overlong encodings (such as 0xc080 for the NUL character in modified UTF-8).
    
    抛出:
    
    java.io.IOException
  - readString
```
java.lang.String readString(java.nio.charset.Charset charset)
                     throws java.io.IOException
```
    Removes all bytes from this, decodes them as charset, and returns the string.
    
    抛出:
    
    java.io.IOException
  - readString
```
java.lang.String readString(long byteCount,
                            java.nio.charset.Charset charset)
                     throws java.io.IOException
```
    Removes byteCount bytes from this, decodes them as charset, and returns the string.
    
    抛出:
    
    java.io.IOException
  - indexOf
```
long indexOf(byte b)
      throws java.io.IOException
```
    Returns the index of the first b in the buffer. This expands the buffer as necessary until b is found. This reads an unbounded number of bytes into the buffer. Returns -1 if the stream is exhausted before the requested byte is found.
    
    抛出:
    
    java.io.IOException
  - indexOf
```
long indexOf(byte b,
             long fromIndex)
      throws java.io.IOException
```
    Returns the index of the first b in the buffer at or after fromIndex. This expands the buffer as necessary until b is found. This reads an unbounded number of bytes into the buffer. Returns -1 if the stream is exhausted before the requested byte is found.
    
    抛出:
    
    java.io.IOException
  - indexOf
```
long indexOf(ByteString bytes)
      throws java.io.IOException
```
    Returns the index of the first match for bytes in the buffer. This expands the buffer as necessary until bytes is found. This reads an unbounded number of bytes into the buffer. Returns -1 if the stream is exhausted before the requested bytes are found.
    
    抛出:
    
    java.io.IOException
  - indexOf
```
long indexOf(ByteString bytes,
             long fromIndex)
      throws java.io.IOException
```
    Returns the index of the first match for bytes in the buffer at or after fromIndex. This expands the buffer as necessary until bytes is found. This reads an unbounded number of bytes into the buffer. Returns -1 if the stream is exhausted before the requested bytes are found.
    
    抛出:
    
    java.io.IOException
  - indexOfElement
```
long indexOfElement(ByteString targetBytes)
             throws java.io.IOException
```
    Returns the index of the first byte in targetBytes in the buffer. This expands the buffer as necessary until a target byte is found. This reads an unbounded number of bytes into the buffer. Returns -1 if the stream is exhausted before the requested byte is found.
    
    抛出:
    
    java.io.IOException
  - indexOfElement
```
long indexOfElement(ByteString targetBytes,
                    long fromIndex)
             throws java.io.IOException
```
    Returns the index of the first byte in targetBytes in the buffer at or after fromIndex. This expands the buffer as necessary until a target byte is found. This reads an unbounded number of bytes into the buffer. Returns -1 if the stream is exhausted before the requested byte is found.
    
    抛出:
    
    java.io.IOException
  - inputStream
```
java.io.InputStream inputStream()
```
    Returns an input stream that reads from this source.

接口 BufferedSource

方法概要

从接口继承的方法 com.meizu.cloud.pushsdk.networking.okio.Source

方法详细资料

buffer

exhausted

require

request

readByte

readShort

readShortLe

readInt

readIntLe

readLong

readLongLe

readDecimalLong

readHexadecimalUnsignedLong

skip

readByteString

readByteString

readByteArray

readByteArray

read

readFully

read

readFully

readAll

readUtf8

readUtf8

readUtf8Line

readUtf8LineStrict

readUtf8CodePoint

readString

readString

indexOf

indexOf

indexOf

indexOf

indexOfElement

indexOfElement

inputStream