Go Maps: Difference between revisions

From NovaOrdis Knowledge Base
Jump to navigation Jump to search
Line 9: Line 9:
=Overview=
=Overview=


A map is an unordered collection of key-value pairs. <tt>map</tt> is a [[Go_Concepts_-_The_Type_System#Reference_Types|reference type]] and in order to get an instance of it, you need to use the <tt>make()</tt> function.
A map is an unordered collection of key-value pairs. <tt>map</tt> is a [[Go_Concepts_-_The_Type_System#Reference_Types|reference type]] and in order to get an instance of it, you need to use the <tt>[[#make.28.29|make()]]</tt> function.


=Declaration=
=Declaration=

Revision as of 18:40, 2 April 2016

External

Internal

Overview

A map is an unordered collection of key-value pairs. map is a reference type and in order to get an instance of it, you need to use the make() function.

Declaration

Long Declaration

var map_identifier map[key_type]value_type

Example of a map of string to ints:

var m map[string]int

Note that maps must be initialized before attempting to write into them, see Assinging a Value to an Unitialized Map.

Declaration and initialization:

var m map[string]string = make(map[string]string)

Short Declaration

m := make(map[string]string)
m := map[string]string {
  "A": "B",
  "C": "D",
}

Map Operators and Functions

Indexing Operator

Indexing operator [] returns the value corresponding to the specified key and a boolean value that says whether the key exists or not. If the key does not exist, the zero value for the value type is returned.

value := m["key"]
value, exists := m["key"]

Idiom:

if value, exists := m["key"]; exists {
   // it exists ...
}

Assigning a Value to an Uninitialized Map

If the indexing operator is also used to assign a value to a key for an uninitialized map, we get a runtime error:

panic: assignment to entry in nil map

Map Length

len() returns the number of keys.

delete()

Removes the element corresponding to the given key from the map:

delete(m, "something")

It is a no-op if the key does not exist.

make()

The make() function creates the map:

m := make(map[key_type]value_type)

Note that make() returns the map instance, not a pointer.