/* --------------------------------
** FUNCTION:
**   fnLeftShiftArray
** DESCRIPTION:
**   This function shifts the elements of an array
**   one place to the left.
** DEPENDENCIES:
** DATE:
** 
   -------------------------------- */

function fnLeftShiftArray(aaArray, iStartIndex)
{
  if (iStartIndex == null)
    { iStartIndex = 0; }

  if (iStartIndex > aaArray.length)
    { iStartIndex = 0; }

  if (iStartIndex < 0)
    { iStartIndex = 0; }

  if (isNaN(iStartIndex))
    { iStartIndex = 0; }

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

  for (var ii = iStartIndex; ii < aaArray.length - 1; ii++)
    { aaReturn[ii] = aaArray[ii + 1]; }

  return aaReturn;

} //-- fnLeftShiftArray