added map function

Author: Jim-Webfox

README.md

@@ -157,6 +157,28 @@ returns
 ]
 ```
 
+### map
+
+Returns an array of all enum values mapping to their label.
+
+#### Usage
+
+```php
+VolumeUnitEnum::map();
+```
+
+returns
+
+```php
+[
+    'MILLIGRAM'=>'mg',
+    'GRAM'     =>'g',
+    'KILOGRAM' =>'kg',
+    'TONNE'    =>'t',
+]
+```
+
+
 ### labelFor
 
 Returns the label for a given enum name.

src/IsBackedEnum.php

@@ -27,6 +27,18 @@ public static function values(): array
         return array_map(fn($enum) => $enum->name, self::cases());
     }
 
+    public static function map(): array
+    {
+        static::ensureImplementsInterface();
+        $array = [];
+
+        foreach (self::cases() as $enum) {
+            $array[$enum->name] = $enum->label();
+        }
+
+        return $array;
+    }
+
     public static function labels(): array
     {
         static::ensureImplementsInterface();