class HAscii: public TObject

 Default constructor. It resets all data and sets pointers to NULL.

 Destructor releases memory allocated dynamically.

 Function called while opening file error happened to correct file name.

 It checks if file of given name is not already opened.

 It checks if the error has happened during write opetarion.

 Resetting data of file (in write mode).

 Setting separator for data units (only space, tabulation '\t' or comma allowed).

 Getting current separator character for data units.

 Checking if file in write mode is opened (and closing it if yes)
 in case you want to open a new file in write mode.

 Opening ASCII file with given 'filename' and 'mode'.

  Modes available:
  "read" or "in"
   - read mode (it is default). Unlimited number of files
     can be opened in read mode.
  "new" or "out" or "create" or "write"
   - write mode. A new file is created but only if there is
     no file with the same 'filename' existing. Only one file
     can be opened in write mode at the same time.
  "update"
   - opens existing file for writing at the end of it (to append data).
  "recreate" or "overwrite"
   - creates a new file or replaces existing in write mode.

 It opens and reads ASCII file with the list of files and opens all of them.
 The file with file list must be in the following syntax:
 section - 'ASCIIFileList'
 keyword - 'Files', followed by string containing all file names (and
 optionally mode), separated by commas.

 Example of file containing list of files to be opened:

  [ASCII File List]
  ; you may put commentaries, as well

  Files = mdcinit.txt, richpads.txt read,
  \ showercal_data.dat,
  \ tofcal.txt read , /scratch/tofini.dat

 Closing file of given filename or all opened files if no filename specified.

 Pointer to active file (that file which contains active section).

 Pointer to active section.

 It checks if a new section name is  unambiguous with relation
 to previously stored while initializing next section list.

 Additional checking and if necessary reinitialization of section list, now not used.

 Function for section selection. Before reading any data active
 section has to be chosen.

 It resets variables holding keyword information
 like name, length, data string, commentary string.

 Resetting data bank and bank id.

 Checking if section is selected.

 Checking if keyword just read has any data.

 It checks whether the call for next data unit of keyword just read
 is of the same type as while keyword reading (this is when
 calling for data without keyword specified but with type
 specified and then it is assumed to read data of last keyword read.

 Checking if pos is not larger than number of data units;
 in case of string there is always only 1 unit.

 It returns keyword just read (active keyword).

 Returning of commentary to the last read keyword if there was any.

 Getting string data from data bank if they are present there.

 Reading data of given keyword key as string.

 Reading data of given keyword key in section sec as string.

 It returns commentary to the active section if there is any.

 Setting number of digits (characters) in one line to which
 writing of ASCII line will be formatted. Default is 16.

 Number of units (digits, characters) to which written an ASCII line
 will be formatted.

 Checking if file in write mode is opened.

 Returns kTRUE if any file in read mode is opened.

 Returns kTRUE if a file in write mode is currently opened.

 Writing ASCII line text with given length linelen taking into
 consideration that the first line may follow keyword of given length keylen.

 Writing remark text starting line from sing # or ; (default)
 with a line of length linelen.

 Writing section name, brackets [ ] are added automatically.

 Copying (writing) section sec if there is any.

 Testing if in given section starting from position fReadAllPosition
 there is any keyword to be read. It is used in case of sequential data
 reading to control the loop and to stop if there are no more keywords
 to be read (i.e. we achieved the end of the section).

 Reading keyword name and keyword data as string from ASCII file.
 If keyword is not specified the sequential reading is done. Reading
 starts then from position fReadAllPosition and every next call of this
 function makes reading of next keyword (with data) until the end of section.
 If you want to read the section sequentially again you nedd to set it
 again as active section (and then fReadAllPosition is resetted).

 Conversion of string of data stored in fpDataLine to units of Int_t type.

 Conversion of string of data stored in fpDataLine to units of Float_t type.

 Conversion of string of data stored in fpDataLine to units of Char_t type.
 Char_t unit is a single Char_t separated in string by white space or comma.

 Conversion of string of data stored in fpDataLine to string unit.
 If string begins and ends with quotation marks they are removed.
 String unit is a set of characters terminated by '\0'.