code: public void writeTo (@Nonnull @WillNotClose final OutputStream aOS, final boolean bClearBuffer) throws IOException
    {
      ValueEnforcer.notNull (aOS, "OutputStream");
  
      aOS.write (m_aBuffer.array (), m_aBuffer.arrayOffset (), m_aBuffer.position ());
      if (bClearBuffer)
        m_aBuffer.clear ();
    }
docs: Write everything to the passed output stream and optionally clear the
  contained buffer. This works only if the contained ByteBuffer has a backing
  array.
  
  @param aOS
  The output stream to write to. May not be <code>null</code>.
  @param bClearBuffer
  <code>true</code> to clear the buffer, <code>false</code> to not do
  it. If <code>false</code> you may call {@link #reset()} to clear it
  manually afterwards.
  @throws IOException
  In case of IO error