code: public void writeTo (@Nonnull final byte [] aBuf, final boolean bCompactBuffer)
    {
      ValueEnforcer.notNull (aBuf, "Buffer");
  
      writeTo (aBuf, 0, aBuf.length, bCompactBuffer);
    }
docs: Writes the current content to the passed buffer. The copied elements are
  removed from this streams buffer.
  
  @param aBuf
  The buffer to be filled. May not be <code>null</code>.
  @param bCompactBuffer
  <code>true</code> to compact the buffer afterwards,
  <code>false</code> otherwise.