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
This commit is contained in:
Yudong Jin
2026-03-28 04:24:07 +08:00
committed by GitHub
parent 2ca570cc33
commit 772183705e
1958 changed files with 108186 additions and 0 deletions
@@ -0,0 +1,141 @@
/**
* File: array_hash_map.java
* Created Time: 2022-12-04
* Author: krahets (krahets@163.com)
*/
package chapter_hashing;
import java.util.*;
/* Пара ключ-значение */
class Pair {
public int key;
public String val;
public Pair(int key, String val) {
this.key = key;
this.val = val;
}
}
/* Хеш-таблица на основе массива */
class ArrayHashMap {
private List<Pair> buckets;
public ArrayHashMap() {
// Инициализировать массив, содержащий 100 корзин
buckets = new ArrayList<>();
for (int i = 0; i < 100; i++) {
buckets.add(null);
}
}
/* Хеш-функция */
private int hashFunc(int key) {
int index = key % 100;
return index;
}
/* Операция поиска */
public String get(int key) {
int index = hashFunc(key);
Pair pair = buckets.get(index);
if (pair == null)
return null;
return pair.val;
}
/* Операция добавления */
public void put(int key, String val) {
Pair pair = new Pair(key, val);
int index = hashFunc(key);
buckets.set(index, pair);
}
/* Операция удаления */
public void remove(int key) {
int index = hashFunc(key);
// Присвоить null, что означает удаление
buckets.set(index, null);
}
/* Получить все пары ключ-значение */
public List<Pair> pairSet() {
List<Pair> pairSet = new ArrayList<>();
for (Pair pair : buckets) {
if (pair != null)
pairSet.add(pair);
}
return pairSet;
}
/* Получить все ключи */
public List<Integer> keySet() {
List<Integer> keySet = new ArrayList<>();
for (Pair pair : buckets) {
if (pair != null)
keySet.add(pair.key);
}
return keySet;
}
/* Получить все значения */
public List<String> valueSet() {
List<String> valueSet = new ArrayList<>();
for (Pair pair : buckets) {
if (pair != null)
valueSet.add(pair.val);
}
return valueSet;
}
/* Вывести хеш-таблицу */
public void print() {
for (Pair kv : pairSet()) {
System.out.println(kv.key + " -> " + kv.val);
}
}
}
public class array_hash_map {
public static void main(String[] args) {
/* Инициализация хеш-таблицы */
ArrayHashMap map = new ArrayHashMap();
/* Операция добавления */
// Добавить пару (key, value) в хеш-таблицу
map.put(12836, "Сяо Ха");
map.put(15937, "Сяо Ло");
map.put(16750, "Сяо Суань");
map.put(13276, "Сяо Фа");
map.put(10583, "Сяо Я");
System.out.println("\nПосле добавления хеш-таблица имеет вид\nКлюч -> Значение");
map.print();
/* Операция поиска */
// Ввести в хеш-таблицу ключ key и получить значение value
String name = map.get(15937);
System.out.println("\nДля номера 15937 найдено имя " + name);
/* Операция удаления */
// Удалить пару (key, value) из хеш-таблицы
map.remove(10583);
System.out.println("\nПосле удаления 10583 хеш-таблица имеет вид\nКлюч -> Значение");
map.print();
/* Обход хеш-таблицы */
System.out.println("\nОтдельный обход пар ключ-значение");
for (Pair kv : map.pairSet()) {
System.out.println(kv.key + " -> " + kv.val);
}
System.out.println("\nОтдельный обход ключей");
for (int key : map.keySet()) {
System.out.println(key);
}
System.out.println("\nОтдельный обход значений");
for (String val : map.valueSet()) {
System.out.println(val);
}
}
}
@@ -0,0 +1,38 @@
/**
* File: built_in_hash.java
* Created Time: 2023-06-21
* Author: krahets (krahets@163.com)
*/
package chapter_hashing;
import utils.*;
import java.util.*;
public class built_in_hash {
public static void main(String[] args) {
int num = 3;
int hashNum = Integer.hashCode(num);
System.out.println("Хеш-значение целого числа " + num + " = " + hashNum);
boolean bol = true;
int hashBol = Boolean.hashCode(bol);
System.out.println("Хеш-значение булева значения " + bol + " = " + hashBol);
double dec = 3.14159;
int hashDec = Double.hashCode(dec);
System.out.println("Хеш-значение десятичного числа " + dec + " = " + hashDec);
String str = "Hello Algo";
int hashStr = str.hashCode();
System.out.println("Хеш-значение строки " + str + " = " + hashStr);
Object[] arr = { 12836, "Сяо Ха" };
int hashTup = Arrays.hashCode(arr);
System.out.println("Хеш-значение массива " + Arrays.toString(arr) + " = " + hashTup);
ListNode obj = new ListNode(0);
int hashObj = obj.hashCode();
System.out.println("Хеш-значение объекта узла " + obj + " = " + hashObj);
}
}
@@ -0,0 +1,52 @@
/**
* File: hash_map.java
* Created Time: 2022-12-04
* Author: krahets (krahets@163.com)
*/
package chapter_hashing;
import java.util.*;
import utils.*;
public class hash_map {
public static void main(String[] args) {
/* Инициализация хеш-таблицы */
Map<Integer, String> map = new HashMap<>();
/* Операция добавления */
// Добавить пару (key, value) в хеш-таблицу
map.put(12836, "Сяо Ха");
map.put(15937, "Сяо Ло");
map.put(16750, "Сяо Суань");
map.put(13276, "Сяо Фа");
map.put(10583, "Сяо Я");
System.out.println("\nПосле добавления хеш-таблица имеет вид\nКлюч -> Значение");
PrintUtil.printHashMap(map);
/* Операция поиска */
// Ввести в хеш-таблицу ключ key и получить значение value
String name = map.get(15937);
System.out.println("\nДля номера 15937 найдено имя " + name);
/* Операция удаления */
// Удалить пару (key, value) из хеш-таблицы
map.remove(10583);
System.out.println("\nПосле удаления 10583 хеш-таблица имеет вид\nКлюч -> Значение");
PrintUtil.printHashMap(map);
/* Обход хеш-таблицы */
System.out.println("\nОтдельный обход пар ключ-значение");
for (Map.Entry<Integer, String> kv : map.entrySet()) {
System.out.println(kv.getKey() + " -> " + kv.getValue());
}
System.out.println("\nОтдельный обход ключей");
for (int key : map.keySet()) {
System.out.println(key);
}
System.out.println("\nОтдельный обход значений");
for (String val : map.values()) {
System.out.println(val);
}
}
}
@@ -0,0 +1,148 @@
/**
* File: hash_map_chaining.java
* Created Time: 2023-06-13
* Author: krahets (krahets@163.com)
*/
package chapter_hashing;
import java.util.ArrayList;
import java.util.List;
/* Хеш-таблица с цепочками */
class HashMapChaining {
int size; // Число пар ключ-значение
int capacity; // Вместимость хеш-таблицы
double loadThres; // Порог коэффициента загрузки для запуска расширения
int extendRatio; // Коэффициент расширения
List<List<Pair>> buckets; // Массив корзин
/* Конструктор */
public HashMapChaining() {
size = 0;
capacity = 4;
loadThres = 2.0 / 3.0;
extendRatio = 2;
buckets = new ArrayList<>(capacity);
for (int i = 0; i < capacity; i++) {
buckets.add(new ArrayList<>());
}
}
/* Хеш-функция */
int hashFunc(int key) {
return key % capacity;
}
/* Коэффициент загрузки */
double loadFactor() {
return (double) size / capacity;
}
/* Операция поиска */
String get(int key) {
int index = hashFunc(key);
List<Pair> bucket = buckets.get(index);
// Обойти корзину; если найден key, вернуть соответствующее val
for (Pair pair : bucket) {
if (pair.key == key) {
return pair.val;
}
}
// Если key не найден, вернуть null
return null;
}
/* Операция добавления */
void put(int key, String val) {
// Когда коэффициент загрузки превышает порог, выполнить расширение
if (loadFactor() > loadThres) {
extend();
}
int index = hashFunc(key);
List<Pair> bucket = buckets.get(index);
// Обойти корзину; если встретился указанный key, обновить соответствующее val и вернуть
for (Pair pair : bucket) {
if (pair.key == key) {
pair.val = val;
return;
}
}
// Если такого key нет, добавить пару ключ-значение в конец
Pair pair = new Pair(key, val);
bucket.add(pair);
size++;
}
/* Операция удаления */
void remove(int key) {
int index = hashFunc(key);
List<Pair> bucket = buckets.get(index);
// Обойти корзину и удалить из нее пару ключ-значение
for (Pair pair : bucket) {
if (pair.key == key) {
bucket.remove(pair);
size--;
break;
}
}
}
/* Расширить хеш-таблицу */
void extend() {
// Временно сохранить исходную хеш-таблицу
List<List<Pair>> bucketsTmp = buckets;
// Инициализация новой хеш-таблицы после расширения
capacity *= extendRatio;
buckets = new ArrayList<>(capacity);
for (int i = 0; i < capacity; i++) {
buckets.add(new ArrayList<>());
}
size = 0;
// Перенести пары ключ-значение из исходной хеш-таблицы в новую
for (List<Pair> bucket : bucketsTmp) {
for (Pair pair : bucket) {
put(pair.key, pair.val);
}
}
}
/* Вывести хеш-таблицу */
void print() {
for (List<Pair> bucket : buckets) {
List<String> res = new ArrayList<>();
for (Pair pair : bucket) {
res.add(pair.key + " -> " + pair.val);
}
System.out.println(res);
}
}
}
public class hash_map_chaining {
public static void main(String[] args) {
/* Инициализация хеш-таблицы */
HashMapChaining map = new HashMapChaining();
/* Операция добавления */
// Добавить пару (key, value) в хеш-таблицу
map.put(12836, "Сяо Ха");
map.put(15937, "Сяо Ло");
map.put(16750, "Сяо Суань");
map.put(13276, "Сяо Фа");
map.put(10583, "Сяо Я");
System.out.println("\nПосле добавления хеш-таблица имеет вид\nКлюч -> Значение");
map.print();
/* Операция поиска */
// Ввести в хеш-таблицу ключ key и получить значение value
String name = map.get(13276);
System.out.println("\nДля номера 13276 найдено имя " + name);
/* Операция удаления */
// Удалить пару (key, value) из хеш-таблицы
map.remove(12836);
System.out.println("\nПосле удаления 12836 хеш-таблица имеет вид\nКлюч -> Значение");
map.print();
}
}
@@ -0,0 +1,158 @@
/**
* File: hash_map_open_addressing.java
* Created Time: 2023-06-13
* Author: krahets (krahets@163.com)
*/
package chapter_hashing;
/* Хеш-таблица с открытой адресацией */
class HashMapOpenAddressing {
private int size; // Число пар ключ-значение
private int capacity = 4; // Вместимость хеш-таблицы
private final double loadThres = 2.0 / 3.0; // Порог коэффициента загрузки для запуска расширения
private final int extendRatio = 2; // Коэффициент расширения
private Pair[] buckets; // Массив корзин
private final Pair TOMBSTONE = new Pair(-1, "-1"); // Удалить метку
/* Конструктор */
public HashMapOpenAddressing() {
size = 0;
buckets = new Pair[capacity];
}
/* Хеш-функция */
private int hashFunc(int key) {
return key % capacity;
}
/* Коэффициент загрузки */
private double loadFactor() {
return (double) size / capacity;
}
/* Найти индекс корзины, соответствующий key */
private int findBucket(int key) {
int index = hashFunc(key);
int firstTombstone = -1;
// Выполнять линейное пробирование и завершить при встрече с пустой корзиной
while (buckets[index] != null) {
// Если встретился key, вернуть соответствующий индекс корзины
if (buckets[index].key == key) {
// Если ранее встретилась метка удаления, переместить пару ключ-значение на этот индекс
if (firstTombstone != -1) {
buckets[firstTombstone] = buckets[index];
buckets[index] = TOMBSTONE;
return firstTombstone; // Вернуть индекс корзины после перемещения
}
return index; // Вернуть индекс корзины
}
// Записать первую встретившуюся метку удаления
if (firstTombstone == -1 && buckets[index] == TOMBSTONE) {
firstTombstone = index;
}
// Вычислить индекс корзины; при выходе за конец вернуться к началу
index = (index + 1) % capacity;
}
// Если key не существует, вернуть индекс точки добавления
return firstTombstone == -1 ? index : firstTombstone;
}
/* Операция поиска */
public String get(int key) {
// Найти индекс корзины, соответствующий key
int index = findBucket(key);
// Если пара ключ-значение найдена, вернуть соответствующее val
if (buckets[index] != null && buckets[index] != TOMBSTONE) {
return buckets[index].val;
}
// Если пары ключ-значение не существует, вернуть null
return null;
}
/* Операция добавления */
public void put(int key, String val) {
// Когда коэффициент загрузки превышает порог, выполнить расширение
if (loadFactor() > loadThres) {
extend();
}
// Найти индекс корзины, соответствующий key
int index = findBucket(key);
// Если пара ключ-значение найдена, перезаписать val и вернуть
if (buckets[index] != null && buckets[index] != TOMBSTONE) {
buckets[index].val = val;
return;
}
// Если пары ключ-значение нет, добавить ее
buckets[index] = new Pair(key, val);
size++;
}
/* Операция удаления */
public void remove(int key) {
// Найти индекс корзины, соответствующий key
int index = findBucket(key);
// Если пара ключ-значение найдена, заменить ее меткой удаления
if (buckets[index] != null && buckets[index] != TOMBSTONE) {
buckets[index] = TOMBSTONE;
size--;
}
}
/* Расширить хеш-таблицу */
private void extend() {
// Временно сохранить исходную хеш-таблицу
Pair[] bucketsTmp = buckets;
// Инициализация новой хеш-таблицы после расширения
capacity *= extendRatio;
buckets = new Pair[capacity];
size = 0;
// Перенести пары ключ-значение из исходной хеш-таблицы в новую
for (Pair pair : bucketsTmp) {
if (pair != null && pair != TOMBSTONE) {
put(pair.key, pair.val);
}
}
}
/* Вывести хеш-таблицу */
public void print() {
for (Pair pair : buckets) {
if (pair == null) {
System.out.println("null");
} else if (pair == TOMBSTONE) {
System.out.println("TOMBSTONE");
} else {
System.out.println(pair.key + " -> " + pair.val);
}
}
}
}
public class hash_map_open_addressing {
public static void main(String[] args) {
// Инициализация хеш-таблицы
HashMapOpenAddressing hashmap = new HashMapOpenAddressing();
// Операция добавления
// Добавить пару (key, val) в хеш-таблицу
hashmap.put(12836, "Сяо Ха");
hashmap.put(15937, "Сяо Ло");
hashmap.put(16750, "Сяо Суань");
hashmap.put(13276, "Сяо Фа");
hashmap.put(10583, "Сяо Я");
System.out.println("\nПосле добавления хеш-таблица имеет вид\nКлюч -> Значение");
hashmap.print();
// Операция поиска
// Передать ключ key в хеш-таблицу и получить значение val
String name = hashmap.get(13276);
System.out.println("\nДля номера 13276 найдено имя " + name);
// Операция удаления
// Удалить пару (key, val) из хеш-таблицы
hashmap.remove(16750);
System.out.println("\nПосле удаления 16750 хеш-таблица имеет вид\nКлюч -> Значение");
hashmap.print();
}
}
@@ -0,0 +1,65 @@
/**
* File: simple_hash.java
* Created Time: 2023-06-21
* Author: krahets (krahets@163.com)
*/
package chapter_hashing;
public class simple_hash {
/* Аддитивное хеширование */
static int addHash(String key) {
long hash = 0;
final int MODULUS = 1000000007;
for (char c : key.toCharArray()) {
hash = (hash + (int) c) % MODULUS;
}
return (int) hash;
}
/* Мультипликативное хеширование */
static int mulHash(String key) {
long hash = 0;
final int MODULUS = 1000000007;
for (char c : key.toCharArray()) {
hash = (31 * hash + (int) c) % MODULUS;
}
return (int) hash;
}
/* XOR-хеширование */
static int xorHash(String key) {
int hash = 0;
final int MODULUS = 1000000007;
for (char c : key.toCharArray()) {
hash ^= (int) c;
}
return hash & MODULUS;
}
/* Хеширование с циклическим сдвигом */
static int rotHash(String key) {
long hash = 0;
final int MODULUS = 1000000007;
for (char c : key.toCharArray()) {
hash = ((hash << 4) ^ (hash >> 28) ^ (int) c) % MODULUS;
}
return (int) hash;
}
public static void main(String[] args) {
String key = "Hello Algo";
int hash = addHash(key);
System.out.println("Хеш-сумма сложением = " + hash);
hash = mulHash(key);
System.out.println("Хеш-сумма умножением = " + hash);
hash = xorHash(key);
System.out.println("Хеш-сумма XOR = " + hash);
hash = rotHash(key);
System.out.println("Хеш-сумма с циклическим сдвигом = " + hash);
}
}