Class ArrayUtil

Standalone class with miscellaneous array functions

Author: Demitri Morgan <demitri@x2engine.com>, Derek Mueller <derek@x2engine.com>
Located at x2engine/protected/components/util/ArrayUtil.php

Methods summary
`public static array`	# `normalizeToArray( array $expectedFields, array $currentFields )` Given two associative arrays, returns an array with the same set of keys as the first, but with key/value pairs from the second if they are present. Any keys in the second and not in the first will be ignored/dropped. Given two associative arrays, returns an array with the same set of keys as the first, but with key/value pairs from the second if they are present. Any keys in the second and not in the first will be ignored/dropped. Parameters `$expectedFields` `array` $expectedFields The array with key => default value pairs `$currentFields` `array` $currentFields The array to copy values from Returns `array`
`public static array`	# `normalizeToArrayR( array $expectedFields, array $currentFields, mixed $maintainOrder = true )` A recursive version of normalizeToArray () which optionally maintains order of current fields. A recursive version of normalizeToArray () which optionally maintains order of current fields. Parameters `$expectedFields` `array` $expectedFields The array with key => default value pairs `$currentFields` `array` $currentFields The array to copy values from `$maintainOrder` Returns `array`
`public static boolean`	# `is_assoc( array $array )` Determines whether a given array is associative Determines whether a given array is associative Parameters `$array` `array` $array The array for which the check is made Returns `boolean` True if $array is associative, false otherwise
`public static type`	# `arraySearchPreg( string $find, array $in_array, array $keys_found = array() )` Similar to array_search but recursive, doesn't return needle of there's only one match, and allows for regex searching. Similar to array_search but recursive, doesn't return needle of there's only one match, and allows for regex searching. Parameters `$find` `string` $find regex to search on `$in_array` `array` $in_array an array to search in `$keys_found` `array` $keys_found keys whose corresponding values match the regex Returns `type` an array of keys if $in_array is valid, or false if not.
`public static`	# `assocArrayShift( array & $array )` Retrieve the first entry from an associative array Retrieve the first entry from an associative array Parameters `$array` `array` $array
`public static the`	# `sort( array $array )` Parameters `$array` `array` $array the array to sort Returns `the` sorted array
`public static the`	# `asorti( array $array )` Case-insensitive, no side-effects version of asort Case-insensitive, no side-effects version of asort Parameters `$array` `array` $array the array to sort Returns `the` sorted array
`public static`	# `pop( array $array )` Side effect free version of array_pop Side effect free version of array_pop
`public static`	# `transpose( mixed $array )`
`public static`	# `numericIndexOf( mixed $needle, mixed $haystack, mixed $strict = false )` Like array_search but returns numeric index instead of key Like array_search but returns numeric index instead of key
`public static`	# `setAndTrue( mixed $array, mixed $val )`
`public static`	# `setEquals( mixed $array1, mixed $array2 )`
`public static`	# `coerceToArray( mixed $arr )`