namespace TQUtils

 Returns true if objects <obj1> and <obj2> are considered equivalent. [not yet
 implemented]

 ensure that the directory for the given file exists

 retrieve the last character in a text file

 check if the given text file has a terminating newline character
 if this is not the case, append a newline at the end

 check if directory <path> exists

 ensure that the directory with the given path exists

 Check whether the file <filename> exists and return true if so,
 and false otherwise

 Check whether the file <filename> exists and return true if so,
 and false otherwise. Works on eos paths.

 check if the file exists and is readable;

 Scans the file system for files whose names match the string pattern <pattern>
 and returns a list (instance of TList) of matching filenames (as instances of
 TObjString).

 Strip all valid branch names from a TString
 and return them in a TObjArray 

Determine if a given number is a valid and finite numerical value

 Determine if a given number is in a given range
   * if a<b, inRange(x,a,b) will return true if a<=x<=b, else false
   * if a>b, inRange(x,a,b) will return false if a<x<b, else true

 returns the current time in milliseconds since 01 Jan 1970, 0:00

 return the current time formatted according to the given string

 convert an x-coordinate (horizontal)
 from user to NDC coordinates
 using the current pad

 convert an y-coordinate (vertical)
 from user to NDC coordinates
 using the current pad

 convert an x-coordinate (horizontal)
 from user to absolute (pixel) coordinates
 using the current pad

 convert an y-coordinate (vertical)
 from user to absolute (pixel) coordinates
 using the current pad

 convert an x-coordinate (horizontal)
 from NDC to user coordinates
 using the current pad

 convert an y-coordinate (vertical)
 from NDC to user coordinates
 using the current pad

 convert an x-distance (horizontal)
 from user to NDC coordinates
 using the current pad

 convert an y-distance (vertical)
 from user to NDC coordinates
 using the current pad

 convert an x-distance (horizontal)
 from user to absolute (pixel) coordinates
 using the current pad

 convert an y-distance (vertical)
 from user to absolute (pixel) coordinates
 using the current pad

 convert an x-distance (horizontal)
 from NDC to user coordinates
 using the current pad

 convert an y-distance (vertical)
 from NDC to user coordinates
 using the current pad

returns unbiased sample variance 1/(n-1)*sum (x_i-x)^2

returns unbiased sample covariance 1/(n-1)*sum (x_i-x)^2

 Calculates the average order of magnitude of the matrix entries through log10(value).
 If value is zero, the order of magnitude is assumed to be zero.
 This version does not round at any step.

 Calculates the average order of magnitude of the matrix entries through log10(value).
 If value is zero, the order of magnitude is assumed to be zero.
 This version rounds down to the next integer at each step (i.e. at each log10(value) as well as for the average)

 execute the commmand, returning a TList containing lines of output it produced

 return the full valid path of a file residing on EOS, given the filename and a base folder
 returns empty string if no match found

 return the full valid path of a local file, given the filename and a base folder
 returns empty string if no match found

 return the full valid path of a file at any location, given the filename and a list of base folders
 returns empty string if no match found

 return the full valid path of a file, given the filename and a list of base folders
 returns empty string if no match found

 return the full valid path of a file, given the filename and a list of base folders
 returns empty string if no match found

 return a list of files matching the expression
 if used on local files, the output is equivalent to bash "ls"

 this function also supports remote file systems
 - for EOS, please make sure that TQLibrary knows about
 the location of the "eos.select" binary
 if not properly detected by the Makefile, this can be
 edited by calling TQLibrary::getQLibary()->setEOScmd("...")
 please prefix EOS paths with "root://"
 - for Grid dCache, please make sure that TQLibrary knows about
 * the name of the local group disk
 set with TQLibary::getQLibrary()->setLocalGroupDisk("...")
 * a dq2 suite (default "dq2")
 set with TQLibary::getQLibrary()->setDQ2cmd("...")
 * if necessary, path head replacements. Set with
 TQLibrary::getQLibrary()->setDQ2Head() for the old head to be removed
 TQLibrary::getQLibrary()->setdCacheHead() for the new head to be prepended
 all of these values can be set in a "locals.h" defintion file, for example, put
 #define LOCALGROUPDISK "UNI-FREIBURG_LOCALGROUPDISK"
 #define DQ2PATHHEAD "srm://se.bfg.uni-freiburg.de"
 #define DCACHEPATHHEAD "dcap://se.bfg.uni-freiburg.de:22125"
 please prefix dataset expressions with "dCache:"

 return a full list of all files in the given location on EOS
 please make sure that TQLibrary knows about the location of the
 binary "eos.select".
 if not properly detected by the Makefile, this can be
 edited by calling TQLibrary::getQLibary()->setEOScmd("...")

 return a full list of all files locally available in the dCache
 the dataset and localGroupDisk names are forwarded to dq2-ls
 the dq2-command can be set as optional parameter (use, e.g. 'dq2' or 'rucio')
 if oldHead and newHead are given, the resulting path head will be exchanged accordingly

 execute an "ls" command locally and return the result as a TList

 the identifier is formatted "filename:objectname"
 retrieves a list of all objects in the given file
 that have a key matching the given class
 and object name pattern (may contain wildcards)

 retrieves a list of all objects in the given file
 that have a key matching the given class
 and object name pattern (may contain wildcards)

 retrieves a list of all objects in the given directory
 that have a key matching the given class
 and object name pattern (may contain wildcards)
 Wildcard matching is disabled, if the given name contains a slash (/). In
 this case the given name is used directory in root_file->Get(..), which
 means that the TTrees can be stored in TDirectories.

 retrieves a list of sets of tags written in a file
 tags written in a single line are put together a set, i.e. one TQTaggable
 optionally provide a dictionary for $(placeholder)'s

 retrieves a list of sets of tags written in a file
 tags written in a single line are put together a set, i.e. one TQTaggable
 optionally provide a dictionary for $(placeholder)'s

 print the branches of a tree in a nice format

 print the active branches of a tree in a nice format

 evaluate an expression on a specific event of a TTree

 evaluate an expression on all events of a TTree and return the sum

 retrieve the initial sum of weights from the event bookkeepers in this tree
 thanks to a dirty hack, this also works in standalone mode

 retrieve the initial sum of weights from the cut bookkeepers in this file

 retrieve the initial sum of weights from the cut bookkeepers in this file

 retrieve the initial number of events from the cut bookkeepers in this file

 retrieve the list of TQFolders contained in a given file
 if the class type is given, only TQFolder instances
 of the given class type are considered

 append all TQfolders contained in a given file to a list
 if the class type is given, only TQFolder instances
 of the given class type are considered

 retrieve the list of names of TQFolders contained in a given file
 if the class type is given, only TQFolder instances
 of the given class type are considered

 append all names of TQFolders contained in a given file to a list
 if the class type is given, only TQFolder instances
 of the given class type are considered
 the prefix is prepended to every single name

 round some double to a number of significant digits

 round down some double to a number of significant digits

 round up some double to a number of significant digits

 round some double to a number of digits

 round down some double to a number of digits

 round up some double to a number of digits

 retrieve the MD5 sum (hex value) of some file as a TString

 retrieve the MD5 sum (hex value) of some local file as a TString

 retrieve the MD5 sum (hex value) of some EOS file as a TString

 return the modification date of a TFile as a TString

 reads an env var specified by the first argument and returns its value as
 a boolean. If the env var is not found or cannot be safely interpreted as
 a boolean then fallback is returned.

to be moved to TQStringUtils