Add ru version (#1865)

* Add Russian docs site baseline * Add Russian localized codebase * Polish Russian code wording * Update ru code translation. * Update code translation and chapter covers. * Fix pythontutor extraction. * Add README and landing page. * placeholder of profiles * Use figures of English version * Remove chapter paperbook
2026-08-29 19:37:14 +00:00 · 2026-03-28 04:24:07 +08:00
parent 2ca570cc33
commit 772183705e
1958 changed files with 108186 additions and 0 deletions
@@ -0,0 +1,126 @@
+// File: hash_map_open_addressing.go
+// Created Time: 2023-06-23
+// Author: Reanon (793584285@qq.com)
+
+package chapter_hashing
+
+import (
+	"fmt"
+)
+
+/* Хеш-таблица с открытой адресацией */
+type hashMapOpenAddressing struct {
+	size        int     // Число пар ключ-значение
+	capacity    int     // Вместимость хеш-таблицы
+	loadThres   float64 // Порог коэффициента загрузки для запуска расширения
+	extendRatio int     // Коэффициент расширения
+	buckets     []*pair // Массив корзин
+	TOMBSTONE   *pair   // Удалить метку
+}
+
+/* Конструктор */
+func newHashMapOpenAddressing() *hashMapOpenAddressing {
+	return &hashMapOpenAddressing{
+		size:        0,
+		capacity:    4,
+		loadThres:   2.0 / 3.0,
+		extendRatio: 2,
+		buckets:     make([]*pair, 4),
+		TOMBSTONE:   &pair{-1, "-1"},
+	}
+}
+
+/* Хеш-функция */
+func (h *hashMapOpenAddressing) hashFunc(key int) int {
+	return key % h.capacity // Вычислить хеш-значение по ключу
+}
+
+/* Коэффициент загрузки */
+func (h *hashMapOpenAddressing) loadFactor() float64 {
+	return float64(h.size) / float64(h.capacity) // Вычислить текущий коэффициент загрузки
+}
+
+/* Найти индекс корзины, соответствующий key */
+func (h *hashMapOpenAddressing) findBucket(key int) int {
+	index := h.hashFunc(key) // Получить начальный индекс
+	firstTombstone := -1     // Запомнить положение первого TOMBSTONE
+	for h.buckets[index] != nil {
+		if h.buckets[index].key == key {
+			if firstTombstone != -1 {
+				// Если ранее встретилась метка удаления, переместить пару ключ-значение на этот индекс
+				h.buckets[firstTombstone] = h.buckets[index]
+				h.buckets[index] = h.TOMBSTONE
+				return firstTombstone // Вернуть индекс корзины после перемещения
+			}
+			return index // Вернуть найденный индекс
+		}
+		if firstTombstone == -1 && h.buckets[index] == h.TOMBSTONE {
+			firstTombstone = index // Запомнить положение первой метки удаления
+		}
+		index = (index + 1) % h.capacity // Линейное пробирование: при выходе за хвост вернуться к началу
+	}
+	// Если key не существует, вернуть индекс точки добавления
+	if firstTombstone != -1 {
+		return firstTombstone
+	}
+	return index
+}
+
+/* Операция поиска */
+func (h *hashMapOpenAddressing) get(key int) string {
+	index := h.findBucket(key) // Найти индекс корзины, соответствующий key
+	if h.buckets[index] != nil && h.buckets[index] != h.TOMBSTONE {
+		return h.buckets[index].val // Если пара ключ-значение найдена, вернуть соответствующее val
+	}
+	return "" // Если пара ключ-значение не существует, вернуть ""
+}
+
+/* Операция добавления */
+func (h *hashMapOpenAddressing) put(key int, val string) {
+	if h.loadFactor() > h.loadThres {
+		h.extend() // Когда коэффициент загрузки превышает порог, выполнить расширение
+	}
+	index := h.findBucket(key) // Найти индекс корзины, соответствующий key
+	if h.buckets[index] == nil || h.buckets[index] == h.TOMBSTONE {
+		h.buckets[index] = &pair{key, val} // Если пары ключ-значение нет, добавить ее
+		h.size++
+	} else {
+		h.buckets[index].val = val // Если пара ключ-значение найдена, перезаписать val
+	}
+}
+
+/* Операция удаления */
+func (h *hashMapOpenAddressing) remove(key int) {
+	index := h.findBucket(key) // Найти индекс корзины, соответствующий key
+	if h.buckets[index] != nil && h.buckets[index] != h.TOMBSTONE {
+		h.buckets[index] = h.TOMBSTONE // Если пара ключ-значение найдена, заменить ее меткой удаления
+		h.size--
+	}
+}
+
+/* Расширить хеш-таблицу */
+func (h *hashMapOpenAddressing) extend() {
+	oldBuckets := h.buckets               // Временно сохранить исходную хеш-таблицу
+	h.capacity *= h.extendRatio           // Обновить емкость
+	h.buckets = make([]*pair, h.capacity) // Инициализация новой хеш-таблицы после расширения
+	h.size = 0                            // Сбросить размер
+	// Перенести пары ключ-значение из исходной хеш-таблицы в новую
+	for _, pair := range oldBuckets {
+		if pair != nil && pair != h.TOMBSTONE {
+			h.put(pair.key, pair.val)
+		}
+	}
+}
+
+/* Вывести хеш-таблицу */
+func (h *hashMapOpenAddressing) print() {
+	for _, pair := range h.buckets {
+		if pair == nil {
+			fmt.Println("nil")
+		} else if pair == h.TOMBSTONE {
+			fmt.Println("TOMBSTONE")
+		} else {
+			fmt.Printf("%d -> %s\n", pair.key, pair.val)
+		}
+	}
+}