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_array_and_linkedlist/CMakeLists.txt

@@ -0,0 +1,4 @@
+add_executable(array array.cpp)
+add_executable(linked_list linked_list.cpp)
+add_executable(list list.cpp)
+add_executable(my_list my_list.cpp)

ru/codes/cpp/chapter_array_and_linkedlist/array.cpp

@@ -0,0 +1,113 @@
+/**
+ * File: array.cpp
+ * Created Time: 2022-11-25
+ * Author: krahets (krahets@163.com)
+ */
+
+#include "../utils/common.hpp"
+
+/* Случайный доступ к элементу */
+int randomAccess(int *nums, int size) {
+    // Случайным образом выбрать число из интервала [0, size)
+    int randomIndex = rand() % size;
+    // Получить и вернуть случайный элемент
+    int randomNum = nums[randomIndex];
+    return randomNum;
+}
+
+/* Увеличить длину массива */
+int *extend(int *nums, int size, int enlarge) {
+    // Инициализировать массив увеличенной длины
+    int *res = new int[size + enlarge];
+    // Скопировать все элементы исходного массива в новый массив
+    for (int i = 0; i < size; i++) {
+        res[i] = nums[i];
+    }
+    // Освободить память
+    delete[] nums;
+    // Вернуть новый массив после расширения
+    return res;
+}
+
+/* Вставить элемент num по индексу index в массив */
+void insert(int *nums, int size, int num, int index) {
+    // Сдвинуть элемент с индексом index и все последующие элементы на одну позицию назад
+    for (int i = size - 1; i > index; i--) {
+        nums[i] = nums[i - 1];
+    }
+    // Присвоить num элементу по индексу index
+    nums[index] = num;
+}
+
+/* Удалить элемент по индексу index */
+void remove(int *nums, int size, int index) {
+    // Сдвинуть все элементы после индекса index на одну позицию вперед
+    for (int i = index; i < size - 1; i++) {
+        nums[i] = nums[i + 1];
+    }
+}
+
+/* Обход массива */
+void traverse(int *nums, int size) {
+    int count = 0;
+    // Обход массива по индексам
+    for (int i = 0; i < size; i++) {
+        count += nums[i];
+    }
+}
+
+/* Найти заданный элемент в массиве */
+int find(int *nums, int size, int target) {
+    for (int i = 0; i < size; i++) {
+        if (nums[i] == target)
+            return i;
+    }
+    return -1;
+}
+
+/* Driver Code */
+int main() {
+    /* Инициализация массива */
+    int size = 5;
+    int *arr = new int[size];
+    cout << "Массив arr = ";
+    printArray(arr, size);
+
+    int *nums = new int[size]{1, 3, 2, 5, 4};
+    cout << "Массив nums = ";
+    printArray(nums, size);
+
+    /* Случайный доступ */
+    int randomNum = randomAccess(nums, size);
+    cout << "Случайный элемент из nums = " << randomNum << endl;
+
+    /* Расширение длины */
+    int enlarge = 3;
+    nums = extend(nums, size, enlarge);
+    size += enlarge;
+    cout << "После увеличения длины массива до 8 nums = ";
+    printArray(nums, size);
+
+    /* Вставка элемента */
+    insert(nums, size, 6, 3);
+    cout << "После вставки числа 6 по индексу 3 nums = ";
+    printArray(nums, size);
+
+    /* Удаление элемента */
+    remove(nums, size, 2);
+    cout << "После удаления элемента по индексу 2 nums = ";
+    printArray(nums, size);
+
+    /* Обход массива */
+    traverse(nums, size);
+
+    /* Поиск элемента */
+    int index = find(nums, size, 3);
+    cout << "Индекс элемента 3 в nums = " << index << endl;
+
+    // Освободить память
+    delete[] arr;
+    delete[] nums;
+
+    return 0;
+}

ru/codes/cpp/chapter_array_and_linkedlist/linked_list.cpp

@@ -0,0 +1,89 @@
+/**
+ * File: linked_list.cpp
+ * Created Time: 2022-11-25
+ * Author: krahets (krahets@163.com)
+ */
+
+#include "../utils/common.hpp"
+
+/* Вставить узел P после узла n0 в связном списке */
+void insert(ListNode *n0, ListNode *P) {
+    ListNode *n1 = n0->next;
+    P->next = n1;
+    n0->next = P;
+}
+
+/* Удалить первый узел после узла n0 в связном списке */
+void remove(ListNode *n0) {
+    if (n0->next == nullptr)
+        return;
+    // n0 -> P -> n1
+    ListNode *P = n0->next;
+    ListNode *n1 = P->next;
+    n0->next = n1;
+    // Освободить память
+    delete P;
+}
+
+/* Доступ к узлу связного списка по индексу index */
+ListNode *access(ListNode *head, int index) {
+    for (int i = 0; i < index; i++) {
+        if (head == nullptr)
+            return nullptr;
+        head = head->next;
+    }
+    return head;
+}
+
+/* Найти в связном списке первый узел со значением target */
+int find(ListNode *head, int target) {
+    int index = 0;
+    while (head != nullptr) {
+        if (head->val == target)
+            return index;
+        head = head->next;
+        index++;
+    }
+    return -1;
+}
+
+/* Driver Code */
+int main() {
+    /* Инициализация связного списка */
+    // Инициализация всех узлов
+    ListNode *n0 = new ListNode(1);
+    ListNode *n1 = new ListNode(3);
+    ListNode *n2 = new ListNode(2);
+    ListNode *n3 = new ListNode(5);
+    ListNode *n4 = new ListNode(4);
+    // Построить ссылки между узлами
+    n0->next = n1;
+    n1->next = n2;
+    n2->next = n3;
+    n3->next = n4;
+    cout << "Инициализированный связный список" << endl;
+    printLinkedList(n0);
+
+    /* Вставка узла */
+    insert(n0, new ListNode(0));
+    cout << "Связный список после вставки узла" << endl;
+    printLinkedList(n0);
+
+    /* Удаление узла */
+    remove(n0);
+    cout << "Связный список после удаления узла" << endl;
+    printLinkedList(n0);
+
+    /* Доступ к узлу */
+    ListNode *node = access(n0, 3);
+    cout << "Значение узла по индексу 3 в связном списке = " << node->val << endl;
+
+    /* Поиск узла */
+    int index = find(n0, 2);
+    cout << "Индекс узла со значением 2 в связном списке = " << index << endl;
+
+    // Освободить память
+    freeMemoryLinkedList(n0);
+
+    return 0;
+}

ru/codes/cpp/chapter_array_and_linkedlist/list.cpp

@@ -0,0 +1,72 @@
+/**
+ * File: list.cpp
+ * Created Time: 2022-11-25
+ * Author: krahets (krahets@163.com)
+ */
+
+#include "../utils/common.hpp"
+
+/* Driver Code */
+int main() {
+    /* Инициализация списка */
+    vector<int> nums = {1, 3, 2, 5, 4};
+    cout << "Список nums = ";
+    printVector(nums);
+
+    /* Доступ к элементу */
+    int num = nums[1];
+    cout << "Элемент по индексу 1: num = " << num << endl;
+
+    /* Обновление элемента */
+    nums[1] = 0;
+    cout << "После обновления элемента по индексу 1 на 0 nums = ";
+    printVector(nums);
+
+    /* Очистить список */
+    nums.clear();
+    cout << "После очистки списка nums = ";
+    printVector(nums);
+
+    /* Добавление элемента в конец */
+    nums.push_back(1);
+    nums.push_back(3);
+    nums.push_back(2);
+    nums.push_back(5);
+    nums.push_back(4);
+    cout << "После добавления элемента nums = ";
+    printVector(nums);
+
+    /* Вставка элемента в середину */
+    nums.insert(nums.begin() + 3, 6);
+    cout << "После вставки числа 6 по индексу 3 nums = ";
+    printVector(nums);
+
+    /* Удаление элемента */
+    nums.erase(nums.begin() + 3);
+    cout << "После удаления элемента по индексу 3 nums = ";
+    printVector(nums);
+
+    /* Обходить список по индексам */
+    int count = 0;
+    for (int i = 0; i < nums.size(); i++) {
+        count += nums[i];
+    }
+    /* Непосредственно обходить элементы списка */
+    count = 0;
+    for (int x : nums) {
+        count += x;
+    }
+
+    /* Объединить два списка */
+    vector<int> nums1 = {6, 8, 7, 10, 9};
+    nums.insert(nums.end(), nums1.begin(), nums1.end());
+    cout << "После присоединения списка nums1 к nums nums = ";
+    printVector(nums);
+
+    /* Отсортировать список */
+    sort(nums.begin(), nums.end());
+    cout << "После сортировки списка nums = ";
+    printVector(nums);
+
+    return 0;
+}

ru/codes/cpp/chapter_array_and_linkedlist/my_list.cpp

@@ -0,0 +1,171 @@
+/**
+ * File: my_list.cpp
+ * Created Time: 2022-11-25
+ * Author: krahets (krahets@163.com)
+ */
+
+#include "../utils/common.hpp"
+
+/* Класс списка */
+class MyList {
+  private:
+    int *arr;             // Массив (для хранения элементов списка)
+    int arrCapacity = 10; // Вместимость списка
+    int arrSize = 0;      // Длина списка (текущее число элементов)
+    int extendRatio = 2;   // Коэффициент увеличения списка при каждом расширении
+
+  public:
+    /* Конструктор */
+    MyList() {
+        arr = new int[arrCapacity];
+    }
+
+    /* Метод-деструктор */
+    ~MyList() {
+        delete[] arr;
+    }
+
+    /* Получить длину списка (текущее число элементов) */
+    int size() {
+        return arrSize;
+    }
+
+    /* Получить вместимость списка */
+    int capacity() {
+        return arrCapacity;
+    }
+
+    /* Доступ к элементу */
+    int get(int index) {
+        // Если индекс выходит за границы, выбрасывается исключение; далее аналогично
+        if (index < 0 || index >= size())
+            throw out_of_range("индекс выходит за границы");
+        return arr[index];
+    }
+
+    /* Обновление элемента */
+    void set(int index, int num) {
+        if (index < 0 || index >= size())
+            throw out_of_range("индекс выходит за границы");
+        arr[index] = num;
+    }
+
+    /* Добавление элемента в конец */
+    void add(int num) {
+        // При превышении вместимости по числу элементов запускается расширение
+        if (size() == capacity())
+            extendCapacity();
+        arr[size()] = num;
+        // Обновить число элементов
+        arrSize++;
+    }
+
+    /* Вставка элемента в середину */
+    void insert(int index, int num) {
+        if (index < 0 || index >= size())
+            throw out_of_range("индекс выходит за границы");
+        // При превышении вместимости по числу элементов запускается расширение
+        if (size() == capacity())
+            extendCapacity();
+        // Сдвинуть элемент с индексом index и все следующие элементы на одну позицию назад
+        for (int j = size() - 1; j >= index; j--) {
+            arr[j + 1] = arr[j];
+        }
+        arr[index] = num;
+        // Обновить число элементов
+        arrSize++;
+    }
+
+    /* Удаление элемента */
+    int remove(int index) {
+        if (index < 0 || index >= size())
+            throw out_of_range("индекс выходит за границы");
+        int num = arr[index];
+        // Сдвинуть все элементы после индекса index на одну позицию вперед
+        for (int j = index; j < size() - 1; j++) {
+            arr[j] = arr[j + 1];
+        }
+        // Обновить число элементов
+        arrSize--;
+        // Вернуть удаленный элемент
+        return num;
+    }
+
+    /* Расширение списка */
+    void extendCapacity() {
+        // Создать новый массив длиной в extendRatio раз больше исходного массива
+        int newCapacity = capacity() * extendRatio;
+        int *tmp = arr;
+        arr = new int[newCapacity];
+        // Скопировать все элементы исходного массива в новый массив
+        for (int i = 0; i < size(); i++) {
+            arr[i] = tmp[i];
+        }
+        // Освободить память
+        delete[] tmp;
+        arrCapacity = newCapacity;
+    }
+
+    /* Преобразовать список в Vector для вывода */
+    vector<int> toVector() {
+        // Преобразовывать только элементы списка в пределах фактической длины
+        vector<int> vec(size());
+        for (int i = 0; i < size(); i++) {
+            vec[i] = arr[i];
+        }
+        return vec;
+    }
+};
+
+/* Driver Code */
+int main() {
+    /* Инициализация списка */
+    MyList *nums = new MyList();
+    /* Добавление элемента в конец */
+    nums->add(1);
+    nums->add(3);
+    nums->add(2);
+    nums->add(5);
+    nums->add(4);
+    cout << "Список nums = ";
+    vector<int> vec = nums->toVector();
+    printVector(vec);
+    cout << "Вместимость = " << nums->capacity() << ", длина = " << nums->size() << endl;
+
+    /* Вставка элемента в середину */
+    nums->insert(3, 6);
+    cout << "После вставки числа 6 по индексу 3 nums = ";
+    vec = nums->toVector();
+    printVector(vec);
+
+    /* Удаление элемента */
+    nums->remove(3);
+    cout << "После удаления элемента по индексу 3 nums = ";
+    vec = nums->toVector();
+    printVector(vec);
+
+    /* Доступ к элементу */
+    int num = nums->get(1);
+    cout << "Элемент по индексу 1: num = " << num << endl;
+
+    /* Обновление элемента */
+    nums->set(1, 0);
+    cout << "После обновления элемента по индексу 1 на 0 nums = ";
+    vec = nums->toVector();
+    printVector(vec);
+
+    /* Проверка механизма расширения */
+    for (int i = 0; i < 10; i++) {
+        // При i = 5 длина списка превысит его вместимость, и в этот момент сработает механизм расширения
+        nums->add(i);
+    }
+    cout << "После расширения список nums = ";
+    vec = nums->toVector();
+    printVector(vec);
+    cout << "Вместимость = " << nums->capacity() << ", длина = " << nums->size() << endl;
+
+    // Освободить память
+    delete nums;
+
+    return 0;
+}