class TBufferFile: public TBuffer

 Create an I/O buffer object. Mode should be either TBuffer::kRead or
 TBuffer::kWrite. By default the I/O buffer has a size of
 TBuffer::kInitialSize (1024) bytes.

 Create an I/O buffer object. Mode should be either TBuffer::kRead or
 TBuffer::kWrite.

 Create an I/O buffer object. Mode should be either TBuffer::kRead or
 TBuffer::kWrite. By default the I/O buffer has a size of
 TBuffer::kInitialSize (1024) bytes. An external buffer can be passed
 to TBuffer via the buf argument. By default this buffer will be adopted
 unless adopt is false.
 If the new buffer is _not_ adopted and no memory allocation routine
 is provided, a Fatal error will be issued if the Buffer attempts to
 expand.

 Delete an I/O buffer object.

 Return the version number of the owner file.

 Increment level.

 Decrement level.

 Push a new data cache area onto the list of area to be used for
 temporarily store 'missing' data members.

 Return the 'current' data cache area from the list of area to be used for
 temporarily store 'missing' data members.

 Pop and Return the 'current' data cache area from the list of area to be used for
 temporarily store 'missing' data members.

 Read Long from TBuffer.

 Read string from TBuffer.

 Write string to TBuffer.

 Set byte count at position cntpos in the buffer. Generate warning if
 count larger than kMaxMapCount. The count is excluded its own size.

 Check byte count with current buffer position. They should
 match. If not print warning and position buffer in correct
 place determined by the byte count. Startpos is position of
 first byte where the byte count is written in buffer.
 Returns 0 if everything is ok, otherwise the bytecount offset
 (< 0 when read too little, >0 when read too much).

 Check byte count with current buffer position. They should
 match. If not print warning and position buffer in correct
 place determined by the byte count. Startpos is position of
 first byte where the byte count is written in buffer.
 Returns 0 if everything is ok, otherwise the bytecount offset
 (< 0 when read too little, >0 when read too much).

 Check byte count with current buffer position. They should
 match. If not print warning and position buffer in correct
 place determined by the byte count. Startpos is position of
 first byte where the byte count is written in buffer.
 Returns 0 if everything is ok, otherwise the bytecount offset
 (< 0 when read too little, >0 when read too much).

 Read a Float16_t from the buffer,
 see comments about Float16_t encoding at TBufferFile::WriteFloat16().

 Read a Double32_t from the buffer,
 see comments about Double32_t encoding at TBufferFile::WriteDouble32().

 write a Float16_t to the buffer.
 The following cases are supported for streaming a Float16_t type
 depending on the range declaration in the comment field of the data member:
  A-    Float16_t     fNormal;
  B-    Float16_t     fTemperature; //[0,100]
  C-    Float16_t     fCharge;      //[-1,1,2]
  D-    Float16_t     fVertex[3];   //[-30,30,10]
  E-    Float16_t     fChi2;        //[0,0,6]
  F-    Int_t          fNsp;
        Float16_t*    fPointValue;   //[fNsp][0,3]

 In case A fNormal is converted from a Float_t to a Float_t with mantissa truncated to 12 bits
 In case B fTemperature is converted to a 32 bit unsigned integer
 In case C fCharge is converted to a 2 bits unsigned integer
 In case D the array elements of fVertex are converted to an unsigned 10 bits integer
 In case E fChi2 is converted to a Float_t with truncated precision at 6 bits
 In case F the fNsp elements of array fPointvalue are converted to an unsigned 32 bit integer
           Note that the range specifier must follow the dimension specifier.
 the case B has more precision (9 to 10 significative digits than case A (6 to 7 digits).

 The range specifier has the general format: [xmin,xmax] or [xmin,xmax,nbits]
  [0,1]
  [-10,100];
  [-pi,pi], [-pi/2,pi/4],[-2pi,2*pi]
  [-10,100,16]
  [0,0,8]
 if nbits is not specified, or nbits <2 or nbits>16 it is set to 16
 if (xmin==0 and xmax==0 and nbits <=14) the float word will have
 its mantissa truncated to nbits significative bits.

 IMPORTANT NOTE

 --NOTE 1
 Lets assume an original variable float x:
 When using the format [0,0,8] (ie range not specified) you get the best
 relative precision when storing and reading back the truncated x, say xt.
 The variance of (x-xt)/x will be better than when specifying a range
 for the same number of bits. However the precision relative to the
 range (x-xt)/(xmax-xmin) will be worst, and vice-versa.
 The format [0,0,8] is also interesting when the range of x is infinite
 or unknown.

 --NOTE 2
 It is important to understand the difference with the meaning of nbits
  -in case of [-1,1,nbits], nbits is the total number of bits used to make
    the conversion from a float to an integer
  -in case of [0,0,nbits], nbits is the number of bits used for the mantissa

  see example of use of the Float16_t data type in tutorial double32.C

 write a Double32_t to the buffer.
 The following cases are supported for streaming a Double32_t type
 depending on the range declaration in the comment field of the data member:
  A-    Double32_t     fNormal;
  B-    Double32_t     fTemperature; //[0,100]
  C-    Double32_t     fCharge;      //[-1,1,2]
  D-    Double32_t     fVertex[3];   //[-30,30,10]
  E-    Double32_t     fChi2;        //[0,0,6]
  F-    Int_t          fNsp;
        Double32_t*    fPointValue;   //[fNsp][0,3]

 In case A fNormal is converted from a Double_t to a Float_t
 In case B fTemperature is converted to a 32 bit unsigned integer
 In case C fCharge is converted to a 2 bits unsigned integer
 In case D the array elements of fVertex are converted to an unsigned 10 bits integer
 In case E fChi2 is converted to a Float_t with mantissa truncated precision at 6 bits
 In case F the fNsp elements of array fPointvalue are converted to an unsigned 32 bit integer
           Note that the range specifier must follow the dimension specifier.
 the case B has more precision (9 to 10 significative digits than case A (6 to 7 digits).

 The range specifier has the general format: [xmin,xmax] or [xmin,xmax,nbits]
  [0,1]
  [-10,100];
  [-pi,pi], [-pi/2,pi/4],[-2pi,2*pi]
  [-10,100,16]
  [0,0,8]
 if nbits is not specified, or nbits <2 or nbits>32 it is set to 32
 if (xmin==0 and xmax==0 and nbits <=14) the double word will be converted
 to a float and its mantissa truncated to nbits significative bits.

 IMPORTANT NOTEs

 --NOTE 1
 Lets assume an original variable double x:
 When using the format [0,0,8] (ie range not specified) you get the best
 relative precision when storing and reading back the truncated x, say xt.
 The variance of (x-xt)/x will be better than when specifying a range
 for the same number of bits. However the precision relative to the
 range (x-xt)/(xmax-xmin) will be worst, and vice-versa.
 The format [0,0,8] is also interesting when the range of x is infinite
 or unknown.

 --NOTE 2
 It is important to understand the difference with the meaning of nbits
  -in case of [-1,1,nbits], nbits is the total number of bits used to make
    the conversion from a double to an integer
  -in case of [0,0,nbits], nbits is the number of bits used for the mantissa

  see example of use of the Double32_t data type in tutorial double32.C

 Read array of bools from the I/O buffer. Returns the number of
 bools read. If argument is a 0 pointer then space will be
 allocated for the array.

 Read array of characters from the I/O buffer. Returns the number of
 characters read. If argument is a 0 pointer then space will be
 allocated for the array.

 Read array of shorts from the I/O buffer. Returns the number of shorts
 read. If argument is a 0 pointer then space will be allocated for the
 array.

 Read array of ints from the I/O buffer. Returns the number of ints
 read. If argument is a 0 pointer then space will be allocated for the
 array.

 Read array of longs from the I/O buffer. Returns the number of longs
 read. If argument is a 0 pointer then space will be allocated for the
 array.

 Read array of long longs from the I/O buffer. Returns the number of
 long longs read. If argument is a 0 pointer then space will be
 allocated for the array.

 Read array of floats from the I/O buffer. Returns the number of floats
 read. If argument is a 0 pointer then space will be allocated for the
 array.

 Read array of doubles from the I/O buffer. Returns the number of doubles
 read. If argument is a 0 pointer then space will be allocated for the
 array.

 Read array of floats (written as truncated float) from the I/O buffer.
 Returns the number of floats read.
 If argument is a 0 pointer then space will be allocated for the array.
 see comments about Float16_t encoding at TBufferFile::WriteFloat16

 Read array of doubles (written as float) from the I/O buffer.
 Returns the number of doubles read.
 If argument is a 0 pointer then space will be allocated for the array.
 see comments about Double32_t encoding at TBufferFile::WriteDouble32

 Read array of bools from the I/O buffer. Returns the number of bools
 read.

 Read array of characters from the I/O buffer. Returns the number of
 characters read.

 Read array of shorts from the I/O buffer. Returns the number of shorts
 read.

 Read array of ints from the I/O buffer. Returns the number of ints
 read.

 Read array of longs from the I/O buffer. Returns the number of longs
 read.

 Read array of long longs from the I/O buffer. Returns the number of
 long longs read.

 Read array of floats from the I/O buffer. Returns the number of floats
 read.

 Read array of doubles from the I/O buffer. Returns the number of doubles
 read.

 Read array of floats (written as truncated float) from the I/O buffer.
 Returns the number of floats read.
 see comments about Float16_t encoding at TBufferFile::WriteFloat16

 Read array of doubles (written as float) from the I/O buffer.
 Returns the number of doubles read.
 see comments about Double32_t encoding at TBufferFile::WriteDouble32

 Read array of n bools from the I/O buffer.

 Read array of n characters from the I/O buffer.

 Read array of n characters from the I/O buffer.

 Read array of n shorts from the I/O buffer.

 Read array of n ints from the I/O buffer.

 Read array of n longs from the I/O buffer.

 Read array of n long longs from the I/O buffer.

 Read array of n floats from the I/O buffer.

 Read array of n doubles from the I/O buffer.

 Read array of n floats (written as truncated float) from the I/O buffer.
 see comments about Float16_t encoding at TBufferFile::WriteFloat16

 Read array of n doubles (written as float) from the I/O buffer.
 see comments about Double32_t encoding at TBufferFile::WriteDouble32

 Read an array of 'n' objects from the I/O buffer.
 Stores the objects read starting at the address 'start'.
 The objects in the array are assume to be of class 'cl'.

 Read an array of 'n' objects from the I/O buffer.
 The objects read are stored starting at the address '*start'
 The objects in the array are assumed to be of class 'cl' or a derived class.
 'mode' indicates whether the data member is marked with '->'

 Write array of n bools into the I/O buffer.

 Write array of n characters into the I/O buffer.

 Write array of n shorts into the I/O buffer.

 Write array of n ints into the I/O buffer.

 Write array of n longs into the I/O buffer.

 Write array of n unsigned longs into the I/O buffer.
 This is an explicit case for unsigned longs since signed longs
 have a special tobuf().

 Write array of n long longs into the I/O buffer.

 Write array of n floats into the I/O buffer.

 Write array of n doubles into the I/O buffer.

 Write array of n floats (as truncated float) into the I/O buffer.
 see comments about Float16_t encoding at TBufferFile::WriteFloat16

 Write array of n doubles (as float) into the I/O buffer.
 see comments about Double32_t encoding at TBufferFile::WriteDouble32

 Write array of n bools into the I/O buffer.

 Write array of n characters into the I/O buffer.

 Write array of n characters into the I/O buffer.

 Write array of n shorts into the I/O buffer.

 Write array of n ints into the I/O buffer.

 Write array of n longs into the I/O buffer.

 Write array of n unsigned longs into the I/O buffer.
 This is an explicit case for unsigned longs since signed longs
 have a special tobuf().

 Write array of n long longs into the I/O buffer.

 Write array of n floats into the I/O buffer.

 Write array of n doubles into the I/O buffer.

 Write array of n floats (as truncated float) into the I/O buffer.
 see comments about Float16_t encoding at TBufferFile::WriteFloat16

 Write array of n doubles (as float) into the I/O buffer.
 see comments about Double32_t encoding at TBufferFile::WriteDouble32

 Write an array of object starting at the address 'start' and of length 'n'
 the objects in the array are assumed to be of class 'cl'

 Write an array of object starting at the address '*start' and of length 'n'
 the objects in the array are of class 'cl'
 'isPreAlloc' indicates whether the data member is marked with '->'
 Return:
  0: success
  2: truncated success (i.e actual class is missing. Only ptrClass saved.)

 Read object from I/O buffer. clReq is NOT used.
 The value returned is the address of the actual start in memory of
 the object. Note that if the actual class of the object does not
 inherit first from TObject, the type of the pointer is NOT 'TObject*'.
 [More accurately, the class needs to start with the TObject part, for
 the pointer to be a real TObject*].
 We recommend using ReadObjectAny instead of ReadObject

 Skip any kind of object from buffer

 Read object from I/O buffer.
 A typical use for this function is:
    MyClass *ptr = (MyClass*)b.ReadObjectAny(MyClass::Class());
 I.e. clCast should point to a TClass object describing the class pointed
 to by your pointer.
 In case of multiple inheritance, the return value might not be the
 real beginning of the object in memory.  You will need to use a
 dynamic_cast later if you need to retrieve it.

 Write object to I/O buffer.

 Write object to I/O buffer.
 This function assumes that the value of 'actualObjectStart' is the actual start of
 the object of class 'actualClass'

 Write object to I/O buffer.
 This function assumes that the value in 'obj' is the value stored in
 a pointer to a "ptrClass". The actual type of the object pointed to
 can be any class derived from "ptrClass".
 Return:
  0: failure
  1: success
  2: truncated success (i.e actual class is missing. Only ptrClass saved.)

 Read class definition from I/O buffer. clReq can be used to cross check
 if the actually read object is of the requested class. objTag is
 set in case the object is a reference to an already read object.

 Write class description to I/O buffer.

 Read class version from I/O buffer.

 Write class version to I/O buffer.

 Write class version to I/O buffer after setting the kStreamedMemberWise
 bit in the version number.

 Stream an object given its C++ typeinfo information.

 Stream an object given the name of its actual class.

 Stream an object given a pointer to its actual class.

 Stream an object inheriting from TObject using its streamer.

 Check if offset is not too large (< kMaxMapCount) when writing.

 Check for object in the read map. If the object is 0 it still has to be
 read. Try to read it from the buffer starting at location offset. If the
 object is -1 then it really does not exist and we return 0. If the object
 exists just return the offset.

 Check if the specified object is already in the buffer.
 Returns kTRUE if object already in the buffer, kFALSE otherwise
 (also if obj is 0 or TBuffer not in writing mode).

 Check if the specified object of the specified class is already in
 the buffer. Returns kTRUE if object already in the buffer,
 kFALSE otherwise (also if obj is 0 ).

 This offset is used when a key (or basket) is transfered from one
 file to the other.  In this case the TRef and TObject might have stored a
 pid index (to retrieve TProcessIDs) which refered to their order on the original
 file, the fPidOffset is to be added to those values to correctly find the
 TProcessID.  This fPidOffset needs to be increment if the key/basket is copied
 and need to be zero for new key/basket.

 Retrieve the object stored in the buffer's object map at 'tag'
 Set ptr and ClassPtr respectively to the address of the object and
 a pointer to its TClass.

 Add object to the fMap container.
 If obj is not 0 add object to the map (in read mode also add 0 objects to
 the map). This method may only be called outside this class just before
 calling obj->Streamer() to prevent self reference of obj, in case obj
 contains (via via) a pointer to itself. In that case offset must be 1
 (default value for offset).

 Add object to the fMap container.
 If obj is not 0 add object to the map (in read mode also add 0 objects to
 the map). This method may only be called outside this class just before
 calling obj->Streamer() to prevent self reference of obj, in case obj
 contains (via via) a pointer to itself. In that case offset must be 1
 (default value for offset).

 Set the initial size of the map used to store object and class
 references during reading. The default size is kMapSize=503.
 Increasing the default has the benefit that when reading many
 small objects the map does not need to be resized too often
 (the system is always dynamic, even with the default everything
 will work, only the initial resizing will cost some time).
 This method can only be called directly after the creation of
 the TBuffer, before any reading is done. Globally this option
 can be changed using SetGlobalReadParam().

 Set the initial size of the hashtable used to store object and class
 references during writing. The default size is kMapSize=503.
 Increasing the default has the benefit that when writing many
 small objects the hashtable does not get too many collisions
 (the system is always dynamic, even with the default everything
 will work, only a large number of collisions will cost performance).
 For optimal performance hashsize should always be a prime.
 This method can only be called directly after the creation of
 the TBuffer, before any writing is done. Globally this option
 can be changed using SetGlobalWriteParam().

 Create the fMap container and initialize them
 with the null object.

 Delete existing fMap and reset map counter.

 Read max bytes from the I/O buffer into buf. The function returns
 the actual number of bytes read.

 Write max bytes from buf into the I/O buffer.

 Read string from I/O buffer. String is read till 0 character is
 found or till max-1 characters are read (i.e. string s has max
 bytes allocated). If max = -1 no check on number of character is
 made, reading continues till 0 character is found.

 Write string to I/O buffer. Writes string upto and including the
 terminating 0.

 Return the last TProcessID in the file.

 The TProcessID with number pidf is read from file.
 If the object is not already entered in the gROOT list, it is added.

 Return the exec id stored in the current TStreamerInfo element.
 The execid has been saved in the unique id of the TStreamerElement
 being read by TStreamerElement::Streamer.
 The current element (fgElement) is set as a static global
 by TStreamerInfo::ReadBuffer (Clones) when reading this TRef.

 Check if the ProcessID pid is already in the file.
 If not, add it and return the index number in the local file list.

 force writing the TStreamerInfo to the file

 Make sure TStreamerInfo is not optimized, otherwise it will not be
 possible to support schema evolution in read mode.
 In case the StreamerInfo has already been computed and optimized,
 one must disable the option BypassStreamer.

 Interface to TStreamerInfo::ReadBufferClones.

 Interface to TStreamerInfo::WriteBufferClones.

 Read emulated class.

 Deserialize information from a buffer into an object.

 Note: This function is called by the xxx::Streamer()
       functions in rootcint-generated dictionaries.
   // This function assumes that the class version and the byte count
 information have been read.

   version  is the version number of the class
   start    is the starting position in the buffer b
   count    is the number of bytes for this object in the buffer

 Deserialize information from a buffer into an object.

 Note: This function is called by the xxx::Streamer()
       functions in rootcint-generated dictionaries.

 Function called by the Streamer functions to serialize object at p
 to buffer b. The optional argument info may be specified to give an
 alternative StreamerInfo instead of using the default StreamerInfo
 automatically built from the class definition.
 For more information, see class TStreamerInfo.

 Set the initial size of the map used to store object and class
 references during reading. The default size is kMapSize=503.
 Increasing the default has the benefit that when reading many
 small objects the array does not need to be resized too often
 (the system is always dynamic, even with the default everything
 will work, only the initial resizing will cost some time).
 Per TBuffer object this option can be changed using SetReadParam().

 Set the initial size of the hashtable used to store object and class
 references during writing. The default size is kMapSize=503.
 Increasing the default has the benefit that when writing many
 small objects the hashtable does not get too many collisions
 (the system is always dynamic, even with the default everything
 will work, only a large number of collisions will cost performance).
 For optimal performance hashsize should always be a prime.
 Per TBuffer object this option can be changed using SetWriteParam().

 Get default read map size.

 Get default write map size.

 Default ctor

 TBuffer objects cannot be copied or assigned

 See comment in TBuffer::SetPidOffset