namespace TQStringUtils

 get the list of all the placeholders $(xyz)

 Returns a string that does not exist as object name in TDirectory instance
 <dir>. The string is constructed from input string <proposal> and if an object
 with the same name is present in <dir> an increasing integer is appended
 ("_iN") until the name is unique.

 return details on some TObject as a TString

 produce a "status bar" from some pos/max integer fraction
 def is expected to have length 4 (default is "[> ]")
 def[0] is a starting character (default: "[")
 def[1] is a "done" character (default: ">")
 def[2] is a "pending" character (default: " ")
 def[3] is a terminating character (default: "]")

 check if the given string is a valid identifier, that is,
 - contains only the allowed characters
 - having a minimum length of minLength
 - having a maximum length of maxLength

 retrieve the SI suffix corresponding to the given exponent
 special formats include latex, html and unicode

 Returns true if the input string <str> is empty and false otherwise. If
 <allowBlanks> is true the input string is considered empty even if it still
 contains blanks (listed in TQStringUtils::getBlanks()).

 returns true if the input strings are equal

 returns true if the input strings are equal.
 This version starts the comparison from the end which can be faster for long
 strings that are in any case expected to be largely identical at the beginning.

 converts the given string into a valid identifier
 all characters not contained in the set of allowed characters
 are replaced by the given string
the string to return

 converts any type of textual boolean expression into a bool
 values like yes, no, ok, fail, true, false, etc. will be accepted
 result will be returned, success is indicated by value written to second argument

 pass some string through the root interpreter

 converts ROOT color identifiers (kRed, kGreen, ...)
 and rgb hex codes (#xxxxxx)
 to the corresponding integer color identifier

 converts any type of textual boolean expression into a bool
 values like yes, no, ok, fail, true, false, etc. will be accepted

 converts a boolean value to its corresponding string (true or false)

 Returns true if the input string <str> represents a double value or false
 otherwise. Please note: for pure integer values this method returns false, e.g.
 isDouble("4") will evaluate to false while isDouble("4.") and isDouble("4E0")
 will evaluate to true.

 Returns true if the input string <str> represents an integer value or false
 otherwise. Please note: for integer values given in "double notation" false is
 returned, e.g. isInteger("4.") and isInteger("4E0") will evaluate to false.

 Return true if input string <str> represents either a double or an integer
 value. This method is equivalent to "isInteger(str) || isDouble(str)".

 returns true if the given string is a valid boolean expression

 returns the number of edits required to convert str1 to str2

 returns the longest string containing the seed which is a substring of all strings provided.
 Please note that if seed appears multiple times in a string, only the first occurance is considered!

 convenience wrapper in case the removed sequence is not of interest

 checks for substrings of 'longString' which are at least 'minLength'
 characters long and (disjointly) occur multiple times in 'longString',
 removing all but the first occurence. The identified substring is
 additionally stored in the 'removedSequence' parameter.
 In case of ambiguities, i.e., a shorter but more frequently occuring substring
 versus a longer but less frequently occuring substring, the more frequent
 one is treated (given it is at least 'minLength' characters long)

 Tests number <number> with simple condition <test> and returns 1 if the
 condition is fulfilled and 0 otherwise. The syntax of <test> is expected
 to be "<operator> <number>". Supported operators are "==", "!=", ">=", ">",
 "<=", and "<". -1 is returned in case the condition could not be parsed.
 Examples:

 - testNumber(5, "== 5.") returns 1
 - testNumber(4, "> 5.") returns 0
 - testNumber(5, ">> 1") returns -1

 match with logical OR?
loop over individual filter

 Performs a string match between the input string <text> and the string pattern
 <pattern> and returns true in case of a match and false otherwise. The string
 pattern may use wildcards "?" (matching exactly one character) and "*"
 (matching any string sequence).

 Examples:

 - matches("hello", "h?llo") returns true
 - matches("hallo", "h?llo") returns true
 - matches("hello", "h*") returns true
 - matches("hello", "h*a") returns false

 Returns true if the input string <text> contains wildcards "?" or "*" and
 false otherwise.

 Compares the two input strings <a> and <b> and returns 0 in case both strings
 are identical. In case string <a> (<b>) is longer or "greater" than string <b>
 (<a>) 1 (-1) is returned. A string is considered greater than another string
 if the character code at the left most position with non-matching characters
 is larger.

 Examples:
 - compare("a", "a") returns 0
 - compare("a", "b") returns -1
 - compare("ab", "a") returns 1
 - compare("a", "A") returns 1

 Compares the heads of the two input strings <str1> and <str2> and returns the
 length of the longest common string sequence both strings begin with.

 Compares the tails of the two input strings <str1> and <str2> and returns the
 length of the longest common string sequence both strings end with.

 Returns the longest common sequence of all strings (names of objects obtained
 using GetName()) present in input list <strings>.

 Counts the number of occurences of <escChar> in front of <pos> in <text>.
 Returns true if the value is odd and false if it is even.

 Returns a string similar to the input string <text> but removing escape
 characters. The list of characters to escape is given by the input string
 <escapes>.

 Returns a string similar to the input string <text> but inserting escape
 characters where necessary. The list of characters to escape is given by the
 input string <escapes> where the first character is used as the escape
 character to be inserted in the text.

 reduce the first of two strings to the their common prefix
 return the length of this prefix

 concatenate two strings

 concatenate the names of a vector of TObject-derived objects to a single string using the given separator

FIXME: parameter 'trim' is unused. This might lead to wrong expectations of users!
 read and return first token in <text>

 tokenize a string, return the result as a TList
 the list to return

 Appends input string <appendix> to string <text> adding the separator string
 <sep> in case <text> is not an empty string before the operation.

 Returns <text> without trailing blanks.

 Returns <text> without leading and trailing blanks.

 Returns the concatenation of <n> times <text> separated by <sep>.

 Returns a string with <n> spaces.

 Returns a string with <n> tabs.

 retrieve the with of some string in characters
 NOTE: this width is not identical to the the string length,
 since some (unicode) characters and control sequences
 require different amounts of characters in string length and on screen
 NOTE: this function is still under developement
 and will not work for all symbols

 return the index of a given character in a string
 this takes into account control sequences and unicode characters
 please see TQStringUtils::getWidth for details

 expand or shrink the given string to a given width, returning the result
 alignment may be specified as "r", "c" or "l" as the last argument

 expand or shrink the given string to a given width, returning the result
 alignment may be specified as "r", "c" or "l" as the last argument

 expand or shrink the given string to a given width, returning the result
 alignment may be specified as "r", "c" or "l" as the last argument

scan the text and count characters excluding control sequences

 expand or shrink the given string to a given width, returning the result
 alignment may be specified as "r", "c" or "l" as the last argument

 expand or shrink the given string to a given width, returning the result
 returns right aligned text if rightJustified is true, otherwise left aligned

 expand or shrink the given string to a given width, returning the result
 returns right aligned text if rightJustified is true, otherwise left aligned

 trim a string to a maximum length, including the appendix if shortened

convert integer to string

compile result including thousands separators

convert long to string

 creates indentation lines ("||||-") for tree-style console printing

 format a number to a string with the given number of significant digits

 implementing the PDG rounding guidelines
   http://pdg.lbl.gov/2010/reviews/rpp2010-rev-rpp-intro.pdf

 format a number and uncertainty to a string in the given format

 Performs a 'diff' of the two input lists (instances of TList) <l1> and <l2>
 based on the result of the Compare(...) methods on contained objects, prints
 the result on std::cout, and returns true if both lists fully match or false
 otherwise. The print-out is a list of all elements present in either of the two
 lists with matching elements (elements with the same name and present in both
 lists) being printed side-by-side. If <ignoreMatches> == true (default is false)
 only elements present in one list are shown.

 Removes from the head of string <text> all characters listed in <characters>
 (but not more than <nMax>) and returns the number of characters that have been
 removed.

 Removes from the tail of string <text> all characters listed in <characters>
 (but not more than <nMax>) and returns the number of characters that have been
 removed.

 Removes one occurence of string sequence <prefix> from head of string <text>
 if present and returns true in this case and false otherwise.

 Removes one occurence of string sequence <appendix> from tail of string <text>
 if present and returns true in this case and false otherwise.

 Removes up to 'max' occurences of characters contained in chars from text
 starting at the beginning of text. 'max' is ignored if it is negative.

 ensure that a string ends with a given character sequence

 ensure that a string starts with a given character sequence

 Removes leading blanks from head of string <text> (but not more than <nMax>)
 and returns the number of blanks that have been removed. Characters are
 recognized as blanks if listed in TQStringUtils::getBlanks().

 Removes trailing blanks from tail of string <text> (but not more than <nMax>)
 and returns the number of blanks that have been removed. Characters are
 recognized as blanks if listed in TQStringUtils::getBlanks().

 Count and return the number of characters listed in <characters> at head of
 string <text>.

 Count and return the number of characters listed in <characters> at tail of
 string <text>.

 count the occurences of needle in haystack

 remove the unit "[...]" from some label
 returns the unit

 retrieve the unit "[...]" from some label

 remove the unit "[...]" from some label
 returns the result

 removes leading blanks from a string

 removes leading blanks and newlines from a string

 removes leading blanks from a string, counting removed newlines

 Counts the number of leading characters at head of string <in> listed in
 <characters>, moves the corresponding sequence from head of string <in> to
 tail of string <out>, and returns the number of characters that have been
 moved. If <nMax> is non-negative at most <nMax> characters are moved.

 read a token consisting of the given characters and a subsequent block
 the number of characters read from string <in>

 read a parenthesis enclosed block from a string
stop if no valid block or quote definition was given

 read a string up to occurence of some other string

 read a string up to occurence of the first of a set of characters
stop if no valid block or quote definition was given

 read a string up to the occurence of some delimiter

 Writes the lines of strings in list <text> (names of objects obtained using
 GetName()) to external file <filename> or to std::cout in case <filename> is
 an empty string and return true in case of success and false otherwise.

 Read a text file to a single string, ignoring all blacklisted characters
 if replacements are given, characters with odd indices are replaced by their successor

 read an SVG file, returning a data URI string

 Read a text file, line by line, and return the contents as a std::vector

 Read a text file, line by line, and push the contents into a std::vector

 read a histogram definition file, returning a TList of TObjStrings with histogram definitions

 remove enclosing quotes from a string, returning the result

 enclose a string in quotes, returning the result

 remove enclosing quotes from a string, returning the result

 remove enclosing parenthesis from a string, returning the result

 compactify a string, removing all spaces

 compactify a string, removing all double whitespaces

 returns true if the string contains unquoted string literals, false otherwise

 read a data from the given stream, purging c-style comments

 finds the nearest mathing closing parenthesis in a string from a given position assuming that the opening parenthesis is at the given position

 finds the nearest mathing (opening) parenthesis in a string from a given position assuming that the closing parenthesis is at the given position (backwards search)

 finds the nearest mathing closing parenthesis in a string from a given position assuming that the opening parenthesis is at the given position

 finds the nearest mathing (opening) parenthesis in a string from a given position assuming that the closing parenthesis is at the given position (backwards search)

 finds the next "free" occurrence of needle in haystack. Note that this version checks for an exact match of the entire string paropen and parclose

 finds the next "free" occurrence of needle in haystack. This version assumes parentheses to be provides as "()[]{}", i.e. opening followed by closing parenthesis. Needle must be matched exactly.

 reverse-finds the next "free" occurrence of needle in haystack. This version assumes parentheses to be provides as "()[]{}", i.e. opening followed by closing parenthesis. Needle must be matched exactly.

 reverse-finds the next "free" occurrence of needle in haystack. Note that this version checks for an exact match of the entire string paropen and parclose

 finds the next "free" occurrence of any needle in haystack. Note that this version checks for an exact match of the entire string paropen and parclose

 reverse-finds the next "free" occurrence of any needle in haystack. Note that this version checks for an exact match of the entire string paropen and parclose

 find the index of an item in a list, return -1 if not found

 finds the next occurrence of needle in haystack, starting at given position
 if needle is found returns position of the first character of needle

 finds the next occurrence of needle in haystack, starting backwards at given position

 finds the next occurrence of any needle in haystack, starting at given position

 finds the next occurrence of needle in haystack, starting backwards at given position

 see TQStringUtils::findLastOf(const TString& haystack, const TString& needle, int pos)

 finds the next occurrence of anything else than needle in haystack, starting at given position

 finds the next occurrence of anything else than needle in haystack, starting backwards at given position

 see TQStringUtils::findLastNotOf(const TString& haystack, const TString& needle, int pos)

 split a string at all occurrences of the delimiter and return a vector of results

 split a string into little chunks
 This version of the stringsplit function accepts one delimiter
 and respects parenthesis (e.g. does not split in a way that will break parenthesis matches)
 Note that this method treats paropen and parclose at a potentially multi-character opening
 closing substring. To split using a variety of several different pairs of parentheses use
 TQStringUtils::tokenizeVector !

 The opposite method of split. Takes a vector of strings and combines it
 to a single string.

 make an elaborate guess of the formatting of some string
 may return one of html,latex,roottex,unicode,ascii

 convert a string to plain ascii

 convert a string to plain ascii

 convert plain text to LaTeX code
 TODO: implement this function (currently, this is a DUMMY function)

 convert plain text to HTML code
 TODO: implement this function (currently, this is a DUMMY function)

 convert LaTeX symbols to plain text (ASCII or unicode)

 converts LaTeX formattet text to HTML code

 convert HTML code to plain text (ASCII or unicode)
 TODO: implement this function (currently, this is a DUMMY function)

 convert HTML code to LaTeX
 TODO: implement this function (currently, this is a DUMMY function)

 convert ROOTTeX to plain text (ASCII or unicode)
 TODO: implement this function (currently, this is a DUMMY function)

 convert ROOTTeX to plain text (ASCII or unicode)

 convert ROOTTeX to (real) LaTeX

 convert ROOTTeX to HTML code
 TODO: implement this function (currently, this is a DUMMY function)

 convert a string to uppercase

 convert a string to lowercase

 replace all characters in the given string by their unicode superscript variants if possible

 replace all characters in the given string by their unicode superscript variants if possible

 format a string - analog to TString::Format

 concatenate arguments

 format a string - variadic variant of TString::Format
 analog to (private) function TString::FormatImp

 replace all occurences of needle in haystack, as long as they are
 enclosed in characters from the symbols

 retrieve a color definition string for LaTeX
 of the form "\definecolor{<name>}{rgb}{<r>,<g>,<b>}"
 for some predefined color enum

 retrieve a color definition string for LaTeX
 of the form "\definecolor{<name>}{rgb}{<r>,<g>,<b>}"
 for some ROOT TColor

 pad an integer with leading zeros