what does this function do?

[jasondavis]

I ran accross this function in one of my function files but Im not sure exactly what it does, perhaps I dont need it, can anyone figure out what it's purpose could be

function get_qry_str($over_write_key = array(), $over_write_value = array()) {
	global $_GET;
	$m = $_GET;
	if (is_array($over_write_key)) {
		$i = 0;
		foreach ($over_write_key as $key) {
			$m[$key] = $over_write_value[$i];
			$i++;
		}
	} else {
		$m[$over_write_key] = $over_write_value;
	}
	$qry_str = qry_str($m);
	return $qry_str;
}

[laserlight]

From what I see, get_qry_str() takes two arguments: a key or a value, or an array of keys and an array of values. For the latter, the array of values must be at least as large as the array of keys, and be numerically indexed.

Now, get_qry_str() then retrieves the key/value pairs from the query string (hence the copy of $_GET). For each key that matches a key provided as an argument, it replaces the value with the corresponding value provided as an argument. If the key is not present in the query string, the new key/value pair passed as arguments is added to the key/value pair array.

Finally, get_qry_str() calls qry_str() on this new key/value pair set and returns the result. What exactly qry_str() does, I unfortunately cannot say, though I can guess that it does a reverse of parse_str() from an array to a string.