ByteBufferOutputStream (iText 7

java.lang.Object
- java.io.OutputStream
- - com.itextpdf.kernel.pdf.ByteBufferOutputStream

All Implemented Interfaces:

Closeable, Flushable, AutoCloseable
```
public class ByteBufferOutputStream
extends OutputStream
```
Acts like a StringBuffer but works with byte arrays. Floating point is converted to a format suitable to the PDF.

Author:

Paulo Soares

Field Summary

Fields
Modifier and Type	Field and Description
`protected byte[]`	`buf` The buffer where the bytes are stored.
`protected int`	`count` The count of bytes in the buffer.
`static boolean`	`HIGH_PRECISION` If `true` always output floating point numbers with 6 decimal digits.
`static byte`	`ZERO`

Constructor Summary

Constructors
Constructor and Description
`ByteBufferOutputStream()` Creates new ByteBufferOutputStream with capacity 128
`ByteBufferOutputStream(int size)` Creates a byte buffer with a certain capacity.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`ByteBufferOutputStream`	`append_i(int b)` Appends an `int`.
`ByteBufferOutputStream`	`append(byte b)`
`ByteBufferOutputStream`	`append(byte[] b)` Appends an array of bytes.
`ByteBufferOutputStream`	`append(byte[] b, int off, int len)` Appends the subarray of the `byte` array.
`ByteBufferOutputStream`	`append(ByteBufferOutputStream buf)` Appends another `ByteBufferOutputStream` to this buffer.
`ByteBufferOutputStream`	`append(char c)` Appends a `char` to the buffer.
`ByteBufferOutputStream`	`append(double d)` Appends a string representation of a `double` according to the Pdf conventions.
`ByteBufferOutputStream`	`append(float i)` Appends a string representation of a `float` according to the Pdf conventions.
`ByteBufferOutputStream`	`append(int i)` Appends the string representation of an `int`.
`ByteBufferOutputStream`	`append(long i)` Appends the string representation of a `long`.
`ByteBufferOutputStream`	`append(String str)` Appends a `String` to the buffer.
`ByteBufferOutputStream`	`appendHex(byte b)`
`static void`	`fillCache(int decimals)` You can fill the cache in advance if you want to.
`static String`	`formatDouble(double d)` Outputs a `double` into a format suitable for the PDF.
`static String`	`formatDouble(double d, ByteBufferOutputStream buf)` Outputs a `double` into a format suitable for the PDF.
`byte[]`	`getBuffer()`
`void`	`reset()` Sets the size to zero.
`static void`	`setCacheSize(int size)` Sets the cache size.
`void`	`setSize(int size)`
`int`	`size()` Returns the current size of the buffer.
`byte[]`	`toByteArray()` Creates a newly allocated byte array.
`String`	`toString()` Converts the buffer's contents into a string, translating bytes into characters according to the platform's default character encoding.
`String`	`toString(String enc)` Converts the buffer's contents into a string, translating bytes into characters according to the specified character encoding.
`void`	`write(byte[] b, int off, int len)`
`void`	`write(int b)`
`void`	`writeTo(OutputStream out)` Writes the complete contents of this byte buffer output to the specified output stream argument, as if by calling the output stream's write method using `out.write(buf, 0, count)`.

Methods inherited from class java.io.OutputStream
close, flush, write

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Field Detail
  - count
```
protected int count
```
    The count of bytes in the buffer.
  - buf
```
protected byte[] buf
```
    The buffer where the bytes are stored.
  - ZERO
```
public static final byte ZERO
```
    See Also:
    
    Constant Field Values
  - HIGH_PRECISION
```
public static boolean HIGH_PRECISION
```
    If true always output floating point numbers with 6 decimal digits. If false uses the faster, although less precise, representation.
- Constructor Detail
  - ByteBufferOutputStream
```
public ByteBufferOutputStream()
```
    Creates new ByteBufferOutputStream with capacity 128
  - ByteBufferOutputStream
```
public ByteBufferOutputStream(int size)
```
    Creates a byte buffer with a certain capacity.
    
    Parameters:
    
    size - the initial capacity
- Method Detail
  - setCacheSize
```
public static void setCacheSize(int size)
```
    Sets the cache size.
    This can only be used to increment the size. If the size that is passed through is smaller than the current size, nothing happens.
    
    Parameters:
    
    size - the size of the cache
  - fillCache
```
public static void fillCache(int decimals)
```
    You can fill the cache in advance if you want to.
    
    Parameters:
    
    decimals -
  - append_i
```
public ByteBufferOutputStream append_i(int b)
```
    Appends an int. The size of the array will grow by one.
    
    Parameters:
    
    b - the int to be appended
    
    Returns:
    
    a reference to this ByteBufferOutputStream object
  - append
```
public ByteBufferOutputStream append(byte[] b,
                                     int off,
                                     int len)
```
    Appends the subarray of the byte array. The buffer will grow by len bytes.
    
    Parameters:
    
    b - the array to be appended
    
    off - the offset to the start of the array
    
    len - the length of bytes to append
    
    Returns:
    
    a reference to this ByteBufferOutputStream object
  - append
```
public ByteBufferOutputStream append(byte[] b)
```
    Appends an array of bytes.
    
    Parameters:
    
    b - the array to be appended
    
    Returns:
    
    a reference to this ByteBufferOutputStream object
  - append
```
public ByteBufferOutputStream append(String str)
```
    Appends a String to the buffer. The String is converted according to the encoding ISO-8859-1.
    
    Parameters:
    
    str - the String to be appended
    
    Returns:
    
    a reference to this ByteBufferOutputStream object
  - append
```
public ByteBufferOutputStream append(char c)
```
    Appends a char to the buffer. The char is converted according to the encoding ISO-8859-1.
    
    Parameters:
    
    c - the char to be appended
    
    Returns:
    
    a reference to this ByteBufferOutputStream object
  - append
```
public ByteBufferOutputStream append(ByteBufferOutputStream buf)
```
    Appends another ByteBufferOutputStream to this buffer.
    
    Parameters:
    
    buf - the ByteBufferOutputStream to be appended
    
    Returns:
    
    a reference to this ByteBufferOutputStream object
  - append
```
public ByteBufferOutputStream append(int i)
```
    Appends the string representation of an int.
    
    Parameters:
    
    i - the int to be appended
    
    Returns:
    
    a reference to this ByteBufferOutputStream object
  - append
```
public ByteBufferOutputStream append(long i)
```
    Appends the string representation of a long.
    
    Parameters:
    
    i - the long to be appended
    
    Returns:
    
    a reference to this ByteBufferOutputStream object
  - append
```
public ByteBufferOutputStream append(byte b)
```
  - appendHex
```
public ByteBufferOutputStream appendHex(byte b)
```
  - append
```
public ByteBufferOutputStream append(float i)
```
    Appends a string representation of a float according to the Pdf conventions.
    
    Parameters:
    
    i - the float to be appended
    
    Returns:
    
    a reference to this ByteBufferOutputStream object
  - append
```
public ByteBufferOutputStream append(double d)
```
    Appends a string representation of a double according to the Pdf conventions.
    
    Parameters:
    
    d - the double to be appended
    
    Returns:
    
    a reference to this ByteBufferOutputStream object
  - formatDouble
```
public static String formatDouble(double d)
```
    Outputs a double into a format suitable for the PDF.
    
    Parameters:
    
    d - a double
    
    Returns:
    
    the String representation of the double
  - formatDouble
```
public static String formatDouble(double d,
                                  ByteBufferOutputStream buf)
```
    Outputs a double into a format suitable for the PDF.
    
    Parameters:
    
    d - a double
    
    buf - a ByteBufferOutputStream
    
    Returns:
    
    the String representation of the double if buf is null. If buf is not null, then the double is appended directly to the buffer and this methods returns null.
  - reset
```
public void reset()
```
    Sets the size to zero.
  - toByteArray
```
public byte[] toByteArray()
```
    Creates a newly allocated byte array. Its size is the current size of this output stream and the valid contents of the buffer have been copied into it.
    
    Returns:
    
    the current contents of this output stream, as a byte array.
  - size
```
public int size()
```
    Returns the current size of the buffer.
    
    Returns:
    
    the value of the count field, which is the number of valid bytes in this byte buffer.
  - setSize
```
public void setSize(int size)
```
  - toString
```
public String toString()
```
    Converts the buffer's contents into a string, translating bytes into characters according to the platform's default character encoding.
    
    Overrides:
    
    toString in class Object
    
    Returns:
    
    String translated from the buffer's contents.
  - toString
```
public String toString(String enc)
                throws UnsupportedEncodingException
```
    Converts the buffer's contents into a string, translating bytes into characters according to the specified character encoding.
    
    Parameters:
    
    enc - a character-encoding name.
    
    Returns:
    
    String translated from the buffer's contents.
    
    Throws:
    
    UnsupportedEncodingException - If the named encoding is not supported.
  - writeTo
```
public void writeTo(OutputStream out)
             throws IOException
```
    Writes the complete contents of this byte buffer output to the specified output stream argument, as if by calling the output stream's write method using out.write(buf, 0, count).
    
    Parameters:
    
    out - the output stream to which to write the data.
    
    Throws:
    
    IOException - if an I/O error occurs.
  - write
```
public void write(int b)
           throws IOException
```
    Specified by:
    
    write in class OutputStream
    
    Throws:
    
    IOException
  - write
```
public void write(byte[] b,
                  int off,
                  int len)
```
    Overrides:
    
    write in class OutputStream
  - getBuffer
```
public byte[] getBuffer()
```

Class ByteBufferOutputStream

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.io.OutputStream

Methods inherited from class java.lang.Object

Field Detail

count

buf

ZERO

HIGH_PRECISION

Constructor Detail

ByteBufferOutputStream

ByteBufferOutputStream

Method Detail

setCacheSize

fillCache

append_i

append

append

append

append

append

append

append

append

appendHex

append

append

formatDouble

formatDouble

reset

toByteArray

size

setSize

toString

toString

writeTo

write

write

getBuffer