Public Member Functions | |
| abstract void | write (byte value) throws IOException |
| abstract void | write (byte[] value, int offset, int length) throws IOException |
| abstract void | writeLazy (byte[] value, int offset, int length) throws IOException |
| abstract void | write (ByteBuffer value) throws IOException |
| abstract void | writeLazy (ByteBuffer value) throws IOException |
Detailed Description
An output target for raw bytes. This interface provides semantics that support two types of writing:
Traditional write operations: (as defined by java.io.OutputStream) where the target method is responsible for either copying the data or completing the write before returning from the method call.
Lazy write operations: where the caller guarantees that it will never modify the provided buffer and it can therefore be considered immutable. The target method is free to maintain a reference to the buffer beyond the scope of the method call (e.g. until the write operation completes).
Member Function Documentation
◆ write() [1/3]
|
abstract |
Writes a single byte.
- Parameters
-
value the byte to be written
- Exceptions
-
IOException thrown if an error occurred while writing
◆ write() [2/3]
|
abstract |
Writes a sequence of bytes. The ByteOutput must copy
if it will not be processed prior to the return of this method call, since
may be reused/altered by the caller.
NOTE: This method MUST NOT modify the
. Doing so is a programming error and will lead to data corruption which will be difficult to debug.
- Parameters
-
value the bytes to be written offset the offset of the start of the writable range length the number of bytes to write starting from
- Exceptions
-
IOException thrown if an error occurred while writing
◆ write() [3/3]
|
abstract |
Writes a sequence of bytes. The ByteOutput must copy
if it will not be processed prior to the return of this method call, since
may be reused/altered by the caller.
NOTE: This method MUST NOT modify the
. Doing so is a programming error and will lead to data corruption which will be difficult to debug.
- Parameters
-
value the bytes to be written. Upon returning from this call, the of this buffer will be set to the limit
- Exceptions
-
IOException thrown if an error occurred while writing
◆ writeLazy() [1/2]
|
abstract |
Writes a sequence of bytes. The ByteOutput is free to retain a reference to the value beyond the scope of this method call (e.g. write later) since it is considered immutable and is guaranteed not to change by the caller.
NOTE: This method MUST NOT modify the
. Doing so is a programming error and will lead to data corruption which will be difficult to debug.
- Parameters
-
value the bytes to be written offset the offset of the start of the writable range length the number of bytes to write starting from
- Exceptions
-
IOException thrown if an error occurred while writing
◆ writeLazy() [2/2]
|
abstract |
Writes a sequence of bytes. The ByteOutput is free to retain a reference to the value beyond the scope of this method call (e.g. write later) since it is considered immutable and is guaranteed not to change by the caller.
NOTE: This method MUST NOT modify the
. Doing so is a programming error and will lead to data corruption which will be difficult to debug.
- Parameters
-
value the bytes to be written. Upon returning from this call, the of this buffer will be set to the limit
- Exceptions
-
IOException thrown if an error occurred while writing
The documentation for this class was generated from the following file:
- Source/ThirdParty/libwebrtc/Source/third_party/protobuf/java/core/src/main/java/com/google/protobuf/ByteOutput.java
