Util Module

# Util Module Introduction

The Util module provides some generally-useful routines that are more suitable for writing in Qore than in C++.

To use this module, use `"%requires Util"` in your code.

All the public symbols in the module are defined in the Util namespace

Functions:

- Util::compare_version()
- Util::flatten()
- Util::get_byte_size()
- Util::get_exception_string()
- Util::get_marketing_byte_size()
- Util::get_random_string()
- Util::glob_to_regex()
- Util::is_int()
- Util::is_float()
- Util::is_number()
- Util::lpad()
- Util::make_uri_query()
- Util::normalize_dir()
  - Util::normalize_dir_unix()
  - Util::normalize_dir_windows()
- Util::ordinal()
- Util::parse_to_qore_value()
- Util::parse_uri_query()
- Util::plural()
- Util::regex_escape()
- Util::rpad()
- Util::same()
- Util::slice()
- Util::tmp_location()
- Util::uniq()
- Util::zip()

# Release Notes

## Util 1.3

- updated for complex types
- added the make_uri_query() function
- added the parse_uri_query() function
- added the UriQueryInfo hashdecl
- added the flatten() function
- added the uniq() function

## Util 1.2

- the following functions are now actually implemented in the Qore library and only reexported here for backwards-compatibility:
  - Qore::absolute_path()
  - Qore::absolute_path_windows()
  - Qore::absolute_path_unix()
- added Util::glob_to_regex()
- added Util::is_int()
- added Util::is_float()
- added Util::is_number()
- added Util::lpad()
- added Util::ordinal()
- added Util::plural()
- added Util::regex_escape()
- added Util::rpad()
- added Util::same()
- added Util::slice()
- added Util::tmp_location()
- added Util::zip()
- fixed Util::get_random_string() on Windows
- fixed Util::absolute_path_windows()
- fixed Util::parse_to_qore_value() with hashes with a comma in the first key name; now respects parentheses when parsing lists and hashes (issue 846)
- fixed Util::normalize_dir_windows() handling of UNC paths (issue 813)

## Util 1.1

- added the Util::get_byte_size() and Util::get_marketing_byte_size() functions

## Util 1.0

- the initial version of the Util module