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

ru/codes/cpp/chapter_searching/CMakeLists.txt

@@ -0,0 +1,4 @@
+add_executable(binary_search binary_search.cpp)
+add_executable(binary_search_insertion binary_search_insertion.cpp)
+add_executable(binary_search_edge binary_search_edge.cpp)
+add_executable(two_sum two_sum.cpp)

ru/codes/cpp/chapter_searching/binary_search.cpp

@@ -0,0 +1,59 @@
+/**
+ * File: binary_search.cpp
+ * Created Time: 2022-11-25
+ * Author: krahets (krahets@163.com)
+ */
+
+#include "../utils/common.hpp"
+
+/* Бинарный поиск (двусторонне замкнутый интервал) */
+int binarySearch(vector<int> &nums, int target) {
+    // Инициализировать двусторонне замкнутый интервал [0, n-1], то есть i и j указывают на первый и последний элементы массива соответственно
+    int i = 0, j = nums.size() - 1;
+    // Цикл завершается, когда диапазон поиска пуст (при i > j диапазон пуст)
+    while (i <= j) {
+        int m = i + (j - i) / 2; // Вычислить индекс середины m
+        if (nums[m] < target)    // Это означает, что target находится в интервале [m+1, j]
+            i = m + 1;
+        else if (nums[m] > target) // Это означает, что target находится в интервале [i, m-1]
+            j = m - 1;
+        else // Целевой элемент найден, вернуть его индекс
+            return m;
+    }
+    // Целевой элемент не найден, вернуть -1
+    return -1;
+}
+
+/* Бинарный поиск (лево замкнутый, право открытый интервал) */
+int binarySearchLCRO(vector<int> &nums, int target) {
+    // Инициализировать лево замкнутый, право открытый интервал [0, n), то есть i и j указывают на первый элемент массива и позицию сразу за последним элементом соответственно
+    int i = 0, j = nums.size();
+    // Цикл завершается, когда диапазон поиска пуст (при i = j диапазон пуст)
+    while (i < j) {
+        int m = i + (j - i) / 2; // Вычислить индекс середины m
+        if (nums[m] < target)    // Это означает, что target находится в интервале [m+1, j)
+            i = m + 1;
+        else if (nums[m] > target) // Это означает, что target находится в интервале [i, m)
+            j = m;
+        else // Целевой элемент найден, вернуть его индекс
+            return m;
+    }
+    // Целевой элемент не найден, вернуть -1
+    return -1;
+}
+
+/* Driver Code */
+int main() {
+    int target = 6;
+    vector<int> nums = {1, 3, 6, 8, 12, 15, 23, 26, 31, 35};
+
+    /* Бинарный поиск (двусторонне замкнутый интервал) */
+    int index = binarySearch(nums, target);
+    cout << "Индекс целевого элемента 6 = " << index << endl;
+
+    /* Бинарный поиск (лево замкнутый, право открытый интервал) */
+    index = binarySearchLCRO(nums, target);
+    cout << "Индекс целевого элемента 6 = " << index << endl;
+
+    return 0;
+}

ru/codes/cpp/chapter_searching/binary_search_edge.cpp

@@ -0,0 +1,66 @@
+/**
+ * File: binary_search_edge.cpp
+ * Created Time: 2023-08-04
+ * Author: krahets (krahets@163.com)
+ */
+
+#include "../utils/common.hpp"
+
+/* Бинарный поиск точки вставки (с повторяющимися элементами) */
+int binarySearchInsertion(const vector<int> &nums, int target) {
+    int i = 0, j = nums.size() - 1; // Инициализировать двусторонне замкнутый интервал [0, n-1]
+    while (i <= j) {
+        int m = i + (j - i) / 2; // Вычислить индекс середины m
+        if (nums[m] < target) {
+            i = m + 1; // target находится в интервале [m+1, j]
+        } else {
+            j = m - 1; // Первый элемент меньше target находится в интервале [i, m-1]
+        }
+    }
+    // Вернуть точку вставки i
+    return i;
+}
+
+/* Бинарный поиск самого левого target */
+int binarySearchLeftEdge(vector<int> &nums, int target) {
+    // Эквивалентно поиску точки вставки target
+    int i = binarySearchInsertion(nums, target);
+    // target не найден, вернуть -1
+    if (i == nums.size() || nums[i] != target) {
+        return -1;
+    }
+    // Найти target и вернуть индекс i
+    return i;
+}
+
+/* Бинарный поиск самого правого target */
+int binarySearchRightEdge(vector<int> &nums, int target) {
+    // Преобразовать задачу в поиск самого левого target + 1
+    int i = binarySearchInsertion(nums, target + 1);
+    // j указывает на самый правый target, а i — на первый элемент больше target
+    int j = i - 1;
+    // target не найден, вернуть -1
+    if (j == -1 || nums[j] != target) {
+        return -1;
+    }
+    // Найти target и вернуть индекс j
+    return j;
+}
+
+/* Driver Code */
+int main() {
+    // Массив с повторяющимися элементами
+    vector<int> nums = {1, 3, 6, 6, 6, 6, 6, 10, 12, 15};
+    cout << "\nМассив nums = ";
+    printVector(nums);
+
+    // Бинарный поиск левой и правой границы
+    for (int target : {6, 7}) {
+        int index = binarySearchLeftEdge(nums, target);
+        cout << "Индекс самого левого элемента " << target << " равен " << index << endl;
+        index = binarySearchRightEdge(nums, target);
+        cout << "Индекс самого правого элемента " << target << " равен " << index << endl;
+    }
+
+    return 0;
+}

ru/codes/cpp/chapter_searching/binary_search_insertion.cpp

@@ -0,0 +1,66 @@
+/**
+ * File: binary_search_insertion.cpp
+ * Created Time: 2023-08-04
+ * Author: krahets (krahets@163.com)
+ */
+
+#include "../utils/common.hpp"
+
+/* Бинарный поиск точки вставки (без повторяющихся элементов) */
+int binarySearchInsertionSimple(vector<int> &nums, int target) {
+    int i = 0, j = nums.size() - 1; // Инициализировать двусторонне замкнутый интервал [0, n-1]
+    while (i <= j) {
+        int m = i + (j - i) / 2; // Вычислить индекс середины m
+        if (nums[m] < target) {
+            i = m + 1; // target находится в интервале [m+1, j]
+        } else if (nums[m] > target) {
+            j = m - 1; // target находится в интервале [i, m-1]
+        } else {
+            return m; // Найти target и вернуть точку вставки m
+        }
+    }
+    // target не найден, вернуть точку вставки i
+    return i;
+}
+
+/* Бинарный поиск точки вставки (с повторяющимися элементами) */
+int binarySearchInsertion(vector<int> &nums, int target) {
+    int i = 0, j = nums.size() - 1; // Инициализировать двусторонне замкнутый интервал [0, n-1]
+    while (i <= j) {
+        int m = i + (j - i) / 2; // Вычислить индекс середины m
+        if (nums[m] < target) {
+            i = m + 1; // target находится в интервале [m+1, j]
+        } else if (nums[m] > target) {
+            j = m - 1; // target находится в интервале [i, m-1]
+        } else {
+            j = m - 1; // Первый элемент меньше target находится в интервале [i, m-1]
+        }
+    }
+    // Вернуть точку вставки i
+    return i;
+}
+
+/* Driver Code */
+int main() {
+    // Массив без повторяющихся элементов
+    vector<int> nums = {1, 3, 6, 8, 12, 15, 23, 26, 31, 35};
+    cout << "\nМассив nums = ";
+    printVector(nums);
+    // Бинарный поиск точки вставки
+    for (int target : {6, 9}) {
+        int index = binarySearchInsertionSimple(nums, target);
+        cout << "Индекс позиции вставки элемента " << target << " равен " << index << endl;
+    }
+
+    // Массив с повторяющимися элементами
+    nums = {1, 3, 6, 6, 6, 6, 6, 10, 12, 15};
+    cout << "\nМассив nums = ";
+    printVector(nums);
+    // Бинарный поиск точки вставки
+    for (int target : {2, 6, 20}) {
+        int index = binarySearchInsertion(nums, target);
+        cout << "Индекс позиции вставки элемента " << target << " равен " << index << endl;
+    }
+
+    return 0;
+}

ru/codes/cpp/chapter_searching/hashing_search.cpp

@@ -0,0 +1,53 @@
+/**
+ * File: hashing_search.cpp
+ * Created Time: 2022-11-25
+ * Author: krahets (krahets@163.com)
+ */
+
+#include "../utils/common.hpp"
+
+/* Хеш-поиск (массив) */
+int hashingSearchArray(unordered_map<int, int> map, int target) {
+    // key хеш-таблицы: целевой элемент, value: индекс
+    // Если такого key нет в хеш-таблице, вернуть -1
+    if (map.find(target) == map.end())
+        return -1;
+    return map[target];
+}
+
+/* Хеш-поиск (связный список) */
+ListNode *hashingSearchLinkedList(unordered_map<int, ListNode *> map, int target) {
+    // key хеш-таблицы: значение целевого узла, value: объект узла
+    // Если такого key нет в хеш-таблице, вернуть nullptr
+    if (map.find(target) == map.end())
+        return nullptr;
+    return map[target];
+}
+
+/* Driver Code */
+int main() {
+    int target = 3;
+
+    /* Хеш-поиск (массив) */
+    vector<int> nums = {1, 5, 3, 2, 4, 7, 5, 9, 10, 8};
+    // Инициализация хеш-таблицы
+    unordered_map<int, int> map;
+    for (int i = 0; i < nums.size(); i++) {
+        map[nums[i]] = i; // key: элемент, value: индекс
+    }
+    int index = hashingSearchArray(map, target);
+    cout << "Индекс целевого элемента 3 = " << index << endl;
+
+    /* Хеш-поиск (связный список) */
+    ListNode *head = vecToLinkedList(nums);
+    // Инициализация хеш-таблицы
+    unordered_map<int, ListNode *> map1;
+    while (head != nullptr) {
+        map1[head->val] = head; // key: значение узла, value: узел
+        head = head->next;
+    }
+    ListNode *node = hashingSearchLinkedList(map1, target);
+    cout << "Объект узла со значением 3 = " << node << endl;
+
+    return 0;
+}

ru/codes/cpp/chapter_searching/linear_search.cpp

@@ -0,0 +1,49 @@
+/**
+ * File: linear_search.cpp
+ * Created Time: 2022-11-25
+ * Author: krahets (krahets@163.com)
+ */
+
+#include "../utils/common.hpp"
+
+/* Линейный поиск (массив) */
+int linearSearchArray(vector<int> &nums, int target) {
+    // Обход массива
+    for (int i = 0; i < nums.size(); i++) {
+        // Целевой элемент найден, вернуть его индекс
+        if (nums[i] == target)
+            return i;
+    }
+    // Целевой элемент не найден, вернуть -1
+    return -1;
+}
+
+/* Линейный поиск (связный список) */
+ListNode *linearSearchLinkedList(ListNode *head, int target) {
+    // Обойти связный список
+    while (head != nullptr) {
+        // Найти целевой узел и вернуть его
+        if (head->val == target)
+            return head;
+        head = head->next;
+    }
+    // Целевой узел не найден, вернуть nullptr
+    return nullptr;
+}
+
+/* Driver Code */
+int main() {
+    int target = 3;
+
+    /* Выполнить линейный поиск в массиве */
+    vector<int> nums = {1, 5, 3, 2, 4, 7, 5, 9, 10, 8};
+    int index = linearSearchArray(nums, target);
+    cout << "Индекс целевого элемента 3 = " << index << endl;
+
+    /* Выполнить линейный поиск в связном списке */
+    ListNode *head = vecToLinkedList(nums);
+    ListNode *node = linearSearchLinkedList(head, target);
+    cout << "Объект узла со значением 3 = " << node << endl;
+
+    return 0;
+}

ru/codes/cpp/chapter_searching/two_sum.cpp

@@ -0,0 +1,54 @@
+/**
+ * File: two_sum.cpp
+ * Created Time: 2022-11-25
+ * Author: krahets (krahets@163.com)
+ */
+
+#include "../utils/common.hpp"
+
+/* Метод 1: полный перебор */
+vector<int> twoSumBruteForce(vector<int> &nums, int target) {
+    int size = nums.size();
+    // Два вложенных цикла, временная сложность O(n^2)
+    for (int i = 0; i < size - 1; i++) {
+        for (int j = i + 1; j < size; j++) {
+            if (nums[i] + nums[j] == target)
+                return {i, j};
+        }
+    }
+    return {};
+}
+
+/* Метод 2: вспомогательная хеш-таблица */
+vector<int> twoSumHashTable(vector<int> &nums, int target) {
+    int size = nums.size();
+    // Вспомогательная хеш-таблица, пространственная сложность O(n)
+    unordered_map<int, int> dic;
+    // Один цикл, временная сложность O(n)
+    for (int i = 0; i < size; i++) {
+        if (dic.find(target - nums[i]) != dic.end()) {
+            return {dic[target - nums[i]], i};
+        }
+        dic.emplace(nums[i], i);
+    }
+    return {};
+}
+
+/* Driver Code */
+int main() {
+    // ======= Test Case =======
+    vector<int> nums = {2, 7, 11, 15};
+    int target = 13;
+
+    // ====== Основной код ======
+    // Метод 1
+    vector<int> res = twoSumBruteForce(nums, target);
+    cout << "Результат метода 1 res = ";
+    printVector(res);
+    // Метод 2
+    res = twoSumHashTable(nums, target);
+    cout << "Результат метода 2 res = ";
+    printVector(res);
+
+    return 0;
+}