# $EPIC: tolower.txt,v 1.3 2006/11/19 04:31:10 jnelson Exp $
======Synopsis:======
$__tolower__(<text>)

======Technical:======
   * This function returns a copy of <text> such that all characters for which isupper(<char>) is true are converted to tolower(<char>).
   * This function uses the "ISO C89" isupper(3) and tolower(3) functions and as such obey your system's LOCALE settings.

======Practical:======
Useful to convert all lowercase characters in a string to lowercase.

======Returns:======
<text> converted to all lowercase letters.

======Examples:======
$tolower(HELLO THERE.)	returns "hello there."

======History:======
This function first appeared in ircII.