state function s

/**
 * US STATE RELATED FUNCTIONS
**/

/**
 * Return an array af state names and abbreviations
 *
 * @return	(array)						state names and abbreviations
**/
function buildStateArray($include_us=true) {
	$state_array = array('AL' => 'Alabama', 'AK' => 'Alaska', 'AZ' => 'Arizona', 'AR' => 'Arkansas', 'CA' => 'California', 
						 'CO' => 'Colorado', 'CT' => 'Connecticut', 'DE' => 'Delaware', 'DC' => 'District of Columbia',
						 'FL' => 'Florida', 'GA' => 'Georgia', 'HI' => 'Hawaii', 'ID' => 'Idaho', 'IL' => 'Illinois', 
						 'IN' => 'Indiana', 'IA' => 'Iowa', 'KS' => 'Kansas', 'KY' => 'Kentucky', 'LA' => 'Louisiana', 
						 'ME' => 'Maine', 'MD' => 'Maryland', 'MA' => 'Massachusetts', 'MI' => 'Michigan', 'MN' => 'Minnesota', 
						 'MS' => 'Mississippi', 'MO' => 'Missouri', 'MT' => 'Montana', 'NE' => 'Nebraska', 'NV' => 'Nevada', 
						 'NH' => 'New Hampshire', 'NJ' => 'New Jersey', 'NM' => 'New Mexico', 'NY' => 'New York', 
						 'NC' => 'North Carolina', 'ND' => 'North Dakota', 'OH' => 'Ohio', 'OK' => 'Oklahoma', 'OR' => 'Oregon', 
						 'PA' => 'Pennsylvania', 'RI' => 'Rhode Island', 'SC' => 'South Carolina', 'SD' => 'South Dakota', 
						 'TN' => 'Tennessee', 'TX' => 'Texas', 'UT' => 'Utah', 'VT' => 'Vermont', 'VA' => 'Virginia', 
						 'WA' => 'Washington', 'WV' => 'West Virginia',	'WI' => 'Wisconsin', 'WY' => 'Wyoming');
	
	if ($include_us === true) $state_array['US'] = 'United States';
	
	return $state_array;
}


/**
 * Return state abbreviation
 *
 * @param	(string)	$searchname		state name
 * @return	(string)					state abbreviation
**/

function getStateAbbreviation($searchname) {
        $state_array = buildStateArray();
		
		foreach ($state_array as $abbreviation => $statename) {
			if (strcasecmp($searchname, $statename) == 0) return $abbreviation;
		}
		
		return NULL;
}


/**
 * Return state name
 *
 * @param	(string)	$abbreviation	state abbreviation
 * @return	(string)					state name
**/
function getStateName($abbreviation) {
	$state_array = buildStateArray();

	return (isset($state_array[$abbreviation]) ? $state_array[$abbreviation] : NULL);
}