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,134 @@
/**
* File: array_hash_map.cs
* Created Time: 2022-12-23
* Author: haptear (haptear@hotmail.com)
*/
namespace hello_algo.chapter_hashing;
/* Пара ключ-значение int->string */
class Pair(int key, string val) {
public int key = key;
public string val = val;
}
/* Хеш-таблица на основе массива */
class ArrayHashMap {
List<Pair?> buckets;
public ArrayHashMap() {
// Инициализировать массив, содержащий 100 корзин
buckets = [];
for (int i = 0; i < 100; i++) {
buckets.Add(null);
}
}
/* Хеш-функция */
int HashFunc(int key) {
int index = key % 100;
return index;
}
/* Операция поиска */
public string? Get(int key) {
int index = HashFunc(key);
Pair? pair = buckets[index];
if (pair == null) return null;
return pair.val;
}
/* Операция добавления */
public void Put(int key, string val) {
Pair pair = new(key, val);
int index = HashFunc(key);
buckets[index] = pair;
}
/* Операция удаления */
public void Remove(int key) {
int index = HashFunc(key);
// Присвоить null, что означает удаление
buckets[index] = null;
}
/* Получить все пары ключ-значение */
public List<Pair> PairSet() {
List<Pair> pairSet = [];
foreach (Pair? pair in buckets) {
if (pair != null)
pairSet.Add(pair);
}
return pairSet;
}
/* Получить все ключи */
public List<int> KeySet() {
List<int> keySet = [];
foreach (Pair? pair in buckets) {
if (pair != null)
keySet.Add(pair.key);
}
return keySet;
}
/* Получить все значения */
public List<string> ValueSet() {
List<string> valueSet = [];
foreach (Pair? pair in buckets) {
if (pair != null)
valueSet.Add(pair.val);
}
return valueSet;
}
/* Вывести хеш-таблицу */
public void Print() {
foreach (Pair kv in PairSet()) {
Console.WriteLine(kv.key + " -> " + kv.val);
}
}
}
public class array_hash_map {
[Test]
public void Test() {
/* Инициализация хеш-таблицы */
ArrayHashMap map = new();
/* Операция добавления */
// Добавить пару (key, value) в хеш-таблицу
map.Put(12836, "Сяо Ха");
map.Put(15937, "Сяо Ло");
map.Put(16750, "Сяо Суань");
map.Put(13276, "Сяо Фа");
map.Put(10583, "Сяо Я");
Console.WriteLine("\nПосле добавления хеш-таблица имеет вид\nКлюч -> Значение");
map.Print();
/* Операция поиска */
// Ввести в хеш-таблицу ключ key и получить значение value
string? name = map.Get(15937);
Console.WriteLine("\nДля номера 15937 найдено имя " + name);
/* Операция удаления */
// Удалить пару (key, value) из хеш-таблицы
map.Remove(10583);
Console.WriteLine("\nПосле удаления 10583 хеш-таблица имеет вид\nКлюч -> Значение");
map.Print();
/* Обход хеш-таблицы */
Console.WriteLine("\nОтдельный обход пар ключ-значение");
foreach (Pair kv in map.PairSet()) {
Console.WriteLine(kv.key + " -> " + kv.val);
}
Console.WriteLine("\nОтдельный обход ключей");
foreach (int key in map.KeySet()) {
Console.WriteLine(key);
}
Console.WriteLine("\nОтдельный обход значений");
foreach (string val in map.ValueSet()) {
Console.WriteLine(val);
}
}
}
@@ -0,0 +1,36 @@
/**
* File: built_in_hash.cs
* Created Time: 2023-06-26
* Author: hpstory (hpstory1024@163.com)
*/
namespace hello_algo.chapter_hashing;
public class built_in_hash {
[Test]
public void Test() {
int num = 3;
int hashNum = num.GetHashCode();
Console.WriteLine("Хеш-значение целого числа " + num + " = " + hashNum);
bool bol = true;
int hashBol = bol.GetHashCode();
Console.WriteLine("Хеш-значение булева значения " + bol + " = " + hashBol);
double dec = 3.14159;
int hashDec = dec.GetHashCode();
Console.WriteLine("Хеш-значение десятичного числа " + dec + " = " + hashDec);
string str = "Hello Algo";
int hashStr = str.GetHashCode();
Console.WriteLine("Хеш-значение строки " + str + " = " + hashStr);
object[] arr = [12836, "Сяо Ха"];
int hashTup = arr.GetHashCode();
Console.WriteLine("Хеш-значение массива [" + string.Join(", ", arr) + "] = " + hashTup);
ListNode obj = new(0);
int hashObj = obj.GetHashCode();
Console.WriteLine("Хеш-значение объекта узла " + obj + " = " + hashObj);
}
}
@@ -0,0 +1,51 @@
/**
* File: hash_map.cs
* Created Time: 2022-12-23
* Author: haptear (haptear@hotmail.com)
*/
namespace hello_algo.chapter_hashing;
public class hash_map {
[Test]
public void Test() {
/* Инициализация хеш-таблицы */
Dictionary<int, string> map = new() {
/* Операция добавления */
// Добавить пару (key, value) в хеш-таблицу
{ 12836, "Сяо Ха" },
{ 15937, "Сяо Ло" },
{ 16750, "Сяо Суань" },
{ 13276, "Сяо Фа" },
{ 10583, "Сяо Я" }
};
Console.WriteLine("\nПосле добавления хеш-таблица имеет вид\nКлюч -> Значение");
PrintUtil.PrintHashMap(map);
/* Операция поиска */
// Ввести в хеш-таблицу ключ key и получить значение value
string name = map[15937];
Console.WriteLine("\nДля номера 15937 найдено имя " + name);
/* Операция удаления */
// Удалить пару (key, value) из хеш-таблицы
map.Remove(10583);
Console.WriteLine("\nПосле удаления 10583 хеш-таблица имеет вид\nКлюч -> Значение");
PrintUtil.PrintHashMap(map);
/* Обход хеш-таблицы */
Console.WriteLine("\nОтдельный обход пар ключ-значение");
foreach (var kv in map) {
Console.WriteLine(kv.Key + " -> " + kv.Value);
}
Console.WriteLine("\nОтдельный обход ключей");
foreach (int key in map.Keys) {
Console.WriteLine(key);
}
Console.WriteLine("\nОтдельный обход значений");
foreach (string val in map.Values) {
Console.WriteLine(val);
}
}
}
@@ -0,0 +1,144 @@
/**
* File: hash_map_chaining.cs
* Created Time: 2023-06-26
* Author: hpstory (hpstory1024@163.com)
*/
namespace hello_algo.chapter_hashing;
/* Хеш-таблица с цепочками */
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 List<List<Pair>>(capacity);
for (int i = 0; i < capacity; i++) {
buckets.Add([]);
}
}
/* Хеш-функция */
int HashFunc(int key) {
return key % capacity;
}
/* Коэффициент загрузки */
double LoadFactor() {
return (double)size / capacity;
}
/* Операция поиска */
public string? Get(int key) {
int index = HashFunc(key);
// Обойти корзину; если найден key, вернуть соответствующее val
foreach (Pair pair in buckets[index]) {
if (pair.key == key) {
return pair.val;
}
}
// Если key не найден, вернуть null
return null;
}
/* Операция добавления */
public void Put(int key, string val) {
// Когда коэффициент загрузки превышает порог, выполнить расширение
if (LoadFactor() > loadThres) {
Extend();
}
int index = HashFunc(key);
// Обойти корзину; если встретился указанный key, обновить соответствующее val и вернуть
foreach (Pair pair in buckets[index]) {
if (pair.key == key) {
pair.val = val;
return;
}
}
// Если такого key нет, добавить пару ключ-значение в конец
buckets[index].Add(new Pair(key, val));
size++;
}
/* Операция удаления */
public void Remove(int key) {
int index = HashFunc(key);
// Обойти корзину и удалить из нее пару ключ-значение
foreach (Pair pair in buckets[index].ToList()) {
if (pair.key == key) {
buckets[index].Remove(pair);
size--;
break;
}
}
}
/* Расширить хеш-таблицу */
void Extend() {
// Временно сохранить исходную хеш-таблицу
List<List<Pair>> bucketsTmp = buckets;
// Инициализация новой хеш-таблицы после расширения
capacity *= extendRatio;
buckets = new List<List<Pair>>(capacity);
for (int i = 0; i < capacity; i++) {
buckets.Add([]);
}
size = 0;
// Перенести пары ключ-значение из исходной хеш-таблицы в новую
foreach (List<Pair> bucket in bucketsTmp) {
foreach (Pair pair in bucket) {
Put(pair.key, pair.val);
}
}
}
/* Вывести хеш-таблицу */
public void Print() {
foreach (List<Pair> bucket in buckets) {
List<string> res = [];
foreach (Pair pair in bucket) {
res.Add(pair.key + " -> " + pair.val);
}
foreach (string kv in res) {
Console.WriteLine(kv);
}
}
}
}
public class hash_map_chaining {
[Test]
public void Test() {
/* Инициализация хеш-таблицы */
HashMapChaining map = new();
/* Операция добавления */
// Добавить пару (key, value) в хеш-таблицу
map.Put(12836, "Сяо Ха");
map.Put(15937, "Сяо Ло");
map.Put(16750, "Сяо Суань");
map.Put(13276, "Сяо Фа");
map.Put(10583, "Сяо Я");
Console.WriteLine("\nПосле добавления хеш-таблица имеет вид\nКлюч -> Значение");
map.Print();
/* Операция поиска */
// Ввести в хеш-таблицу ключ key и получить значение value
string? name = map.Get(13276);
Console.WriteLine("\nДля номера 13276 найдено имя " + name);
/* Операция удаления */
// Удалить пару (key, value) из хеш-таблицы
map.Remove(12836);
Console.WriteLine("\nПосле удаления 12836 хеш-таблица имеет вид\nКлюч -> Значение");
map.Print();
}
}
@@ -0,0 +1,159 @@
/**
* File: hash_map_open_addressing.cs
* Created Time: 2023-06-26
* Author: hpstory (hpstory1024@163.com)
*/
namespace hello_algo.chapter_hashing;
/* Хеш-таблица с открытой адресацией */
class HashMapOpenAddressing {
int size; // Число пар ключ-значение
int capacity = 4; // Вместимость хеш-таблицы
double loadThres = 2.0 / 3.0; // Порог коэффициента загрузки для запуска расширения
int extendRatio = 2; // Коэффициент расширения
Pair[] buckets; // Массив корзин
Pair TOMBSTONE = new(-1, "-1"); // Удалить метку
/* Конструктор */
public HashMapOpenAddressing() {
size = 0;
buckets = new Pair[capacity];
}
/* Хеш-функция */
int HashFunc(int key) {
return key % capacity;
}
/* Коэффициент загрузки */
double LoadFactor() {
return (double)size / capacity;
}
/* Найти индекс корзины, соответствующий key */
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--;
}
}
/* Расширить хеш-таблицу */
void Extend() {
// Временно сохранить исходную хеш-таблицу
Pair[] bucketsTmp = buckets;
// Инициализация новой хеш-таблицы после расширения
capacity *= extendRatio;
buckets = new Pair[capacity];
size = 0;
// Перенести пары ключ-значение из исходной хеш-таблицы в новую
foreach (Pair pair in bucketsTmp) {
if (pair != null && pair != TOMBSTONE) {
Put(pair.key, pair.val);
}
}
}
/* Вывести хеш-таблицу */
public void Print() {
foreach (Pair pair in buckets) {
if (pair == null) {
Console.WriteLine("null");
} else if (pair == TOMBSTONE) {
Console.WriteLine("TOMBSTONE");
} else {
Console.WriteLine(pair.key + " -> " + pair.val);
}
}
}
}
public class hash_map_open_addressing {
[Test]
public void Test() {
/* Инициализация хеш-таблицы */
HashMapOpenAddressing map = new();
/* Операция добавления */
// Добавить пару (key, value) в хеш-таблицу
map.Put(12836, "Сяо Ха");
map.Put(15937, "Сяо Ло");
map.Put(16750, "Сяо Суань");
map.Put(13276, "Сяо Фа");
map.Put(10583, "Сяо Я");
Console.WriteLine("\nПосле добавления хеш-таблица имеет вид\nКлюч -> Значение");
map.Print();
/* Операция поиска */
// Ввести в хеш-таблицу ключ key и получить значение value
string? name = map.Get(13276);
Console.WriteLine("\nДля номера 13276 найдено имя " + name);
/* Операция удаления */
// Удалить пару (key, value) из хеш-таблицы
map.Remove(16750);
Console.WriteLine("\nПосле удаления 16750 хеш-таблица имеет вид\nКлюч -> Значение");
map.Print();
}
}
@@ -0,0 +1,66 @@
/**
* File: simple_hash.cs
* Created Time: 2023-06-26
* Author: hpstory (hpstory1024@163.com)
*/
namespace hello_algo.chapter_hashing;
public class simple_hash {
/* Аддитивное хеширование */
int AddHash(string key) {
long hash = 0;
const int MODULUS = 1000000007;
foreach (char c in key) {
hash = (hash + c) % MODULUS;
}
return (int)hash;
}
/* Мультипликативное хеширование */
int MulHash(string key) {
long hash = 0;
const int MODULUS = 1000000007;
foreach (char c in key) {
hash = (31 * hash + c) % MODULUS;
}
return (int)hash;
}
/* XOR-хеширование */
int XorHash(string key) {
int hash = 0;
const int MODULUS = 1000000007;
foreach (char c in key) {
hash ^= c;
}
return hash & MODULUS;
}
/* Хеширование с циклическим сдвигом */
int RotHash(string key) {
long hash = 0;
const int MODULUS = 1000000007;
foreach (char c in key) {
hash = ((hash << 4) ^ (hash >> 28) ^ c) % MODULUS;
}
return (int)hash;
}
[Test]
public void Test() {
string key = "Hello Algo";
int hash = AddHash(key);
Console.WriteLine("Хеш-сумма сложением = " + hash);
hash = MulHash(key);
Console.WriteLine("Хеш-сумма умножением = " + hash);
hash = XorHash(key);
Console.WriteLine("Хеш-сумма XOR = " + hash);
hash = RotHash(key);
Console.WriteLine("Хеш-сумма с циклическим сдвигом = " + hash);
}
}