Added a get total map usage function that just returns the total numb…

…er of games played on a given map

example.php

@@ -26,6 +26,8 @@
 	print_r($request->get_map_data(17525));
 	echo "\n===\nGet Latest Map Usage Stats: \n===\n";
 	print_r($request->get_latest_map_usage());
+	echo "\n===\nGet Total Map Usage Stats: \n===\n";
+	print_r($request->get_total_map_usage());
 	//echo "\n\n===\nSorted Map Data: \n===\n";
 	//print_r($request->get_sorted_map_data(17525));
 

readme.md

@@ -23,8 +23,8 @@ record, defaulting to the 1v1 record of the last requested character
 	    $request->get_bracket_data();
 
 ## TODO
-* Add documentation for the new merged functions
 * Add support for batch requests
+* Add demo of new functions
 * Add other helper functions for processing returned data
 * Add documentation somewhere for the returned object structure
 * Add sorted map statistics methods

sc2ranks.php

@@ -212,7 +212,7 @@ public function get_map_data($map_id){
 		 * Returns the latest map usage statistics
 		 * @param object $response_object optional response object, defaults
 				to the last valid response
-		 * @return $object the deserialized team ranking object
+		 * @return object the deserialized team ranking object
 		 */
 		public function get_latest_map_usage($response_object = null){
 			if($response_object == null){
@@ -237,6 +237,33 @@ public function get_latest_map_usage($response_object = null){
 			return array("date" => $latest_date, "value" => $latest_date_value);
 		}
 
+		/**
+		 * Returns the total map usage statistics
+		 * @param object $response_object optional response object, defaults to
+		 *		the last response, if the response isn't a map request then
+		 *		the function returns null, so you'll need to pass the proper
+		 *		response object for the map request you made.
+		 * @return integer the total number of games played on this map
+		 */
+		public function get_total_map_usage($response_object = null){
+			if($response_object == null){
+				if($this->last_response != null && isset($this->last_response->teams)){
+					// We shouldn't have team for map data so this is wrong
+					return null;
+				}
+				else {
+					$response_object = $this->last_response;
+				}
+			}
+			if (isset($response_object->teams))
+				return null;
+			$total = 0;
+			foreach ($response_object as $value){
+				$total += $value;
+			}
+			return $total;
+		}
+
 		/**
 		 * Returns the deserialized character data object from the info
 		 * provided to the function.