class TDataSetIter: public TObject

to be documented

to be documented

to be documented

 return a fake pointer == -1 casted to (TDataSet *)

Add - adds the set to the dataset defined with the second parameters

TDataSet dataset != 0 - Add the set to the TDataSet *dataset

= 0 - (by default) to the current TDataSet defined
with fWorkingDataSet data member

returns  the pointer to set is success or ZERO poiner


Note: If this TDataSetIter is empty (i.e. Cwd() returns 0), the "set"
becomes the "root" dataset of this iterator                        //

Add

Char_t path != 0 - Add a TDataSet dataset to the TDataSet dataset
defined with "path"
= 0 - (by default) to the current TDataSet defined
with fWorkingDataSet data member

returns the dataset is success or ZERO pointer

TDataSet *TDataSetIter::Cd(const Char_t *dirname)

Change the current working directory to dirname

Returns the pointer to the new "working" TDataSet
=======   0,  if the new directory doesn't exist.

Remark:  The name = ".." has a special meaning.
------   TDataSetIter::Cd("..") returns the parent set
But one still can not use ".." as a legal part
of the full path

TDataSet *TDataSetIter::Cd(const TDataSet *ds)

Make:  Cwd() = ds;
 Look for the first occurence of the "ds" pointer for the current
TDataSet in respect of the Cwd() if any

Change the current working directory to ds if present

Returns the pointer to the new "working" TDataSet (i.e. ds)
=======   0,  if the new directory doesn't exist.

 Print the names of the TDataSet objects for the datatset named with "dirname"
 apart of TDataSet::Ls()  this method prints one level only

 summarize dataset usage by Herb Ward proposal

to be documented

to be documented

 FindDataSet looks for the object with the name supplied across dataset.

 name        - the "base" name title (with no path) of the TDataSet (see: opt = -t)
 path        - path to start the search from (the current dataset "by default")
 opt = "-i"  - case insensitive search
       "-t"  - first <name> parameter defines the object "title" rather the object "name"

 Note: If the name provided is not unique
       the first found is returned.

 Check whether the object does belong the TDataSet defined with "path"
 opt = "-l"  - check the "reference" links only
       "-s"  - check the "structural" links only
             = "by default" - checks all links

 This method is not recommended.
 It is done to back TObject::FindObject method only.
 One is recommnened to use FindByName method instead.

 This method is not recommended.
 It is done to back TObject::FindObject method only.
 One is recommended to use FindByName method instead.

 Check whether the object does belong the TDataSet defined with "path"
 opt = "-l"  - check the "reference" links only
       "-s"  - check the "structural" links only
             = "by default" - checks all links

to be documented

to be documented

   Ls(const Char_t *dirname,Option_t)

   Prints the list of the TDataSet defined with dirname

   dirname     = 0   - prints the current dataset
   dirname[0]  = '/' - print TDataSet defined with dirname
   dirname[0] != '/' - prints DataSet with respect of the current class

   Ls(const Char_t *dirname,Int_t depth)

   Prints the list of the TDataSet defined with dirname
   Returns the dataset defined by "path" or Cwd();

   dirname     = 0   - prints the current dataset
   dirname[0]  = '/' - print TDataSet defined with dirname
   dirname[0] != '/' - prints DataSet with respect of the current class

   depth       = 0   - print all level of the TDataSet defined with dirname
               > 0   - print depth levels at most of the dirname TDataSet

to be documented

  Notify(TDataSet *dataset)

  This dummy method is called when TDataSetIter::Find dives in "dataset"
  to look for thew next level of the dataset's
  printf("void TDataSetIter::Notify(TDataSet *) level: %d %s\n",fDepth,ds->GetName());

  Remove the TDataSet *dataset from the current dataset
  If the current dataset is the deleted dataset the its parent
  becomes the "current dataset" or 0 if this dataset has no parent.

  returns: the "current dataset" pointer

 returns the pointer the "next" TDataSet object
         = 0 if all objects have been returned.

  mode = kContinue  - default normal mode
         kPrune     - stop passing of the current branch but continue with the next one if any
         kUp        - break passing, return to the previous level, then continue
         all other  - are treated as "kContinue"

to be documented

 Pick the next object of the  level provided

to be documented

titleFlag = kFALSE; use object name as key (by default)
kTRUE;  use object title as key  and ignore mkdirFlag

"path" ::= <relative path> | <absolute path> | <empty>

"relative path" ::= <dataset name> | <dataset name>/<dataset name>

"absolute path" ::= /<relative path>
"empty"         ::= zero pointer | pointer to zero length string

"relative path": the search is done against of fWorkingDataSet data mem
"absolute path": the search is done against of fRootDataSet    data mem
"empty path"   : no search is done just next TDataSet is returned if any

Remark: This version can not treat any "special name" like "..", ".", etc

 TDataSet *l != 0 means the new start pointer
    depth      != 0 means the new value for the depth
                    otherwise the privious one is used;

Shunt - moves the set to the dataset defined with the second parameters

TDataSet dataset != 0 - Add the set to the TDataSet *dataset

= 0 - (by default) to the current TDataSet defined
with fWorkingDataSet data member

returns  the pointer to set if successful or ZERO pointer


Note: If this TDataSetIter is empty (i.e. Cwd() returns 0), the "set"
becomes the "root" dataset of this iterator                        //

Shunt

Char_t path != 0 - Move a TDataSet dataset from its parent to
the TDataSet dataset
defined with "path"
= 0 - (by default) to the current TDataSet defined
with fWorkingDataSet data member

returns the dataset is success or ZERO pointer

 operator [] returns the pointer to the TDataSet if it does contain
 any data (TTable for example)

  Input:
     path  = The path to the dataset to find

  Output:
     pointer to the dataset if it found and
     its TDataSet::HasData() method returns non-zero
     (see for example TTable::HasData() )