Documentation ^jit ia\Lib\iaArray Documentation Function examples Index Examples List

class ia\Lib\iaArray

/** * iaArray: Useful function for arrays * */
namespace: ia\Lib
Implements: Stringable
Public Methods
1. static array_key_exists_insensitive( string $key $key, array $array ) : bool
  /** * array_key_exists case insensitive * * @param string $key key to search for case insensitive * @param array $array * @return bool true key exists, false dosen't exist */
2. static get_key_insensitive( string $key, array $array, mixed $notFoundValue = null ) : mixed
  /** * get $array[$case_insensitive_key] * * @param array $array * @param string $key * @param mixed $notFoundValue * @return mixed the value for $array[$case_insensitive_key] */
3. static array_key_n( array $array, int $keyPosition, string $notFoundKey = null ) : string
  /** * return array's key at position $keyPosition, zero based * * @param array $array * @param int $keyPosition * @param string $notFoundKey * @return string array's key at position $keyPosition */
4. static change_array_keys( array $data, array $keyMap, bool $includeNonMappedKeys = true ) : array
  /** * Change array keys * * @param array $data * @param array $keyMap ['keyIn $Data' => 'newKey'] * @param bool $includeNonMappedKeys true keys not in $keyMap are * @return array changes de keys in $Data for those in $keyMap, not found are controled by $includeNonMappedKeys * @exmpale change_array_keys(['kB'=>'kB val','kA'=>'kA val','other'=>'other val'],['kA'=>'A','kB'=>'B'],true) ['B'=>'kB val','A'=>'kA val','other'=>'other val'] * @exmpale change_array_keys(['kB'=>'kB val','kA'=>'kA val','other'=>'other val'],['kA'=>'A','kB'=>'B'],false) ['B'=>'kB val','A'=>'kA val'] */
5. static in_array_case_insensitive( $needle, $haystack ) :
6. static compare( $a, $b ) :
7. static array_changes( array $after, array $before ) : array
  /** * Retrun an array with what changed or added in $after vs $before * * @param array $after ['both_no_changed'=>'Error value did not change','both_changed'=>'after_value', 'only_in_after'=>'only_in_after value'] * @param array $before ['both_no_changed'=>'Error value did not change','both_changed'=>'before_value','only_in_before'=>'only_in_before value'] * @return array ['both_changed'=>'after_value', 'only_in_after'=>'only_in_after value'] */
8. static arrayExtend( array &$base, array $extendWith ) : void
  /** * Recursevely adds/replaces keys in $base with keys in $extendWith * * @param array $base ie: ['a'=>'OriA','b'=>'OnlyB','d'=>['d1'=>1]] * @param array $extendWith ie: ['c'=>'NewC', 'a'=>'Replaced', 'd'=>['d2'=>2]] * @return void $base is modified ie: [['a'] => 'Replaced', ['b'] => 'OnlyB', ['d'] => [ ['d1'] => 1, ['d2'] => 2 ], [c] => 'NewC'] */
9. static expandKeyToArray( array $array, string $separator ) : array
  /** * * * @param array $array * @param string $separator * @return array (['a.b.c'=>'It', 'a.b.d'=>'is', 'a.b.e'=>'a', 'a.b.f'=>'cat'], '.') => ['a' => [ 'b'=> ['c' => 'It','d'=>'is','e'=>'a','f'=>'cat'] ] ] */
10. static tupplesToArrayAssoc( array $list ) : array
  /** * Keys to final value * * @param array $list ie [ ['vivo','animal','felino','gato', 'domestico','gato info'], ['vivo','animal','felino','gato', 'feral','salvaje'], ['vivo','animal','canino','perro','Perro Frase'] ] * @return array ie [ 'vivo' => ['animal' => ['felino' => [ 'gato' => [ 'domestico' => 'gato info' , 'feral' => 'salvaje' ] ], 'canino' => ['perro' => 'Perro Frase' ] ] ]] */
11. static tupplesToArrayPath( array $array, string $pathSeparator = ' ' ) : array
  /** * * * @param array $array ie: [ ['vivo','animal','felino','gato','gato info'], ['vivo','animal','canino','perro','Perro Frase'] ] * @param string $pathSeparator ie: '.' * @return array ie: [ 'vivo.animal.felino.gato' => 'gato info', 'vivo.animal.canino.perro' => 'Perro Frase' ] */
12. static arrayGetPath( array $array, string $path, string $pathSeparator = ' ' ) : mixed
  /** * regresa el valor del ultimo key en el path * * @param array $array ie: ['vivo' => ['animal' =>['felino' => ['gato' => ['Gato Info'] ] ] ] ] * @param string $path ie: 'vivo.animal.felino.gato' * @param string $pathSeparator ie: '.' * @return mixed ie: ['Gato Info'], null on not found */
13. static multiKeyIt( array $array, int $numKeys ) : array
  /** * @param array $array * @param int $numKeys * @return array */
14. static arrayKey2Ul( array $array, string $ul = 'ul', bool $displayValue = true, bool $displayKey = false, bool $skipHtmlentities = false, bool $displayKeyNumeric = false ) : string
  /** * Returns a string of indented ul/ol representing the array * * keys inside span class='key2UlKey' values inside span class='key2UlValue' * * @param array $array * @param string $ul html tag to use 'ul' or 'ol', default 'ul' * @param bool $displayValue on true display value on false only keys. default true * @param bool $displayKey on true display the key * @param bool $skipHtmlentities true no htmlentites on output, false output using htmlentities * @param bool $displayKeyNumeric * @return string '
  - key1
    - key1.1' */
    - static arrayKey2Ul_echo( array $array, string $ul = 'ul', bool $displayValue = true, bool $displayKey = false, bool $skipHtmlentities = false, bool $displayKeyNumeric = false ) : void
      /** * echos indented ul/ol representing the array * * @param array $array * @param string $ul html tag to use 'ul' or 'ol', default 'ul' * @param bool $displayValue on true display value on false only keys. default true * @param bool $displayKey on true display the key * @param bool $skipHtmlentities true no htmlentites on output, false output using htmlentities * @param bool $displayKeyNumeric * @return void * * @codeCoverageIgnore */

Index Documentation Function examples Index Examples List

ia\Lib\iaArray

AesCipher ^🔧
iaLibAutoLoader ^🔧
iaSqlite ^🔧
ia
- Data
  - MexicoEstados ^🔧
- Date
- DevTools
  - iaTimer ^🔧
- DocumentIt
  - DocumentIt ^🔧
  - PerfilExample ^🔧
- JqGrid
  - Filter2where ^🔧
  - JqGridRead ^🔧
- Lib
- Math
- Sql
  - Mysql
- Util
- Work
  - WorkDay
  - Workflow
PushId ^🔧
URLify ^🔧
XLSXWriter ^🔧

Examples by function ia\Lib\iaArray Documentation Function examples Index Examples List

**ia\Lib\iaArray**
Disclaimer: Auto generated file. Please help us setting parameters to useful values and extending the examples. ia\Lib\iaArray::array_key_exists_insensitive(string $key $key, array $array) : bool /** * array_key_exists case insensitive * * @param string $key key to search for case insensitive * @param array $array * @return bool true key exists, false dosen't exist / ia\Lib\iaArray::array_key_exists_insensitive('asdf', ['a' => '1', 'b' => '2', 'c' => 3]); -> false ia\Lib\iaArray::get_key_insensitive(string $key, array $array, mixed $notFound = null) : mixed* /** * $array[$case_insensitive_key] * * @param array $array * @param string $key * @param mixed $notFound * @return mixed / ia\Lib\iaArray::get_key_insensitive('asdf', ['a' => '1', 'b' => '2', 'c' => 3]); -> ia\Lib\iaArray::array_key_n(array $array, int $keyPosition, string $default = null) : string* /** * return array's key at position $keyPosition * * @param array $array * @param int $keyPosition * @param string $default * @return string / ia\Lib\iaArray::array_key_n(['a' => '1', 'b' => '2', 'c' => 3], 3); -> ia\Lib\iaArray::change_array_keys(array $Data, array $keyMap, bool $includeNonMappedKeys = true) : array* /** * Change array keys * * @param array $Data * @param array $keyMap ['keyIn $Data' => 'newKey'] * @param bool $includeNonMappedKeys true keys not in $keyMap are * @return array changes de keys in $Data for those in $keyMap, not found are controled by $includeNonMappedKeys * @exmpale reKey(['kB'=>'kB val','kA'=>'kA val','other'=>'other val'],['kA'=>'A','kB'=>'B'],true) ['kB'=>'kB val','kA'=>'kA val','other'=>'other val'] * @exmpale reKey(['kB'=>'kB val','kA'=>'kA val','other'=>'other val'],['kA'=>'A','kB'=>'B'],false) ['kB'=>'kB val','kA'=>'kA val'] / ia\Lib\iaArray::change_array_keys(['a' => '1', 'b' => '2', 'c' => 3], ['a' => '1', 'b' => '2', 'c' => 3]); -> Array ( [1] => 1 [2] => 2 [3] => 3 ) ia\Lib\iaArray::compare( $a, $b) :* ia\Lib\iaArray::compare(null /* == /, null / == /); -> 0 ia\Lib\iaArray::array_changes(array $after, array $before) : array* /** * Retrun an array with what changed or added in $after vs $before * * @param array $after * @param array $before * @return array / ia\Lib\iaArray::array_changes(['a' => '1', 'b' => '2', 'c' => 3], ['a' => '1', 'b' => '2', 'c' => 3]); -> Array ( ) ia\Lib\iaArray::arrayExtend(array &$base, array $extendWith) : void* /** * Recursevely adds/replaces keys in $base with keys in $extendWith * * @param array $base ie: ['a'=>'OriA','b'=>'OnlyB','d'=>['d1'=>1]] * @param array $extendWith ie: ['c'=>'NewC', 'a'=>'Replaced', 'd'=>['d2'=>2]] * @return void $base is modified ie: [['a'] => 'Replaced', ['b'] => 'OnlyB', ['d'] => [ ['d1'] => 1, ['d2'] => 2 ], [c] => 'NewC'] / ia\Lib\iaArray::arrayExtend(['a' => '1', 'b' => '2', 'c' => 3], ['a' => '1', 'b' => '2', 'c' => 3]);" ia\Lib\iaArray::expandKeyToArray(array $array, string $separator) : array* /** * * * @param array $array * @param string $separator * @return array / ia\Lib\iaArray::expandKeyToArray(['a' => '1', 'b' => '2', 'c' => 3], 'asdf'); -> Array ( [a] => 1 [b] => 2 [c] => 3 ) ia\Lib\iaArray::tupplesToArrayAssoc(array $list) : array* /** * Keys to final value * * @param array $list ie [ ['vivo','animal','felino','gato', 'domestico','gato info'], ['vivo','animal','felino','gato', 'feral','salvaje'], ['vivo','animal','canino','perro','Perro Frase'] ] * @return array ie [ 'vivo' => ['animal' => ['felino' => [ 'gato' => [ 'domestico' => 'gato info' , 'feral' => 'salvaje' ] ], 'canino' => ['perro' => 'Perro Frase' ] ] ]] / ia\Lib\iaArray::tupplesToArrayAssoc(['a' => '1', 'b' => '2', 'c' => 3]); -> Fatal error: Uncaught TypeError: count(): Argument #1 ($value) must be of type Countable\|array, string given in /lamp/www/iaLib/inc_ia/Lib/iaArray.php:177 Stack trace: #0 /lamp/www/iaLib/inc_ia/Lib/iaArray.php(177): count('1') #1 /lamp/www/iaLib/ia_examples/code/ia/Lib/iaArray_example_code.php(197): ia\Lib\iaArray::tupplesToArrayAssoc(Array) #2 /lamp/www/iaLib/ia_examples/template/ia_example_class.php(118): include('/lamp/www/iaLib...') #3 /lamp/www/iaLib/ia_examples/ia/Lib/iaArray_example.php(9): include('/lamp/www/iaLib...') #4 {main} thrown in /lamp/www/iaLib/inc_ia/Lib/iaArray.php* on line 177

ia\Lib\iaArray

Disclaimer: Auto generated file. Please help us setting parameters to useful values and extending the examples.

ia\Lib\iaArray::array_key_exists_insensitive(string $key $key, array $array) : bool

/**
     * array_key_exists case insensitive
     *
     * @param string $key key to search for case insensitive
     * @param array $array
     * @return bool true key exists, false dosen't exist
     */

ia\Lib\iaArray::array_key_exists_insensitive('asdf', ['a' => '1', 'b' => '2', 'c' => 3]); -> false

ia\Lib\iaArray::get_key_insensitive(string $key, array $array, mixed $notFound = null) : mixed
```
/**
     *  $array[$case_insensitive_key]
     *
     * @param array $array
     * @param string $key
     * @param mixed $notFound
     * @return mixed
     */
```
1. ia\Lib\iaArray::get_key_insensitive('asdf', ['a' => '1', 'b' => '2', 'c' => 3]); ->

ia\Lib\iaArray::array_key_n(array $array, int $keyPosition, string $default = null) : string

/**
     * return array's key at position $keyPosition
     *
     * @param array $array
     * @param int $keyPosition
     * @param string $default
     * @return string
     */

ia\Lib\iaArray::array_key_n(['a' => '1', 'b' => '2', 'c' => 3], 3); ->

ia\Lib\iaArray::change_array_keys(array $Data, array $keyMap, bool $includeNonMappedKeys = true) : array

/**
     * Change array keys
     *
     * @param array $Data
     * @param array $keyMap ['keyIn $Data' => 'newKey']
     * @param bool $includeNonMappedKeys true keys not in $keyMap are
     * @return array changes de keys in $Data for those in $keyMap, not found are controled by $includeNonMappedKeys
     * @exmpale reKey(['kB'=>'kB val','kA'=>'kA val','other'=>'other val'],['kA'=>'A','kB'=>'B'],true) ['kB'=>'kB val','kA'=>'kA val','other'=>'other val']
     * @exmpale reKey(['kB'=>'kB val','kA'=>'kA val','other'=>'other val'],['kA'=>'A','kB'=>'B'],false) ['kB'=>'kB val','kA'=>'kA val']
     */

ia\Lib\iaArray::change_array_keys(['a' => '1', 'b' => '2', 'c' => 3], ['a' => '1', 'b' => '2', 'c' => 3]); ->
```
Array
(
    [1] => 1
    [2] => 2
    [3] => 3
)
```

ia\Lib\iaArray::compare( $a, $b) :
1. ia\Lib\iaArray::compare(null /* == */, null /* == */); ->
```
0
```
ia\Lib\iaArray::array_changes(array $after, array $before) : array
```
/**
     * Retrun an array with what changed or added in $after vs $before
     *
     * @param array $after
     * @param array $before
     * @return array
     */
```
1. ia\Lib\iaArray::array_changes(['a' => '1', 'b' => '2', 'c' => 3], ['a' => '1', 'b' => '2', 'c' => 3]); ->
```
Array
(
)
```

ia\Lib\iaArray::arrayExtend(array &$base, array $extendWith) : void

/**
     * Recursevely adds/replaces keys in $base with keys in $extendWith
     *
     * @param array $base ie: ['a'=>'OriA','b'=>'OnlyB','d'=>['d1'=>1]]
     * @param array $extendWith ie: ['c'=>'NewC', 'a'=>'Replaced', 'd'=>['d2'=>2]]
     * @return void $base is modified ie:  [['a'] => 'Replaced', ['b'] => 'OnlyB', ['d'] => [ ['d1'] => 1, ['d2'] => 2 ], [c] => 'NewC']
     */

ia\Lib\iaArray::arrayExtend(['a' => '1', 'b' => '2', 'c' => 3], ['a' => '1', 'b' => '2', 'c' => 3]);"

ia\Lib\iaArray::expandKeyToArray(array $array, string $separator) : array
```
/**
     *
     *
     * @param array $array
     * @param string $separator
     * @return array
     */
```
1. ia\Lib\iaArray::expandKeyToArray(['a' => '1', 'b' => '2', 'c' => 3], 'asdf'); ->
```
Array
(
    [a] => 1
    [b] => 2
    [c] => 3
)
```

ia\Lib\iaArray::tupplesToArrayAssoc(array $list) : array

/**
     * Keys to final value
     *
     * @param array $list ie [ ['vivo','animal','felino','gato', 'domestico','gato info'], ['vivo','animal','felino','gato', 'feral','salvaje'], ['vivo','animal','canino','perro','Perro Frase'] ]
     * @return array ie [ 'vivo' => ['animal' => ['felino' => [ 'gato' => [ 'domestico' => 'gato info' , 'feral' => 'salvaje' ] ], 'canino' => ['perro' => 'Perro Frase' ] ] ]]
     */

ia\Lib\iaArray::tupplesToArrayAssoc(['a' => '1', 'b' => '2', 'c' => 3]); ->