/**
 * (C) Thomas 'PointedEars' Lahn, 2009, released under GPLv3
 * 
 * Retrieves the data to send in the request, and optionally the request
 * method, from an (X)HTML form.  TODO: select[multiple] elements
 * 
 * @param f : HTMLFormElement
 * @param bUseFormMethod: optional boolean
 *   If <code>true</code>, the form's request method becomes the
 *   <code>HTTPRequest</code> object's request method. The default
 *   is <code>false</code>.
 * @return boolean
 */
getDataFromForm = function(f, bUseFormMethod) {
  var result = false, es, len;

  if (f && (es = f.elements) && (len = es.length))
  {
    if (bUseFormMethod) this.method = f.method;
    
    var aData = [];

    for (var i = 0; i < len; i++)
    {
      var o = es[i];
      if (o.name)
      {
        aData.push(esc(o.name) + "=" + esc(o.value != "" ? o.value : ""));
      }
    }

    this.data = aData.join("&");
    result = true;
  }

  return result;
};