/* --------------------------------
** FUNCTION:
**   fnReverseString 
** DESCRIPTION:
**   This function reverses the order of each character
**   in a specified text string
** DEPENDENCIES:
** SEE ALSO:
**   fnTrimSpaceFromString etc
** DATE:
** 
   -------------------------------- */

function fnReverseString(sString) 
{

  if (sString == null)
  {
    //-->-->-->-->-->-->-->-->-->-->-->-->
    //-- write out some nasty error message
    //-- somewhere, mortally insulting the programmer
    //-- for such a ridiculous error
    return -1;
  }

  var iLength           = sString.length;
  var sReturn           = new String("");

  for (var ii = iLength; ii > -1; ii--)
  {
    cCurrentCharacter = sString.substring(ii, ii + 1);
    sReturn += cCurrentCharacter;
  } //--for

  return sReturn;
} //-- fnReverseString()