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

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

  //-- Validate function parameters
  if (aaArray == null)
  {
    document.write(
      "ERROR: .... \n");
    return -1;
  } //-- if array null

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

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

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

  return aaReturn;

} //-- fnHeadArray