Redspark at 00:50, 5 April 2025

2025-04-05T00:50:13Z

Redspark: Added to Sys Modules Category

2025-03-31T16:07:52Z

Added to Sys Modules Category

Unknown: Create mapUtil page

2023-10-16T03:31:01Z

Create mapUtil page

New page

In [[Mini Micro]], <c>mapUtil</c> is an [[import]] module in the <c>/sys/lib</c> directory. It provides various additional [[map]]-related functions, directly extending the [[map]] datatype.

Like all the modules in <c>/sys/lib</c>, the best documentation for mapUtil is the source code (<c>/sys/lib/mapUtil.ms</c>) itself. But this page summarizes the content in more concise form.

=== Constants ===
The following values should be normally be prefixed with <c>mapUtil</c>, e.g., <c>mapUtil.fromTo</c>.

{| class="wikitable"
|-
! Name !! Value / Purpose
|-
| fromTo || generate a map from one sequence (list or string) to another. The two sequences must be the same length.
|-
|}

=== Added map methods ===
The following methods are added to the [[map]] type, and so are accessed using dot syntax after any map, for example: <c>{"Hello": "World"}.inverse</c>

{| class="wikitable"
|-
! Method !! Returns
|-
| get(''key'', ''defaultValue=null'') || look up the value for an index in this map, but if the given index is not found, return a default value instead. Works with inherited values, too.
|-
| hasValue(''v'', ''includeInherited=false'') || return true if this map contains the given value as a value (compare with built-in function .hasIndex, which checks whether this map has a given value as a key). By default this
does not walk the inheritance chain (just like .hasIndex), but
if you pass ''true'' as the second parameter, then it does.
|-
| sortedIndexes || get the indexes of this map, but in sorted order (rather than undefined order as .indexes gives you).
|-
| inverse || return a new map that has the keys and values swapped (keys of this map become values of the result map, and vice versa).
|-
| filterIndexes(''func'') || remove any indexes for which the given function does not return true.
|-
| filterValues(''func'') || remove any key/value pairs for which the function, applied to the value, does not return true.
|-
| applyToValues(''func'') || apply the given function to all values.
|-
| pairs || get all key/value pairs as a list (in arbitrary order) of little maps with "key" and "value".
|-
| swap(''key1'', ''key2'') || swap the values of two keys. Note that this may be applied to locals (or globals), enabling you to swap the values of two variables.
|-
|}

=== Example ===

<ms>import "mapUtil"
print {"Hello": "World"}.inverse //prints {"World": "Hello"}
</ms>

[[Category:Mini Micro]]

@@ Line 49: / Line 49: @@
 </ms>
 [[Category:Mini Micro]]
-[[Category:Sys Modules]]
+[[Category:Command-Line_MiniScript]]

← Older revision		Revision as of 16:07, 31 March 2025
Line 50:		Line 50:

	[[Category:Mini Micro]]		[[Category:Mini Micro]]
		+	[[Category:Sys Modules]]

MapUtil - Revision history

Redspark at 00:50, 5 April 2025

Redspark: Added to Sys Modules Category

Unknown: Create mapUtil page