PHP Classes

PHP Associative Array Key Case Insensitive: Store associative array with case insensitive keys

Recommend this page to a friend!
     
  Info   Example   View files Files   Install with Composer Install with Composer   Download Download   Reputation   Support forum   Blog    
Ratings Unique User Downloads Download Rankings
StarStarStarStar 73%Total: 130 All time: 9,358 This week: 206Up
Version License PHP version Categories
associative-array 1.0.2GNU General Publi...5.5PHP 5, Data types
Description 

Author

This class can store associative array with case insensitive keys.

It implements the array access interface so it can store array entries using keys that are equivalent regardless of the case.

The class stores and retrieve values for array entries regardless of the case of the entries.

Picture of Christian Vigh
  Performance   Level  
Name: Christian Vigh <contact>
Classes: 32 packages by
Country: France France
Age: 58
All time rank: 13410 in France France
Week rank: 8 Up1 in France France Up
Innovation award
Innovation award
Nominee: 20x

Winner: 3x

Example

<?php
   
/***********************************************************************************************************

        The following example demonstrates the use of the AssociativeArray class.
        This example will throw an exception when trying to access undefined index 'ZZ'.

     ***********************************************************************************************************/
   
require ( 'AssociativeArray.phpclass' ) ;

    if (
php_sapi_name ( ) != 'cli' )
        echo (
"<pre>" ) ;

   
$array = new AssociativeArray ( [ 'A' => 'Value of A', 'B' => 'Value of B', 'D' => 'Value of D', 'C' => 'Value of C' ] ) ;

    echo
"Getting value of array['A'] : " . $array [ 'A' ] . "\n" ;
    echo
"Getting value of array['b'] : " . $array [ 'b' ] . "\n" ;

    echo
"********** Unsorted array contents :\n" ;
   
print_r ( $array -> ToArray ( ) ) ;

    echo
"********** Sorted array contents :\n" ;
   
$array -> ksort ( ) ;
   
print_r ( $array -> ToArray ( ) ) ;


    if ( isset (
$array [ 'ZZ' ] ) )
        echo
"Index 'ZZ' exists\n" ;
    else
        echo
"Index 'ZZ' DOES NOT exist\n" ;

   
// The following line of code will throw an exception, because index 'ZZ' is not defined
    //echo "Getting value of (inexisting) array['ZZ'] : " . $array [ 'ZZ' ] . "\n" ;




Details

INTRODUCTION

The AssociativeArray class has been designed to implement associative arrays whose keys will be case-insensitive. It tries to mimic the built-in PHP array type to provide as much transparent access as possible.

A basic example would be :

// Create an array
$array = new AssociativeArray ( [ 'A' => 'Value of A', 'B' => 'Value of B', 'D' => 'Value of D', 'C' => 'Value of C' ] ) ;

// Retrieve item 'A', without caring about case-sensitivity. Both lines of code will display the same result :
echo "Getting value of array['A'] : " . $array [ 'a' ] ;
echo "Getting value of array['A'] : " . $array [ 'A' ] ;

WHY HAVING ASSOCIATIVE ARRAY WITH KEYS THAT ARE NOT CASE-SENSITIVE ?

The origin of this class comes from a habit of mine : I'm using several configuration files that have the format of a Windows .INI file, such as php.ini, and always wanted key names to be case-insensisitive.

I realized one day that I had duplicated a little bit elsewhere the same code that allowed certain associative arrays to be accessed with case-insensitive keys and I told myself that other developers may face the same situtation and may suffer from typos in their code, because they specified an uppercase 'A' instead of lowercase 'a' when accessing an array item by its key.

This is why I developed this class, which I'm heavily using each time I need an associative array with case-insensitive keys.

Since PHP arrays internally use hash tables, where the array keys are case-sensitive hashed values, it is impossible that one day you will be able to use associative arrays with case-insensitive keys. This is the only reason why I developed this class.

Of course, it may seem incomplete (for example, it does not implement all the various sorting functions that you may expect), but it will fit your needs for your day-to-day purposes.

And, of course, it has been optimized to avoid unnecessary computations whenever you insert or delete an item from the array.

NOTICE

You may find the list of methods contained in this class a little bit poor and you will be true : I wanted to have a class that exactly fits my day-to-day needs, and nothing more (the day-to-day needs in question were very basic).

However, if you have additional needs, you can freely add the methods of your choice or simply contact me to provide a new version ; I will be happy to enrich this class based on your suggestions.

REFERENCE

The class implements the ArrayAccess, Countable and IteratorAggregate interfaces ; this means that you can use the following constructs :

// Create an array
$array = new AssociativeArray ( [ 'A' => 'Value of A', 'B' => 'Value of B', 'D' => 'Value of D', 'C' => 'Value of C' ] ) ;

echo count ( $array ) ; 		// will output "4"

// Loop through array items using a traditional for() loop
// Will display :
//		Value of A
//		Value of B
//		Value of D
//		Value of C
for ( $i = 0 ; $i < count ( $array ) ; $i ++ ) 
	echo $array [$i] . "\n" ;

// use a foreach() loop to achieve the same result (but additionally displays the key name)
foreach ( $array  as $key => $item )
	echo "$key -> $item\n" ;

// Add a new element to the array 
$array [ 'newKey' ] 	=  'This is a new value' ;

You can also use the isset() method to check for the existence of an individual element in an array, and unset() to remove a specific element from an array.

Note also that you can access items using either the array notation or the object notation ; the following two lines of code, using the array initialized in the above example, will display the same element, "Value of A" :

echo $array ['a' ] ;
echo $array -> A ;

Associative array items can be also accessed by their numerical index :

echo $array [1] 	;  // Will echo "Value of B" ; 

$key = $array -> keyname ( $index ) ;

Returns the array key at the specified integer index.

The following example will echo the value "B" :

$array = new AssociativeArray ( [ 'A' => 100, 'B' => 101, 'C' => 102 ] ) ;

echo $array -> keyname ( 1 ) ;

$status = $array -> iin\_array ( $value ) ;

Checks if an array contains the specified value. Comparison is case-insensitive.

The method returns true if $array contains $value, and false otherwise.

$status = $array -> iin\_subarray ( $value ) ;

Checks if an array contains the specified value in one of its nested array items. Comparison is case-insensitive.

The method returns true if $array contains $value, and false otherwise.

$status = $array -> in\_array ( $value ) ;

Checks if an array contains the specified value. Comparison is case-sensitive.

The method returns true if $array contains $value, and false otherwise.

$status = $array -> in\_subarray ( $value ) ;

Checks if an array contains the specified value in one of its nested array items. Comparison is case-sensitive.

The method returns true if $array contains $value, and false otherwise.

$key = $array -> keyname ( $index ) ;

Returns the array key at the specified integer index.

The following example will echo the value "B" :

$array = new AssociativeArray ( [ 'A' => 100, 'B' => 101, 'C' => 102 ] ) ;

echo $array -> keyname ( 1 ) ;

$array -> ksort ( ) ;

Sorts the items of $array by their key names.

$value = $array -> pop ( ) ;

Like the standard array\_pop() PHP function, pops the last item of the specified array and returns its value.

$values = $array -> ToArray ( ) ;

Returns the values in $array as a non-associative array.


  Files folder image Files (5)  
File Role Description
Plain text file AssociativeArray.phpclass Class Class source
Accessible without login Plain text file example.php Example Example script
Accessible without login Plain text file LICENSE Lic. License text
Accessible without login Plain text file NOTICE Data Auxiliary data
Accessible without login Plain text file README.md Doc. Documentation

The PHP Classes site has supported package installation using the Composer tool since 2013, as you may verify by reading this instructions page.
Install with Composer Install with Composer
 Version Control Reuses Unique User Downloads Download Rankings  
 100%2
Total:130
This week:0
All time:9,358
This week:206Up
 User Ratings  
 
 All time
Utility:91%StarStarStarStarStar
Consistency:91%StarStarStarStarStar
Documentation:100%StarStarStarStarStarStar
Examples:83%StarStarStarStarStar
Tests:-
Videos:-
Overall:73%StarStarStarStar
Rank:128