code: function (aArray, vExpectedPropertyValue, sPropertyName) {
  			var i, n;
  
  			sPropertyName = sPropertyName || "name";
  			if (aArray) {
  				for (i = 0, n = aArray.length; i < n; i += 1) {
  					if (aArray[i][sPropertyName] === vExpectedPropertyValue) {
  						return i;
  					}
  				}
  			}
  			return -1;
  		}
docs: Returns the index of the first object inside the given array, where the property with the
  given name has the given expected value.
  
  @param {object[]} [aArray]
  some array
  @param {any} vExpectedPropertyValue
  expected value of the property with given name
  @param {string} [sPropertyName="name"]
  some property name
  @returns {number}
  the index of the first object found or <code>-1</code> if no such object is found