/* --------------------------------
** FUNCTION:
**   fnReverseOrderList
** DESCRIPTION:
**   This function reverses the order of all the
**   elements of a string list and returns the result
**   as a new string.
** DEPENDENCIES:
**   none.
** DATE:
** 
   -------------------------------- */

function fnReverseOrderList(sList, sDivisor)
{
  var sReturn = new String("");
  var aaReturn = new Array("");
  var aaTemp = new Array();

  if (sList == null)
  {
    //-->-->-->-->-->-->-->-->-->-->-->-->
    //-- Explode some error process
    //--
    return -1;
  } //-- if string list is null

  if (sDivisor == null)
    { sDivisor = "\n"; }

  var aaTemp = sList.split(sDivisor);

  var jj = 0;
  for (var ii = aaTemp.length - 1; ii > -1; ii--)
  {
    aaReturn[jj] = aaTemp[ii];
    jj++;
  }

  for (var ii = 0; ii < aaReturn.length; ii++)
  {
    sReturn += aaReturn[ii] + sDivisor;
  }
  return sReturn;

} //-- fnReverseOrderList