##############################################################################
###+---------+################################################################
#+-| LOWER() |-------------------------------------+##########################
#| +---------+ Converts all uppercase to lowercase |##########################
#+-------------------------------------------------+##########################
##############################################################################
##############################################################################
#+--| Summary |----------------+##############################################
#|     #INCLUDE string.hdr     |##############################################
#+-----------------------------+##############################################
##############################################################################
##############################################################################
#+--| Syntax |----------------------------------+#############################
#|     FUNCTION CHAR lower PROTOTYPE            |#############################
#|      PARAMETERS CONST CHAR source_string     |#############################
#+----------------------------------------------+#############################
##############################################################################
##############################################################################
###############+---| Description |-----------------------------+##############
###############| The lower() function converts all uppercase   |##############
###############| characters within source_string to lowercase. |##############
###############+-----------------------------------------------+##############
##############################################################################
##############################################################################
#########+--| Example 1 |-------------------------------------------+#########
#########| *    Notice digits are unaffected.                       |#########
#########|                                                          |#########
#########| ? lower(" Dr. Georgia Wiesner 1234")                     |#########
#########|                                                          |#########
#########|     Output: dr. georgia wiesner                          |#########
#########+----------------------------------------------------------+#########
##############################################################################
##############################################################################
#########+--| Example 2 |-------------------------------------------+#########
#########| *    Use lower() to convert a string to a "common"       |#########
#########| *    form for easy processing.  This eliminates the      |#########
#########| *    worry about whether an operator typed "John" or     |#########
#########| *    "JOHN"                                              |#########
#########|                                                          |#########
#########| INDEXDEF                                                 |#########
#########|     CHAR(20)    nameind    lower( n->first )             |#########
#########| ENDDEF                                                   |#########
#########|                                                          |#########
#########|     {...}                                                |#########
#########|     INDEX nameind                                        |#########
#########+----------------------------------------------------------+#########
##############################################################################