map یک نوع ساختمان داده برای ذخیره ی داده هایی هست که به صورت key/value یا کلید/مقدار هستند. در داده های key/value ما یک مقدار (value) را به یک کلید (key)  نسبت میدهیم و بعدا با استفاده از کلید (key) میتونیم به مقدار آن دسترسی پیدا کنیم.

برای تعریف مپ باید از کلمه کلیدی map استفاده کنیم:

var ftruits map[string]string

داخل کروشه [ ] نوع داده ی کلیدها و بعد از کروشه نوع داده ی مقدارها را مشخص میکنیم. در مثال بالا ما یک مپ ایجاد کردیم که کلید و مقدار ها میتوانند از نوع رشته ای (متنی) باشند.

نوع داده ی کلید ها باید مقایسه پذیر باشد. نمیتوان از نوع داده ای که با عملگر == قابل مقایسه نیست, به عنوان نوع کلید (key) استفاده کرد. برای مثال نمیتوان از نوع slice به عنوان key استفاده کرد.

var m map[string]int

در مثال بالا نوع داده ی کلیدها string و نوع داده ی مقادیر int است.

نوع داده ی map از نوع رفرنس تایپ است (شبیه اشاره‌گر یا slice ), بعد از تعریف یک مپ (declare) مقدار صفر آن (zero value) برابر با nil خواهد بود, در این شرایط شما میتوانید یک مقدار را از مپ بخوانید اما نمیتوانید روی map چیزی بنویسید! به مثال زیر دقت کنید:

package main

import "fmt"

func main() {
	var countryCodes map[string]int
	
	fmt.Println(countryCodes)
	fmt.Println(countryCodes == nil)
	fmt.Println(countryCodes["germany"])
	fmt.Println(countryCodes["iran"])
}

// output:
// map[]
// true
// 0
// 0

در صورتی که مقدار یک map برابر با nil باشد، خواندن مقدار از آن باعث می‌شود مقدار پیش‌فرض (zero value) متناظر با نوع value به شما بازگردانده شود؛ در این حالت تلاش برای نوشتن بر روی map منجر به بروز خطای زمان اجرا (runtime panic) خواهد شد. بنابراین هرگز نباید قبل از تخصیص حافظه (initialize کردن map)، اقدام به نوشتن داده در آن کنید.

تا اینجا با تعریف کردن map آشنا شدیم و فهمیدیم که مقدار اولیه آن nil است. برای تخصیص حافظه به یک map دو روش وجود دارد:

1. مپ لیترال

2. استفاده از دستور make

package main

import "fmt"

func main(){
	// 1. using map literal
	countryCodes_1 := map[string]int{"iran": 98, "germany": 49}
	
	fmt.Println(countryCodes_1)

	// 2. using make to allocate memory for map
	countryCodes_2 := make(map[string]int)
	countryCodes_2["iran"] = 98
	countryCodes_2["germany"] = 49
	
	fmt.Println(countryCodes_2)
}

// output:
// map[germany:49 iran:98]
// map[germany:49 iran:98]

مپ لیترال به این معنی هست که شما با استفاده از کلمه کلیدی map یک مقدار از نوع map ایجاد کنید و آن را درون متغیر خود قرار دهید.