/* --------------------------------
** FUNCTION:
**   fnTailArray
** DESCRIPTION:
**   This function returns the last specified number
**   of elements from an array as a new array
**   reference.
** DEPENDENCIES:
** DATE:
** 
   -------------------------------- */

function fnTailArray(aaArray, iLength)
{
  var aaReturn = new Array();

  //-- Validate function parameters
  if (aaArray == null)
  {
    //-->-->-->-->-->-->-->-->-->-->-->-->
    //-- Explode some error process

    document.write(
      "ERROR: .... \n");
    return -1;
  } //-- if array null

  if (iLength == null)
    { iLength = 1; }

  if (iLength > aaArray.length)
    { iLength = aaArray.length; }

  var jj = 0;
  for (var ii = aaArray.length - iLength; ii < aaArray.length; ii++)
  {
    aaReturn[jj] = aaArray[ii];
  }

  return aaReturn;

} //-- fnTailArray