/* --------------------------------
** FUNCTION:
**   fnSpacifyString 
** DESCRIPTION:
**   This function adds space characters (or some
**   other designated character) between each character
**   of a specified string.
** DEPENDENCIES:
** SEE ALSO:
** DATE:
** 
   -------------------------------- */

function fnSpacifyString(sString, sSpacifier) 
{

  //-- Verify parameters
  if (sSpacifier == null)
    { sSpacifier = " "; }

  if (sString == null)
  {
    //-->-->-->-->-->-->-->-->-->-->-->-->
    //-- write out some nasty error message
    //-- somewhere, mortally insulting the programmer
    //-- for such a ridiculous error
    return -1;
  }

  var iLength   = sString.length;
  var sReturn   = new String("");

  for (var ii = 0; ii < iLength; ii++)
  {
    cCurrentCharacter = sString.substring(ii, ii + 1);
    sReturn += cCurrentCharacter + sSpacifier;
  } //--for

  //alert("sSpacifier.length = " + sSpacifier.length);
  sReturn = sReturn.substring(0, sReturn.length + 1 - sSpacifier.length);

  return sReturn;
} //-- fnSpacifyString()