mirror of
https://github.com/ninjamuffin99/Funkin.git
synced 2024-12-25 14:46:43 +00:00
86 lines
2 KiB
Haxe
86 lines
2 KiB
Haxe
package funkin.util.tools;
|
|
|
|
/**
|
|
* A static extension which provides utility functions for Maps.
|
|
*
|
|
* For example, add `using MapTools` then call `map.values()`.
|
|
*
|
|
* @see https://haxe.org/manual/lf-static-extension.html
|
|
*/
|
|
class MapTools
|
|
{
|
|
/**
|
|
* Return the quantity of keys in the map.
|
|
*/
|
|
public static function size<K, T>(map:Map<K, T>):Int
|
|
{
|
|
if (map == null) return 0;
|
|
return map.keys().array().length;
|
|
}
|
|
|
|
/**
|
|
* Return a list of values from the map, as an array.
|
|
*/
|
|
public static function values<K, T>(map:Map<K, T>):Array<T>
|
|
{
|
|
if (map == null) return [];
|
|
return [for (i in map.iterator()) i];
|
|
}
|
|
|
|
/**
|
|
* Create a new array with all elements of the given array, to prevent modifying the original.
|
|
*/
|
|
public static function clone<K, T>(map:Map<K, T>):Map<K, T>
|
|
{
|
|
if (map == null) return null;
|
|
return map.copy();
|
|
}
|
|
|
|
/**
|
|
* Create a new map which is a combination of the two given maps.
|
|
* @param a The base map.
|
|
* @param b The other map. The values from this take precedence.
|
|
* @return The combined map.
|
|
*/
|
|
public static function merge<K, T>(a:Map<K, T>, b:Map<K, T>):Map<K, T>
|
|
{
|
|
var result = a.copy();
|
|
|
|
for (pair in b.keyValueIterator())
|
|
{
|
|
result.set(pair.key, pair.value);
|
|
}
|
|
|
|
return result;
|
|
}
|
|
|
|
/**
|
|
* Create a new array with clones of all elements of the given array, to prevent modifying the original.
|
|
*/
|
|
public static function deepClone<K, T, U:ICloneable<T>>(map:Map<K, U>):Map<K, T>
|
|
{
|
|
// TODO: This function does NOT work.
|
|
throw "Not implemented";
|
|
|
|
/*
|
|
var newMap:Map<K, T> = [];
|
|
// Replace each value with a clone of itself.
|
|
for (key in newMap.keys())
|
|
{
|
|
newMap.set(key, newMap.get(key).clone());
|
|
}
|
|
return newMap;
|
|
*/
|
|
}
|
|
|
|
/**
|
|
* Return a list of keys from the map (as an array, rather than an iterator).
|
|
* TODO: Rename this?
|
|
*/
|
|
public static function keyValues<K, T>(map:Map<K, T>):Array<K>
|
|
{
|
|
if (map == null) return [];
|
|
return map.keys().array();
|
|
}
|
|
}
|