insert_unique()
insert_unique(array $arr, mixed $val) : array
A functon to test if an array element exists and if it does not, add the value specified.
Parameters
| array | $arr | The input array |
| mixed | $val |
Utility methods to deal with arrays.
merge_by_keys(array $arr1, array $arr2, string $key1, string $key2)
Merge two arrays of hashes based on certain keys
| array | $arr1 | The primary array |
| array | $arr2 | The array to be merged |
| string | $key1 | The key field in the first array |
| string | $key2 | The key field in the second array |
compare_elements_by_sortorder_key(array $e1, array $e2, string $key) : int
Compare two hashes by the key 'sort_key' This function is useful for sorting arrays of hashes.
| array | $e1 | Associative Array 1 |
| array | $e2 | Associative Array 2 |
| string | $key | The key to sort each element by |
-1, 0, or -1
hashsort(array $input, string $key, bool $is_string, bool $casecompare) : bool
Sort array of hashes by key
| array | $input | An array of hashes. This array of hashes is sorted. |
| string | $key | The hash key to sort by |
| bool | $is_string | A boolean indicating if the key is a string |
| bool | $casecompare | If $is_string is true, wether or not to do case sensitive comparisons |
objsort(array $input, string $member, bool $is_string, bool $casecompare) : bool
Sort array of objects by member
| array | $input | Arreay of objects to sort |
| string | $member | The member name to sort on |
| bool | $is_string | Indicates wether the member is a string |
| bool | $casecompare | Wether the values should be sorted in a case sensitive, or case insensitive manner. |
hashrsort(array $input, string $key, bool $is_string, bool $casecompare) : void
Sort array of hashes by key in reverse order
| array | $input | The input array of hashes. This array is modified on output |
| string | $key | The hash key to sort by |
| bool | $is_string | Wether the value of the key is a string or not |
| bool | $casecompare | If the value of the key is a string, wether it should be sorted in a case sensitive manner, or not. |
explode_with_key(string $str, string $inglue, string $outglue) : array
Explode an array into a hash useful for separating params on a URL into a hash
| string | $str | The input string. |
| string | $inglue | inner glue string (separates name from value) |
| string | $outglue | outer glue string (separates each variable/value combination) |
implode_quoted(array $data, string $glue, string $quote) : string
Given an array, implode it into a string with non empty values quoted.
| array | $data | The input array |
| string | $glue | How each value should be separated in the input |
| string | $quote | How non empty fields should be deliminated |
hash_prepend(\hash $input, string $key, mixed $value) : \hash
Prepend a key/value pair to a hash.
This is useful when prepending an 'any' value to a list retrieved from the database, for use in filtering dialogs etc.
| \hash | $input | input array |
| string | $key | The key to prepend |
| mixed | $value | The value to prepend |
explode_to_tree(array $hash, string $delimiter, string $baseval)
Given a hash of records, where the key denotes the path separeted with a delimieter, generate a tree of records.
| array | $hash | The input hash |
| string | $delimiter | The identifier delimiter (used on hash keys) |
| string | $baseval | Internal use only |
smart_explode(string $str, string $delim, string $safe_char) : array
Smartly explode a string into an array given a delimiter, and a safe character.
Any instances of the delimiter inside two 'safe characters' will be included in the value.
This is useful when importing data from CSV.
| string | $str | The input string |
| string | $delim | The field delimeter |
| string | $safe_char | The save character |