code: public void writeTo (@Nonnull final byte [] aBuf,
                         @Nonnegative final int nOfs,
                         @Nonnegative final int nLen,
                         final boolean bCompactBuffer)
    {
      ValueEnforcer.isArrayOfsLen (aBuf, nOfs, nLen);
  
      m_aBuffer.flip ();
      m_aBuffer.get (aBuf, nOfs, nLen);
      if (bCompactBuffer)
        m_aBuffer.compact ();
    }
docs: Write current content to the passed byte array. The copied elements are
  removed from this streams buffer.
  
  @param aBuf
  Byte array to write to. May not be <code>null</code>.
  @param nOfs
  Offset to start writing. Must be &ge; 0.
  @param nLen
  Number of bytes to copy. Must be &ge; 0.
  @param bCompactBuffer
  <code>true</code> to compact the buffer afterwards,
  <code>false</code> otherwise.