com.lowagie.text.pdf

Class ByteBuffer


public class ByteBuffer
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 (psoares@consiste.pt)

Field Summary

static byte
ZERO
protected byte[]
buf
The buffer where the bytes are stored.
private static byte[][]
byteCache
private static int
byteCacheSize
private static byte[]
bytes
private static char[]
chars
protected int
count
The count of bytes in the buffer.

Constructor Summary

ByteBuffer()
Creates new ByteBuffer with capacity 128
ByteBuffer(int size)
Creates a byte buffer with a certain capacity.

Method Summary

ByteBuffer
append(String str)
Appends a String to the buffer.
ByteBuffer
append(b[] )
Appends an array of bytes.
ByteBuffer
append(b[] , int off, int len)
Appends the subarray of the byte array.
ByteBuffer
append(byte b)
ByteBuffer
append(char c)
Appends a char to the buffer.
ByteBuffer
append(ByteBuffer buf)
Appends another ByteBuffer to this buffer.
ByteBuffer
append(double d)
Appends a string representation of a double according to the Pdf conventions.
ByteBuffer
append(float i)
Appends a string representation of a float according to the Pdf conventions.
ByteBuffer
append(int i)
Appends the string representation of an int.
ByteBuffer
appendHex(byte b)
ByteBuffer
append_i(int b)
Appends an int.
private static byte[]
convertToBytes(int i)
Converts an double (multiplied by 100 and cast to an int) into an array of bytes.
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, ByteBuffer 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.
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).

Field Details

ZERO

public static byte ZERO

buf

protected byte[] buf
The buffer where the bytes are stored.

byteCache

private static byte[][] byteCache

byteCacheSize

private static int byteCacheSize

bytes

private static final byte[] bytes

chars

private static final char[] chars

count

protected int count
The count of bytes in the buffer.

Constructor Details

ByteBuffer

public ByteBuffer()
Creates new ByteBuffer with capacity 128

ByteBuffer

public ByteBuffer(int size)
Creates a byte buffer with a certain capacity.
Parameters:
size - the initial capacity

Method Details

append

public ByteBuffer 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 ByteBuffer object

append

public ByteBuffer append(b[] )
Appends an array of bytes.
Parameters:
Returns:
a reference to this ByteBuffer object

append

public ByteBuffer append(b[] ,
                         int off,
                         int len)
Appends the subarray of the byte array. The buffer will grow by len bytes.
Parameters:
off - the offset to the start of the array
len - the length of bytes to append
Returns:
a reference to this ByteBuffer object

append

public ByteBuffer append(byte b)

append

public ByteBuffer 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 ByteBuffer object

append

public ByteBuffer append(ByteBuffer buf)
Appends another ByteBuffer to this buffer.
Parameters:
buf - the ByteBuffer to be appended
Returns:
a reference to this ByteBuffer object

append

public ByteBuffer 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 ByteBuffer object

append

public ByteBuffer 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 ByteBuffer object

append

public ByteBuffer append(int i)
Appends the string representation of an int.
Parameters:
i - the int to be appended
Returns:
a reference to this ByteBuffer object

appendHex

public ByteBuffer appendHex(byte b)

append_i

public ByteBuffer 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 ByteBuffer object

convertToBytes

private static byte[] convertToBytes(int i)
Converts an double (multiplied by 100 and cast to an int) into an array of bytes.
Parameters:
i - the int
Returns:
a bytearray

fillCache

public static void fillCache(int decimals)
You can fill the cache in advance if you want to.
Parameters:
decimals -

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,
                                  ByteBuffer buf)
Outputs a double into a format suitable for the PDF.
Parameters:
d - a double
Returns:
the String representation of the double if d is null. If d is not null, then the double is appended directly to the buffer and this methods returns null.

getBuffer

public byte[] getBuffer()

reset

public void reset()
Sets the size to zero.

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

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.

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.

toString

public String toString()
Converts the buffer's contents into a string, translating bytes into characters according to the platform's default character encoding.
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.

write

public void write(byte[] b,
                  int off,
                  int len)

write

public void write(int b)
            throws IOException

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.