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,6 @@
add_executable(hash_map hash_map.cpp)
add_executable(array_hash_map_test array_hash_map_test.cpp)
add_executable(hash_map_chaining hash_map_chaining.cpp)
add_executable(hash_map_open_addressing hash_map_open_addressing.cpp)
add_executable(simple_hash simple_hash.cpp)
add_executable(built_in_hash built_in_hash.cpp)
@@ -0,0 +1,110 @@
/**
* File: array_hash_map.cpp
* Created Time: 2022-12-14
* Author: msk397 (machangxinq@gmail.com)
*/
#include "../utils/common.hpp"
/* Пара ключ-значение */
struct Pair {
public:
int key;
string val;
Pair(int key, string val) {
this->key = key;
this->val = val;
}
};
/* Хеш-таблица на основе массива */
class ArrayHashMap {
private:
vector<Pair *> buckets;
public:
ArrayHashMap() {
// Инициализировать массив, содержащий 100 корзин
buckets = vector<Pair *>(100);
}
~ArrayHashMap() {
// Освободить память
for (const auto &bucket : buckets) {
delete bucket;
}
buckets.clear();
}
/* Хеш-функция */
int hashFunc(int key) {
int index = key % 100;
return index;
}
/* Операция поиска */
string get(int key) {
int index = hashFunc(key);
Pair *pair = buckets[index];
if (pair == nullptr)
return "";
return pair->val;
}
/* Операция добавления */
void put(int key, string val) {
Pair *pair = new Pair(key, val);
int index = hashFunc(key);
buckets[index] = pair;
}
/* Операция удаления */
void remove(int key) {
int index = hashFunc(key);
// Освободить память и присвоить nullptr
delete buckets[index];
buckets[index] = nullptr;
}
/* Получить все пары ключ-значение */
vector<Pair *> pairSet() {
vector<Pair *> pairSet;
for (Pair *pair : buckets) {
if (pair != nullptr) {
pairSet.push_back(pair);
}
}
return pairSet;
}
/* Получить все ключи */
vector<int> keySet() {
vector<int> keySet;
for (Pair *pair : buckets) {
if (pair != nullptr) {
keySet.push_back(pair->key);
}
}
return keySet;
}
/* Получить все значения */
vector<string> valueSet() {
vector<string> valueSet;
for (Pair *pair : buckets) {
if (pair != nullptr) {
valueSet.push_back(pair->val);
}
}
return valueSet;
}
/* Вывести хеш-таблицу */
void print() {
for (Pair *kv : pairSet()) {
cout << kv->key << " -> " << kv->val << endl;
}
}
};
// Тестовые примеры см. в array_hash_map_test.cpp
@@ -0,0 +1,52 @@
/**
* File: array_hash_map_test.cpp
* Created Time: 2022-12-14
* Author: msk397 (machangxinq@gmail.com)
*/
#include "./array_hash_map.cpp"
/* Driver Code */
int main() {
/* Инициализация хеш-таблицы */
ArrayHashMap map = ArrayHashMap();
/* Операция добавления */
// Добавить пару (key, value) в хеш-таблицу
map.put(12836, "Сяо Ха");
map.put(15937, "Сяо Ло");
map.put(16750, "Сяо Суань");
map.put(13276, "Сяо Фа");
map.put(10583, "Сяо Я");
cout << "\nПосле добавления хеш-таблица имеет вид\nКлюч -> Значение" << endl;
map.print();
/* Операция поиска */
// Ввести в хеш-таблицу ключ key и получить значение value
string name = map.get(15937);
cout << "\nДля студенческого номера 15937 найдено имя " << name << endl;
/* Операция удаления */
// Удалить пару (key, value) из хеш-таблицы
map.remove(10583);
cout << "\nПосле удаления 10583 хеш-таблица имеет вид\nКлюч -> Значение" << endl;
map.print();
/* Обход хеш-таблицы */
cout << "\nОтдельный обход пар ключ-значение" << endl;
for (auto kv : map.pairSet()) {
cout << kv->key << " -> " << kv->val << endl;
}
cout << "\nОтдельный обход ключей" << endl;
for (auto key : map.keySet()) {
cout << key << endl;
}
cout << "\nОтдельный обход значений" << endl;
for (auto val : map.valueSet()) {
cout << val << endl;
}
return 0;
}
@@ -0,0 +1,29 @@
/**
* File: built_in_hash.cpp
* Created Time: 2023-06-21
* Author: krahets (krahets@163.com)
*/
#include "../utils/common.hpp"
/* Driver Code */
int main() {
int num = 3;
size_t hashNum = hash<int>()(num);
cout << "Хеш-значение целого числа " << num << " = " << hashNum << "\n";
bool bol = true;
size_t hashBol = hash<bool>()(bol);
cout << "Хеш-значение булева значения " << bol << " = " << hashBol << "\n";
double dec = 3.14159;
size_t hashDec = hash<double>()(dec);
cout << "Хеш-значение десятичного числа " << dec << " = " << hashDec << "\n";
string str = "Hello Algo";
size_t hashStr = hash<string>()(str);
cout << "Хеш-значение строки " << str << " = " << hashStr << "\n";
// В C++ встроенный std::hash() предоставляет вычисление хеша только для базовых типов данных
// Вычисление хеша для массивов и объектов нужно реализовывать самостоятельно
}
+46
View File
@@ -0,0 +1,46 @@
/**
* File: hash_map.cpp
* Created Time: 2022-12-14
* Author: msk397 (machangxinq@gmail.com)
*/
#include "../utils/common.hpp"
/* Driver Code */
int main() {
/* Инициализация хеш-таблицы */
unordered_map<int, string> map;
/* Операция добавления */
// Добавить пару (key, value) в хеш-таблицу
map[12836] = "Сяо Ха";
map[15937] = "Сяо Ло";
map[16750] = "Сяо Суань";
map[13276] = "Сяо Фа";
map[10583] = "Сяо Я";
cout << "\nПосле добавления хеш-таблица имеет вид\nКлюч -> Значение" << endl;
printHashMap(map);
/* Операция поиска */
// Ввести в хеш-таблицу ключ key и получить значение value
string name = map[15937];
cout << "\nДля студенческого номера 15937 найдено имя " << name << endl;
/* Операция удаления */
// Удалить пару (key, value) из хеш-таблицы
map.erase(10583);
cout << "\nПосле удаления 10583 хеш-таблица имеет вид\nКлюч -> Значение" << endl;
printHashMap(map);
/* Обход хеш-таблицы */
cout << "\nОтдельный обход пар ключ-значение" << endl;
for (auto kv : map) {
cout << kv.first << " -> " << kv.second << endl;
}
cout << "\nОбход пар Key->Value с помощью итератора" << endl;
for (auto iter = map.begin(); iter != map.end(); iter++) {
cout << iter->first << "->" << iter->second << endl;
}
return 0;
}
@@ -0,0 +1,150 @@
/**
* File: hash_map_chaining.cpp
* Created Time: 2023-06-13
* Author: krahets (krahets@163.com)
*/
#include "./array_hash_map.cpp"
/* Хеш-таблица с цепочками */
class HashMapChaining {
private:
int size; // Число пар ключ-значение
int capacity; // Вместимость хеш-таблицы
double loadThres; // Порог коэффициента загрузки для запуска расширения
int extendRatio; // Коэффициент расширения
vector<vector<Pair *>> buckets; // Массив корзин
public:
/* Конструктор */
HashMapChaining() : size(0), capacity(4), loadThres(2.0 / 3.0), extendRatio(2) {
buckets.resize(capacity);
}
/* Метод-деструктор */
~HashMapChaining() {
for (auto &bucket : buckets) {
for (Pair *pair : bucket) {
// Освободить память
delete pair;
}
}
}
/* Хеш-функция */
int hashFunc(int key) {
return key % capacity;
}
/* Коэффициент загрузки */
double loadFactor() {
return (double)size / (double)capacity;
}
/* Операция поиска */
string get(int key) {
int index = hashFunc(key);
// Обойти корзину; если найден key, вернуть соответствующее val
for (Pair *pair : buckets[index]) {
if (pair->key == key) {
return pair->val;
}
}
// Если key не найден, вернуть пустую строку
return "";
}
/* Операция добавления */
void put(int key, string val) {
// Когда коэффициент загрузки превышает порог, выполнить расширение
if (loadFactor() > loadThres) {
extend();
}
int index = hashFunc(key);
// Обойти корзину; если встретился указанный key, обновить соответствующее val и вернуть
for (Pair *pair : buckets[index]) {
if (pair->key == key) {
pair->val = val;
return;
}
}
// Если такого key нет, добавить пару ключ-значение в конец
buckets[index].push_back(new Pair(key, val));
size++;
}
/* Операция удаления */
void remove(int key) {
int index = hashFunc(key);
auto &bucket = buckets[index];
// Обойти корзину и удалить из нее пару ключ-значение
for (int i = 0; i < bucket.size(); i++) {
if (bucket[i]->key == key) {
Pair *tmp = bucket[i];
bucket.erase(bucket.begin() + i); // Удалить из него пару ключ-значение
delete tmp; // Освободить память
size--;
return;
}
}
}
/* Расширить хеш-таблицу */
void extend() {
// Временно сохранить исходную хеш-таблицу
vector<vector<Pair *>> bucketsTmp = buckets;
// Инициализация новой хеш-таблицы после расширения
capacity *= extendRatio;
buckets.clear();
buckets.resize(capacity);
size = 0;
// Перенести пары ключ-значение из исходной хеш-таблицы в новую
for (auto &bucket : bucketsTmp) {
for (Pair *pair : bucket) {
put(pair->key, pair->val);
// Освободить память
delete pair;
}
}
}
/* Вывести хеш-таблицу */
void print() {
for (auto &bucket : buckets) {
cout << "[";
for (Pair *pair : bucket) {
cout << pair->key << " -> " << pair->val << ", ";
}
cout << "]\n";
}
}
};
/* Driver Code */
int main() {
/* Инициализация хеш-таблицы */
HashMapChaining map = HashMapChaining();
/* Операция добавления */
// Добавить пару (key, value) в хеш-таблицу
map.put(12836, "Сяо Ха");
map.put(15937, "Сяо Ло");
map.put(16750, "Сяо Суань");
map.put(13276, "Сяо Фа");
map.put(10583, "Сяо Я");
cout << "\nПосле добавления хеш-таблица имеет вид\nКлюч -> Значение" << endl;
map.print();
/* Операция поиска */
// Ввести в хеш-таблицу ключ key и получить значение value
string name = map.get(13276);
cout << "\nДля студенческого номера 13276 найдено имя " << name << endl;
/* Операция удаления */
// Удалить пару (key, value) из хеш-таблицы
map.remove(12836);
cout << "\nПосле удаления 12836 хеш-таблица имеет вид\nКлюч -> Значение" << endl;
map.print();
return 0;
}
@@ -0,0 +1,171 @@
/**
* File: hash_map_open_addressing.cpp
* Created Time: 2023-06-13
* Author: krahets (krahets@163.com)
*/
#include "./array_hash_map.cpp"
/* Хеш-таблица с открытой адресацией */
class HashMapOpenAddressing {
private:
int size; // Число пар ключ-значение
int capacity = 4; // Вместимость хеш-таблицы
const double loadThres = 2.0 / 3.0; // Порог коэффициента загрузки для запуска расширения
const int extendRatio = 2; // Коэффициент расширения
vector<Pair *> buckets; // Массив корзин
Pair *TOMBSTONE = new Pair(-1, "-1"); // Удалить метку
public:
/* Конструктор */
HashMapOpenAddressing() : size(0), buckets(capacity, nullptr) {
}
/* Метод-деструктор */
~HashMapOpenAddressing() {
for (Pair *pair : buckets) {
if (pair != nullptr && pair != TOMBSTONE) {
delete pair;
}
}
delete TOMBSTONE;
}
/* Хеш-функция */
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] != nullptr) {
// Если встретился 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;
}
/* Операция поиска */
string get(int key) {
// Найти индекс корзины, соответствующий key
int index = findBucket(key);
// Если пара ключ-значение найдена, вернуть соответствующее val
if (buckets[index] != nullptr && buckets[index] != TOMBSTONE) {
return buckets[index]->val;
}
// Если пары ключ-значение не существует, вернуть пустую строку
return "";
}
/* Операция добавления */
void put(int key, string val) {
// Когда коэффициент загрузки превышает порог, выполнить расширение
if (loadFactor() > loadThres) {
extend();
}
// Найти индекс корзины, соответствующий key
int index = findBucket(key);
// Если пара ключ-значение найдена, перезаписать val и вернуть
if (buckets[index] != nullptr && buckets[index] != TOMBSTONE) {
buckets[index]->val = val;
return;
}
// Если пары ключ-значение нет, добавить ее
buckets[index] = new Pair(key, val);
size++;
}
/* Операция удаления */
void remove(int key) {
// Найти индекс корзины, соответствующий key
int index = findBucket(key);
// Если пара ключ-значение найдена, заменить ее меткой удаления
if (buckets[index] != nullptr && buckets[index] != TOMBSTONE) {
delete buckets[index];
buckets[index] = TOMBSTONE;
size--;
}
}
/* Расширить хеш-таблицу */
void extend() {
// Временно сохранить исходную хеш-таблицу
vector<Pair *> bucketsTmp = buckets;
// Инициализация новой хеш-таблицы после расширения
capacity *= extendRatio;
buckets = vector<Pair *>(capacity, nullptr);
size = 0;
// Перенести пары ключ-значение из исходной хеш-таблицы в новую
for (Pair *pair : bucketsTmp) {
if (pair != nullptr && pair != TOMBSTONE) {
put(pair->key, pair->val);
delete pair;
}
}
}
/* Вывести хеш-таблицу */
void print() {
for (Pair *pair : buckets) {
if (pair == nullptr) {
cout << "nullptr" << endl;
} else if (pair == TOMBSTONE) {
cout << "TOMBSTONE" << endl;
} else {
cout << pair->key << " -> " << pair->val << endl;
}
}
}
};
/* Driver Code */
int main() {
// Инициализация хеш-таблицы
HashMapOpenAddressing hashmap;
// Операция добавления
// Добавить пару (key, val) в хеш-таблицу
hashmap.put(12836, "Сяо Ха");
hashmap.put(15937, "Сяо Ло");
hashmap.put(16750, "Сяо Суань");
hashmap.put(13276, "Сяо Фа");
hashmap.put(10583, "Сяо Я");
cout << "\nПосле добавления хеш-таблица имеет вид\nКлюч -> Значение" << endl;
hashmap.print();
// Операция поиска
// Передать ключ key в хеш-таблицу и получить значение val
string name = hashmap.get(13276);
cout << "\nДля студенческого номера 13276 найдено имя " << name << endl;
// Операция удаления
// Удалить пару (key, val) из хеш-таблицы
hashmap.remove(16750);
cout << "\nПосле удаления 16750 хеш-таблица имеет вид\nКлюч -> Значение" << endl;
hashmap.print();
return 0;
}
@@ -0,0 +1,66 @@
/**
* File: simple_hash.cpp
* Created Time: 2023-06-21
* Author: krahets (krahets@163.com)
*/
#include "../utils/common.hpp"
/* Аддитивное хеширование */
int addHash(string key) {
long long hash = 0;
const int MODULUS = 1000000007;
for (unsigned char c : key) {
hash = (hash + (int)c) % MODULUS;
}
return (int)hash;
}
/* Мультипликативное хеширование */
int mulHash(string key) {
long long hash = 0;
const int MODULUS = 1000000007;
for (unsigned char c : key) {
hash = (31 * hash + (int)c) % MODULUS;
}
return (int)hash;
}
/* XOR-хеширование */
int xorHash(string key) {
int hash = 0;
const int MODULUS = 1000000007;
for (unsigned char c : key) {
hash ^= (int)c;
}
return hash & MODULUS;
}
/* Хеширование с циклическим сдвигом */
int rotHash(string key) {
long long hash = 0;
const int MODULUS = 1000000007;
for (unsigned char c : key) {
hash = ((hash << 4) ^ (hash >> 28) ^ (int)c) % MODULUS;
}
return (int)hash;
}
/* Driver Code */
int main() {
string key = "Hello Algo";
int hash = addHash(key);
cout << "Хеш суммы = " << hash << endl;
hash = mulHash(key);
cout << "Хеш произведения = " << hash << endl;
hash = xorHash(key);
cout << "XOR-хеш = " << hash << endl;
hash = rotHash(key);
cout << "Хеш с циклическим сдвигом = " << hash << endl;
return 0;
}