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

@@ -0,0 +1,2 @@
+add_executable(my_heap_test my_heap_test.c)
+add_executable(top_k top_k.c)

ru/codes/c/chapter_heap/my_heap.c

@@ -0,0 +1,152 @@
+/**
+ * File: my_heap.c
+ * Created Time: 2023-01-15
+ * Author: Reanon (793584285@qq.com)
+ */
+
+#include "../utils/common.h"
+
+#define MAX_SIZE 5000
+
+/* Максимальная куча */
+typedef struct {
+    // size обозначает фактическое число элементов
+    int size;
+    // Использовать массив с заранее выделенной памятью, чтобы избежать расширения
+    int data[MAX_SIZE];
+} MaxHeap;
+
+// Объявление функции
+void siftDown(MaxHeap *maxHeap, int i);
+void siftUp(MaxHeap *maxHeap, int i);
+int parent(MaxHeap *maxHeap, int i);
+
+/* Конструктор, строящий кучу по срезу */
+MaxHeap *newMaxHeap(int nums[], int size) {
+    // Поместить все элементы в кучу
+    MaxHeap *maxHeap = (MaxHeap *)malloc(sizeof(MaxHeap));
+    maxHeap->size = size;
+    memcpy(maxHeap->data, nums, size * sizeof(int));
+    for (int i = parent(maxHeap, size - 1); i >= 0; i--) {
+        // Выполнить heapify для всех узлов, кроме листовых
+        siftDown(maxHeap, i);
+    }
+    return maxHeap;
+}
+
+/* Деструктор */
+void delMaxHeap(MaxHeap *maxHeap) {
+    // Освободить память
+    free(maxHeap);
+}
+
+/* Получить индекс левого дочернего узла */
+int left(MaxHeap *maxHeap, int i) {
+    return 2 * i + 1;
+}
+
+/* Получить индекс правого дочернего узла */
+int right(MaxHeap *maxHeap, int i) {
+    return 2 * i + 2;
+}
+
+/* Получить индекс родительского узла */
+int parent(MaxHeap *maxHeap, int i) {
+    return (i - 1) / 2; // Округление вниз
+}
+
+/* Поменять элементы местами */
+void swap(MaxHeap *maxHeap, int i, int j) {
+    int temp = maxHeap->data[i];
+    maxHeap->data[i] = maxHeap->data[j];
+    maxHeap->data[j] = temp;
+}
+
+/* Получение размера кучи */
+int size(MaxHeap *maxHeap) {
+    return maxHeap->size;
+}
+
+/* Проверка, пуста ли куча */
+int isEmpty(MaxHeap *maxHeap) {
+    return maxHeap->size == 0;
+}
+
+/* Доступ к элементу на вершине кучи */
+int peek(MaxHeap *maxHeap) {
+    return maxHeap->data[0];
+}
+
+/* Добавление элемента в кучу */
+void push(MaxHeap *maxHeap, int val) {
+    // По умолчанию не следует добавлять так много узлов
+    if (maxHeap->size == MAX_SIZE) {
+        printf("heap is full!");
+        return;
+    }
+    // Добавление узла
+    maxHeap->data[maxHeap->size] = val;
+    maxHeap->size++;
+
+    // Просеивание снизу вверх
+    siftUp(maxHeap, maxHeap->size - 1);
+}
+
+/* Извлечение элемента из кучи */
+int pop(MaxHeap *maxHeap) {
+    // Обработка пустого случая
+    if (isEmpty(maxHeap)) {
+        printf("heap is empty!");
+        return INT_MAX;
+    }
+    // Поменять корневой узел с самым правым листом местами (поменять первый и последний элементы)
+    swap(maxHeap, 0, size(maxHeap) - 1);
+    // Удаление узла
+    int val = maxHeap->data[maxHeap->size - 1];
+    maxHeap->size--;
+    // Просеивание сверху вниз
+    siftDown(maxHeap, 0);
+
+    // Вернуть элемент с вершины кучи
+    return val;
+}
+
+/* Начиная с узла i, выполнить просеивание сверху вниз */
+void siftDown(MaxHeap *maxHeap, int i) {
+    while (true) {
+        // Определить узел с максимальным значением среди i, l и r и обозначить его как max
+        int l = left(maxHeap, i);
+        int r = right(maxHeap, i);
+        int max = i;
+        if (l < size(maxHeap) && maxHeap->data[l] > maxHeap->data[max]) {
+            max = l;
+        }
+        if (r < size(maxHeap) && maxHeap->data[r] > maxHeap->data[max]) {
+            max = r;
+        }
+        // Если узел i уже максимален или индексы l и r вне границ, дальнейшее просеивание не требуется, выйти
+        if (max == i) {
+            break;
+        }
+        // Поменять два узла местами
+        swap(maxHeap, i, max);
+        // Циклическое просеивание вниз
+        i = max;
+    }
+}
+
+/* Начиная с узла i, выполнить просеивание снизу вверх */
+void siftUp(MaxHeap *maxHeap, int i) {
+    while (true) {
+        // Получение родительского узла для узла i
+        int p = parent(maxHeap, i);
+        // Завершить heapify, когда «корневой узел уже пройден» или «узел не требует исправления»
+        if (p < 0 || maxHeap->data[i] <= maxHeap->data[p]) {
+            break;
+        }
+        // Поменять два узла местами
+        swap(maxHeap, i, p);
+        // Циклическое просеивание вверх
+        i = p;
+    }
+}

ru/codes/c/chapter_heap/my_heap_test.c

@@ -0,0 +1,41 @@
+/**
+ * File: my_heap_test.c
+ * Created Time: 2023-01-15
+ * Author: Reanon (793584285@qq.com)
+ */
+
+#include "my_heap.c"
+
+/* Driver Code */
+int main() {
+    /* Инициализация кучи */
+    // Инициализация максимальной кучи
+    int nums[] = {9, 8, 6, 6, 7, 5, 2, 1, 4, 3, 6, 2};
+    MaxHeap *maxHeap = newMaxHeap(nums, sizeof(nums) / sizeof(int));
+    printf("После построения кучи из входного массива\n");
+    printHeap(maxHeap->data, maxHeap->size);
+
+    /* Получение элемента с вершины кучи */
+    printf("\nВерхний элемент кучи = %d\n", peek(maxHeap));
+
+    /* Добавление элемента в кучу */
+    push(maxHeap, 7);
+    printf("\nПосле добавления элемента 7 в кучу\n");
+    printHeap(maxHeap->data, maxHeap->size);
+
+    /* Извлечение элемента с вершины кучи */
+    int top = pop(maxHeap);
+    printf("\nПосле извлечения верхнего элемента %d из кучи\n", top);
+    printHeap(maxHeap->data, maxHeap->size);
+
+    /* Получение размера кучи */
+    printf("\nКоличество элементов в куче = %d\n", size(maxHeap));
+
+    /* Проверка, пуста ли куча */
+    printf("\nПуста ли куча: %d\n", isEmpty(maxHeap));
+
+    // Освободить память
+    delMaxHeap(maxHeap);
+
+    return 0;
+}

ru/codes/c/chapter_heap/top_k.c

@@ -0,0 +1,73 @@
+/**
+ * File: top_k.c
+ * Created Time: 2023-10-26
+ * Author: krahets (krahets163.com)
+ */
+
+#include "my_heap.c"
+
+/* Добавление элемента в кучу */
+void pushMinHeap(MaxHeap *maxHeap, int val) {
+    // Инвертировать знак элемента
+    push(maxHeap, -val);
+}
+
+/* Извлечение элемента из кучи */
+int popMinHeap(MaxHeap *maxHeap) {
+    // Инвертировать знак элемента
+    return -pop(maxHeap);
+}
+
+/* Доступ к элементу на вершине кучи */
+int peekMinHeap(MaxHeap *maxHeap) {
+    // Инвертировать знак элемента
+    return -peek(maxHeap);
+}
+
+/* Извлечь элементы из кучи */
+int *getMinHeap(MaxHeap *maxHeap) {
+    // Инвертировать все элементы кучи и записать их в массив res
+    int *res = (int *)malloc(maxHeap->size * sizeof(int));
+    for (int i = 0; i < maxHeap->size; i++) {
+        res[i] = -maxHeap->data[i];
+    }
+    return res;
+}
+
+// Функция поиска k наибольших элементов массива на основе кучи
+int *topKHeap(int *nums, int sizeNums, int k) {
+    // Инициализация минимальной кучи
+    // Обратите внимание: мы инвертируем все элементы кучи, чтобы с помощью максимальной кучи имитировать минимальную
+    int *empty = (int *)malloc(0);
+    MaxHeap *maxHeap = newMaxHeap(empty, 0);
+    // Поместить первые k элементов массива в кучу
+    for (int i = 0; i < k; i++) {
+        pushMinHeap(maxHeap, nums[i]);
+    }
+    // Начиная с элемента k+1, поддерживать длину кучи равной k
+    for (int i = k; i < sizeNums; i++) {
+        // Если текущий элемент больше элемента на вершине кучи, извлечь вершину кучи и добавить текущий элемент в кучу
+        if (nums[i] > peekMinHeap(maxHeap)) {
+            popMinHeap(maxHeap);
+            pushMinHeap(maxHeap, nums[i]);
+        }
+    }
+    int *res = getMinHeap(maxHeap);
+    // Освободить память
+    delMaxHeap(maxHeap);
+    return res;
+}
+
+/* Driver Code */
+int main() {
+    int nums[] = {1, 7, 6, 3, 2};
+    int k = 3;
+    int sizeNums = sizeof(nums) / sizeof(nums[0]);
+
+    int *res = topKHeap(nums, sizeNums, k);
+    printf("Наибольшие %d элементов: ", k);
+    printArray(res, k);
+
+    free(res);
+    return 0;
+}