Destructor.

Gets the buffer.

Returns a pointer to the HBuf holding the filename this object is using. May return a null pointer.

Reads aDes (up to MaxLength) from aPos offset into the buffer

Writes aDes into the buffer at aPos offset, growing the buffer if necessary

Write new data into a file

We write data out to the file in chunks of iBufSegSize, the (segment) size of the buffer. A packet of data is passed to this method in aDes. aDes may or may not take us past the the end of the buffer. If it does, then we write out the buffer then continue filling it up with the rest of aDes. We repeat this until we have used up all of aDes. iBufOffset is the last write position in the file. remaining is the amount of data in aDes yet to be processed, written is the amount of data in aDes that has been processed. iBuffered is the amount of data in iBuf and spare is the amount of free space in the buffer.

                               aDes.Length()
                        <---------------------->
 ------------------------------------------------------------------------
| ...      |xxxxxxxxxxxx|\\\\\\\\\\|//|*************|  ...      |
| ...      |xxxxxxxxxxxx|\\\\\\\\\\|//|*************|  ...      |
 ------------------------------------------------------------------------
0 ...  iBufOffset     aPos                                      ...  this.Length()

                           written    remaining
                         <---------><----------->

                    iBuffered                 spare
            <----------------------><------------------------>

                              iBufSegSize
            <------------------------------------------------>

 Key:
      xxx = data already in buffer
      \\\ = processed data from aDes, copied into iBuf
      // = unprocessed data from aDes, not yet copied into iBuf
 = free space in iBuf

If there is more data remaining than there is spare space in the buffer, then the buffer is filled and written to disk and the remainer of the data is then used to continue filling the buffer.

Allocates and constructs a new OBEX dynamic buffer object, specifying a buffer.

Delete all owned resources in preparation for getting new settings.

Sets a buffer to use the object body data.

Note that the function can leave.

Set object to use aFilename as its data area. Leaves if unable to open file.

Set object to use aFilename as its data area. Leaves if unable to open file. Buffers data into aDataBuf before writing to file. Will not grow the memory buffer, so user can tune buffering behaviour when calling function.

Set object to write to file, using buffering and the specified buffering strategy. Note the size of the buffer passed to this function will determine the size of the second buffer if double buffering is employed.

Writes contents of object to a file

Obex file buffering method.