org.codehaus.jackson.util
Class TextBuffer

TextBuffer is a class similar to StringBuffer, with
following differences:

TextBuffer uses segments character arrays, to avoid having
to do additional array copies when array is not big enough.
This means that only reallocating that is necessary is done only once:
if and when caller
wants to access contents in a linear array (char[], String).

TextBuffer can also be initialized in "shared mode", in which
it will just act as a wrapper to a single char array managed
by another object (like parser that owns it)

TextBuffer

releaseBuffers

public void releaseBuffers()

Method called to indicate that the underlying buffers should now
be recycled if they haven't yet been recycled. Although caller
can still use this text buffer, it is not advisable to call this
method if that is likely, since next time a buffer is needed,
buffers need to reallocated.
Note: calling this method automatically also clears contents
of the buffer.

resetWithEmpty

public void resetWithEmpty()

Method called to clear out any content text buffer may have, and
initializes buffer to use non-shared data.

resetWithShared

public void resetWithShared(char[] buf,
int start,
int len)

Method called to initialize the buffer with a shared copy of data;
this means that buffer will just have pointers to actual data. It
also means that if anything is to be appended to the buffer, it
will first have to unshare it (make a local copy).