/*
   ###########################################################################
   This function simply swaps (in-place) the contents of two simple variables.
   ###########################################################################
*/
   function Swap (&$var1, &$var2)
{
   $w=$var1;  $var1=$var2;  $var2=$w;
}