class TTable: public TDataSet

 protected: create a new TTableDescriptor descriptor for this table

 AsString represents the value provided via "void *b" with type defined
          by "name"

   void *buf  - the pointer to the value to be printed out.
        type  - the basic data type for the value above
       width  - the number of psotion to be used to print the value out

return table type name

 Returns a pointer to the i-th row of the table

 CopyRows copies nRows from starting from the srcRow of srcTable
 to the dstRow in this table upto nRows or by the end of this table.

 This table if automaticaly increased if expand = kTRUE.
 The old values of this table rows are to be destroyed and
 replaced with the new ones.

 PARAMETERS:
   srcTable - a pointer to the table "donor"
   srcRow   - the index of the first row of the table donor to copy from
   dstRow   - the index of the first row of this table to copy to
   nRows    - the total number of rows to be copied. This table will be expanded
              as needed if expand = kTRUE (it is kFALSE "by default")
          = 0 to copy ALL remain rows from the srcTable.
   expand   - flag whether this table should reallocated if needed.

 RETURN:
          the number of the rows been copied

 Delete one or several rows from the table

  Int_t indx  - index of the first row to be deleted
  Int_t nRows - the total number of rows to be deleted
              = 1 "by default

*-*-*-*-*-*Draw expression varexp for specified entries
*-*                  ===========================================

   This function accepts TCut objects as arguments.
   Useful to use the string operator +
         example:
            table.Draw("x",cut1+cut2+cut3);

   TCutG object with "CUTG" name can be created via the graphics editor.

*-*-*-*-*-*Draw expression varexp for specified entries
*-*                  ===========================================

  varexp is an expression of the general form e1:e2:e3
    where e1,etc is a C++ expression referencing a combination of the TTable columns
          One can use two extra meta variable "i$" and "n$" along with the table
          column names.
          i$ is to involve the current row number
          n$ refers the total num,ber of rows of this table provided by TTable::GetNRows()

  Example:
     varexp = x     simplest case: draw a 1-Dim distribution of column named x
            = sqrt(x)            : draw distribution of sqrt(x)
            = x*y/z
            = y:sqrt(x) 2-Dim dsitribution of y versus sqrt(x)
            = i$:sqrt(x) 2-Dim dsitribution of i versus sqrt(x[i])
            = phep[0]:sqrt(phep[3]) 2-Dim dsitribution of phep[0] versus sqrt(phep[3])

  Note that the variables e1, e2 or e3 may contain a boolean expression as well.
  example, if e1= x*(y<0), the value histogrammed will be x if y<0
  and will be 0 otherwise.

  selection is a C++ expression with a combination of the columns.
  The value corresponding to the selection expression is used as a weight
  to fill the histogram.
  If the expression includes only boolean operations, the result
  is 0 or 1. If the result is 0, the histogram is not filled.
  In general, the expression may be of the form:

      value*(boolean expression)

  if boolean expression is true, the histogram is filled with
  a weight = value.
  Examples:
      selection1 = "x<y && sqrt(z)>3.2 && 6 < i$ && i$ < n$"
      selection2 = "(x+y)*(sqrt(z)>3.2"
      selection3 = "signal*(log(signal)>1.2)"
  selection1 returns a weigth = 0 or 1
  selection2 returns a weight = x+y if sqrt(z)>3.2
             returns a weight = 0 otherwise.
  selection3 returns a weight = signal if log(signal)>1.2

  option is the drawing option
      see TH1::Draw for the list of all drawing options.
      If option contains the string "goff", no graphics is generated.

  nentries is the number of entries to process (default is all)
  first is the first entry to process (default is 0)

     Saving the result of Draw to an histogram

  By default the temporary histogram created is called htemp.
  If varexp0 contains >>hnew (following the variable(s) name(s),
  the new histogram created is called hnew and it is kept in the current
  directory.
  Example:
    tree.Draw("sqrt(x)>>hsqrt","y>0")
    will draw sqrt(x) and save the histogram as "hsqrt" in the current
    directory.

  By default, the specified histogram is reset.
  To continue to append data to an existing histogram, use "+" in front
  of the histogram name;
    table.Draw("sqrt(x)>>+hsqrt","y>0")
      will not reset hsqrt, but will continue filling.

     Making a Profile histogram

  In case of a 2-Dim expression, one can generate a TProfile histogram
  instead of a TH2F histogram by specyfying option=prof or option=profs.
  The option=prof is automatically selected in case of y:x>>pf
  where pf is an existing TProfile histogram.

     Saving the result of Draw to a TEventList

  TTable::Draw can be used to fill a TEventList object (list of entry numbers)
  instead of histogramming one variable.
  If varexp0 has the form >>elist , a TEventList object named "elist"
  is created in the current directory. elist will contain the list
  of entry numbers satisfying the current selection.
  Example:
    tree.Draw(">>yplus","y>0")
    will create a TEventList object named "yplus" in the current directory.
    In an interactive session, one can type (after TTable::Draw)
       yplus.Print("all")
    to print the list of entry numbers in the list.

  By default, the specified entry list is reset.
  To continue to append data to an existing list, use "+" in front
  of the list name;
    table.Draw(">>+yplus","y>0")
      will not reset yplus, but will enter the selected entries at the end
      of the existing list.

 EntryLoop creates a CINT bytecode to evaluate the given expressions for
 all table rows in loop and fill the appropriated histograms.

 Solution for Byte code
 From: Masaharu Goto <MXJ02154@nifty.ne.jp>
 To: <fine@bnl.gov>
 Cc: <rootdev@hpsalo.cern.ch>
 Sent: 13-th august 1999 year  23:01

  action =  1  Fill 1-D histogram obj
         =  2  Fill 2-D histogram obj
         =  3  Fill 3-D histogram obj
         =  4  Fill Profile histogram obj
         =  5  Fill a TEventlist
         = 11  Estimate Limits
         = 12  Fill 2-D PolyMarker obj
         = 13  Fill 3-D PolyMarker obj
  action < 0   Evaluate Limits for case abs(action)

  Load file

 Default TTable ctor.

 Create TTable object and set array size to n longs.

 Create TTable object and initialize it with values of array.

 Create TTable object and initialize it with values of array.

 Copy constructor.

 TTable assignment operator.
 This operator REALLOCATEs this table to fit the number of
 the USED rows of the source table if any

 Delete TTable object.

 Adopt array arr into TTable, i.e. don't copy arr but use it directly
 in TTable. User may not delete arr, TTable dtor will do it.

 Add        the "row" at the GetNRows() position, and
 reallocate the table if neccesary,               and
 return     the row index the "row" has occupied.

 row == 0 see method TTable::AddAt(const void *row, Int_t i)

 Add    one element ("row") of structure at position "i".
 Check  for out of bounds.

        If the row == 0 the "i" cell is still occupied and
 filled with the pattern "ff"

 Copy the C-structure src into the new location
 the length of the strucutre is defined by this class descriptor

to be documented

 Get a comment from the table descriptor

 Append nRows row of the array "row" to the table
 return
    - the new table size (# of table rows)
    - 0 if the object doesn't own the internal array and can not expand it

 void InsertRows(cons void *row, Long_t indx, UInt_t nRows)

 Insert one or several rows into the table at "indx" position
 The rest table stuff is shifted down

  cons void    - a pointer to the array of rows to be inserted
  Long_t indx =  The position these rows will be inserted to
  Int_t nRows  - the total number of rows to be inserted
                 = 1 "by default
  return:
  The number of the rows has been shifted to accomodate
  the new rows.

 Reallocate this table leaving only (used rows)+1 allocated
 GetTableSize() = GetNRows() + 1
 returns a pointer to the first row of the reallocated table
 Note:
 The table is reallocated if it is an owner of the internal array

 Reallocate this table leaving only <newsize> allocated
 GetTableSize() = newsize;
 returns a pointer to the first row of the reallocated table
 Note:
 The table is reallocated if it is an owner of the internal array

 The table is reallocated if it is an owner of the internal array

 Allocate a space for the new table, if any
 Sleep for a while if space is not available and try again

 Wrap each table coulumn with TColumnView object to browse.

 Deletes the internal array of this class
 if this object does own its internal table

 Delete the internal array and free the memory it occupied
 if this object did own this array

 Then perform TDataSet::Delete(opt)

to be documented

 Returns the number of the used rows for the wrapped table

 Returns the size (in bytes) of one table row

 Returns the number of the allocated rows

Fit a projected item(s) from a TTable*-
*-*              =======================================

  formula is a TF1 expression.

  See TTable::Draw for explanations of the other parameters.

  By default the temporary histogram created is called htemp.
  If varexp contains >>hnew , the new histogram created is called hnew
  and it is kept in the current directory.
  Example:
    table.Fit(pol4,"sqrt(x)>>hsqrt","y>0")
    will fit sqrt(x) and save the histogram as "hsqrt" in the current
    directory.

Returns the type of the wrapped C-structure kept as the TNamed title

 return Folder flag to be used by TBrowse object
 The table is a folder if
  - it has sub-dataset
    or
  - GetNRows > 0

 return the total number of the NaN for float/double cells of this table
 Thanks Victor Perevoztchikov

 This static method creates a new TTable object if provided

 Generate an out-of-bounds error. Always returns false.

 Create IDL table defintion (to be used for XDF I/O)

 Print general table inforamtion

const Char_t *TTable::Print(Int_t row, Int_t rownumber, const Char_t *colfirst, const Char_t *collast) const

  Print the contents of internal table per COLUMN.

  row       - the index of the first row to print (counting from ZERO)
  rownumber - the total number of rows to print out (=10 by default)

  (No use !) Char_t *colfirst, *collast - the names of the first/last
                                          to print out (not implemented yet)


 Check bounds and adjust it

to be documented

-*-*Make a projection of a TTable using selections
*-*              =============================================

   Depending on the value of varexp (described in Draw) a 1-D,2-D,etc
   projection of the TTable will be filled in histogram hname.
   Note that the dimension of hname must match with the dimension of varexp.

 Shrink the table to free the unused but still allocated rows

   Save a primitive as a C++ statement(s) on output stream "out".

 Set array size of TTable object to n longs. If n<0 leave array unchanged.

to be documented

to be documented

 Create CINT macro to evaluate the user-provided expresssion
 Expression may contains:
   -  the table columen names
   - 2 meta names: i$ - the current column index,
                   n$ - the total table size provided by TTable::GetNRows() method

 return the name of temporary file with the current expressions

 Fill the entire table with byte "c" ;
     c=0 "be default"

 Clean all filled columns with the pointers to TTableMap
 if any
  wipe = kTRUE - delete all object the Map's point to
         kFALSE - zero pointer, do not call "delete" though

 Set array size of TTable object to n longs and copy array.
 If n<0 leave array unchanged.

 Stream an object of class TTable.

 Read "table parameters first"

to be documented

to be documented

to be documented

to be documented

 Stream an array of the "plain" C-structures

to be documented

 Kill the table current data
 and adopt those from set

 Query the TClass instance for the C-stucture dicitonary
 This method is to be used  with TableImp CPP macro (see $ROOTSYS/table/inc/Ttypes.h

   ULong_t   &operator(){ return GetTable();}