/* --------------------------------
** FUNCTION:
**   fnAddTextToArray
** DESCRIPTION:
**   Adds a specified text string either to the
**   start or to the end of each element of an array.
** DEPENDENCIES:
**   none.
** DATE:
** 
   -------------------------------- */

function fnAddTextToArray(
  aaArray, sAppend, bAddAtBeginning)
{
  var aaReturn = new Array();

  if (aaArray == null)
  {
    var sErrorMessage =
      "ERROR:      \n" +
      "------      \n" +
      "  function:  fnAddTextToArray                 \n" +
      "  Parameter: aaArray                      \n\n" +
      "    A required parameter was omitted from \n" +
      "    the function.                         \n";
    document.write(sErrorMessage);
    return -1;
  } //-- if

  if (sAppend == null)
  {
    var sErrorMessage =
      "ERROR:      \n" +
      "------      \n" +
      "  function:  fnAddTextToArray                 \n" +
      "  Parameter: sAppend                      \n\n" +
      "    A required parameter was omitted from \n" +
      "    the function.                         \n";
    document.write(sErrorMessage);
    return -1;
  } //-- if

  if (bAddAtBeginning == null)
    { bAddAtBeginning = true; }

  for (ii = 0; ii < aaArray.length; ii++)
  {
    //-->-->-->
    //-- But what if some elements aren't strings??
    if (bAddAtBeginning)
      { aaReturn[ii] = sAppend + aaArray[ii]; }
    else
      { aaReturn[ii] = aaArray[ii] + sAppend; }
  } //--for 

  return aaReturn;

} //-- fnAddTextToArray