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/rust/chapter_sorting/bubble_sort.rs

@@ -0,0 +1,53 @@
+/*
+ * File: bubble_sort.rs
+ * Created Time: 2023-02-05
+ * Author: codingonion (coderonion@gmail.com)
+ */
+
+use hello_algo_rust::include::print_util;
+
+/* Пузырьковая сортировка */
+fn bubble_sort(nums: &mut [i32]) {
+    // Внешний цикл: неотсортированный диапазон [0, i]
+    for i in (1..nums.len()).rev() {
+        // Внутренний цикл: переместить максимальный элемент неотсортированного диапазона [0, i] в его правый конец
+        for j in 0..i {
+            if nums[j] > nums[j + 1] {
+                // Поменять местами nums[j] и nums[j + 1]
+                nums.swap(j, j + 1);
+            }
+        }
+    }
+}
+
+/* Пузырьковая сортировка (оптимизация флагом) */
+fn bubble_sort_with_flag(nums: &mut [i32]) {
+    // Внешний цикл: неотсортированный диапазон [0, i]
+    for i in (1..nums.len()).rev() {
+        let mut flag = false; // Инициализировать флаг
+        // Внутренний цикл: переместить максимальный элемент неотсортированного диапазона [0, i] в его правый конец
+        for j in 0..i {
+            if nums[j] > nums[j + 1] {
+                // Поменять местами nums[j] и nums[j + 1]
+                nums.swap(j, j + 1);
+                flag = true; // Записать обмен элементов
+            }
+        }
+        if !flag {
+            break; // На этой итерации «всплытия» не было ни одного обмена, сразу выйти
+        };
+    }
+}
+
+/* Driver Code */
+pub fn main() {
+    let mut nums = [4, 1, 3, 1, 5, 2];
+    bubble_sort(&mut nums);
+    print!("После пузырьковой сортировки nums = ");
+    print_util::print_array(&nums);
+
+    let mut nums1 = [4, 1, 3, 1, 5, 2];
+    bubble_sort_with_flag(&mut nums1);
+    print!("\nПосле пузырьковой сортировки nums1 = ");
+    print_util::print_array(&nums1);
+}

ru/codes/rust/chapter_sorting/bucket_sort.rs

@@ -0,0 +1,43 @@
+/*
+ * File: bucket_sort.rs
+ * Created Time: 2023-07-09
+ * Author: night-cruise (2586447362@qq.com)
+ */
+
+use hello_algo_rust::include::print_util;
+
+/* Сортировка корзинами */
+fn bucket_sort(nums: &mut [f64]) {
+    // Инициализировать k = n/2 корзин, предполагая распределение 2 элементов в каждую корзину
+    let k = nums.len() / 2;
+    let mut buckets = vec![vec![]; k];
+    // 1. Распределить элементы массива по корзинам
+    for &num in nums.iter() {
+        // Входные данные лежат в диапазоне [0, 1); использовать num * k для отображения в диапазон индексов [0, k-1]
+        let i = (num * k as f64) as usize;
+        // Добавить num в корзину i
+        buckets[i].push(num);
+    }
+    // 2. Выполнить сортировку внутри каждой корзины
+    for bucket in &mut buckets {
+        // Использовать встроенную функцию сортировки; ее также можно заменить другим алгоритмом сортировки
+        bucket.sort_by(|a, b| a.partial_cmp(b).unwrap());
+    }
+    // 3. Обойти корзины и объединить результаты
+    let mut i = 0;
+    for bucket in buckets.iter() {
+        for &num in bucket.iter() {
+            nums[i] = num;
+            i += 1;
+        }
+    }
+}
+
+/* Driver Code */
+fn main() {
+    // Пусть входные данные — числа с плавающей точкой из диапазона [0, 1)
+    let mut nums = [0.49, 0.96, 0.82, 0.09, 0.57, 0.43, 0.91, 0.75, 0.15, 0.37];
+    bucket_sort(&mut nums);
+    print!("После сортировки корзинами nums = ");
+    print_util::print_array(&nums);
+}

ru/codes/rust/chapter_sorting/counting_sort.rs

@@ -0,0 +1,70 @@
+/*
+ * File: counting_sort.rs
+ * Created Time: 2023-07-09
+ * Author: night-cruise (2586447362@qq.com)
+ */
+
+use hello_algo_rust::include::print_util;
+
+/* Сортировка подсчетом */
+// Простая реализация, не подходит для сортировки объектов
+fn counting_sort_naive(nums: &mut [i32]) {
+    // 1. Найти максимальный элемент массива m
+    let m = *nums.iter().max().unwrap();
+    // 2. Подсчитать число появлений каждой цифры
+    // counter[num] обозначает число появлений num
+    let mut counter = vec![0; m as usize + 1];
+    for &num in nums.iter() {
+        counter[num as usize] += 1;
+    }
+    // 3. Обойти counter и заполнить исходный массив nums элементами
+    let mut i = 0;
+    for num in 0..m + 1 {
+        for _ in 0..counter[num as usize] {
+            nums[i] = num;
+            i += 1;
+        }
+    }
+}
+
+/* Сортировка подсчетом */
+// Полная реализация, позволяет сортировать объекты и является стабильной сортировкой
+fn counting_sort(nums: &mut [i32]) {
+    // 1. Найти максимальный элемент массива m
+    let m = *nums.iter().max().unwrap() as usize;
+    // 2. Подсчитать число появлений каждой цифры
+    // counter[num] обозначает число появлений num
+    let mut counter = vec![0; m + 1];
+    for &num in nums.iter() {
+        counter[num as usize] += 1;
+    }
+    // 3. Вычислить префиксные суммы counter и преобразовать «число появлений» в «конечный индекс»
+    // То есть counter[num]-1 — это индекс последнего появления num в res
+    for i in 0..m {
+        counter[i + 1] += counter[i];
+    }
+    // 4. Обойти nums в обратном порядке и поместить элементы в результирующий массив res
+    // Инициализировать массив res для хранения результата
+    let n = nums.len();
+    let mut res = vec![0; n];
+    for i in (0..n).rev() {
+        let num = nums[i];
+        res[counter[num as usize] - 1] = num; // Поместить num по соответствующему индексу
+        counter[num as usize] -= 1; // Уменьшить префиксную сумму на 1, чтобы получить индекс следующего размещения num
+    }
+    // Перезаписать исходный массив nums массивом результата res
+    nums.copy_from_slice(&res)
+}
+
+/* Driver Code */
+fn main() {
+    let mut nums = [1, 0, 1, 2, 0, 4, 0, 2, 2, 4];
+    counting_sort_naive(&mut nums);
+    print!("После сортировки подсчетом (объекты не поддерживаются) nums = ");
+    print_util::print_array(&nums);
+
+    let mut nums1 = [1, 0, 1, 2, 0, 4, 0, 2, 2, 4];
+    counting_sort(&mut nums1);
+    print!("\nПосле сортировки подсчетом nums1 = ");
+    print_util::print_array(&nums1);
+}

ru/codes/rust/chapter_sorting/heap_sort.rs

@@ -0,0 +1,54 @@
+/*
+ * File: heap_sort.rs
+ * Created Time: 2023-07-04
+ * Author: night-cruise (2586447362@qq.com)
+ */
+
+use hello_algo_rust::include::print_util;
+
+/* Длина кучи равна n; начиная с узла i, выполнить просеивание сверху вниз */
+fn sift_down(nums: &mut [i32], n: usize, mut i: usize) {
+    loop {
+        // Определить узел с максимальным значением среди i, l и r и обозначить его как ma
+        let l = 2 * i + 1;
+        let r = 2 * i + 2;
+        let mut ma = i;
+        if l < n && nums[l] > nums[ma] {
+            ma = l;
+        }
+        if r < n && nums[r] > nums[ma] {
+            ma = r;
+        }
+        // Если узел i уже максимален или индексы l и r вне границ, дальнейшее просеивание не требуется, выйти
+        if ma == i {
+            break;
+        }
+        // Поменять два узла местами
+        nums.swap(i, ma);
+        // Циклическое просеивание вниз
+        i = ma;
+    }
+}
+
+/* Сортировка кучей */
+fn heap_sort(nums: &mut [i32]) {
+    // Построение кучи: выполнить heapify для всех узлов, кроме листовых
+    for i in (0..nums.len() / 2).rev() {
+        sift_down(nums, nums.len(), i);
+    }
+    // Извлекать максимальный элемент из кучи в течение n-1 итераций
+    for i in (1..nums.len()).rev() {
+        // Поменять корневой узел с самым правым листом местами (поменять первый и последний элементы)
+        nums.swap(0, i);
+        // Начиная с корневого узла, выполнить просеивание сверху вниз
+        sift_down(nums, i, 0);
+    }
+}
+
+/* Driver Code */
+fn main() {
+    let mut nums = [4, 1, 3, 1, 5, 2];
+    heap_sort(&mut nums);
+    print!("После сортировки кучей nums = ");
+    print_util::print_array(&nums);
+}

ru/codes/rust/chapter_sorting/insertion_sort.rs

@@ -0,0 +1,29 @@
+/*
+ * File: insertion_sort.rs
+ * Created Time: 2023-02-13
+ * Author: xBLACKICEx (xBLACKICEx@outlook.com)
+ */
+
+use hello_algo_rust::include::print_util;
+
+/* Сортировка вставками */
+fn insertion_sort(nums: &mut [i32]) {
+    // Внешний цикл: отсортированный диапазон [0, i-1]
+    for i in 1..nums.len() {
+        let (base, mut j) = (nums[i], (i - 1) as i32);
+        // Внутренний цикл: вставить base в правильную позицию отсортированного диапазона [0, i-1]
+        while j >= 0 && nums[j as usize] > base {
+            nums[(j + 1) as usize] = nums[j as usize]; // Сдвинуть nums[j] на одну позицию вправо
+            j -= 1;
+        }
+        nums[(j + 1) as usize] = base; // Поместить base в правильную позицию
+    }
+}
+
+/* Driver Code */
+fn main() {
+    let mut nums = [4, 1, 3, 1, 5, 2];
+    insertion_sort(&mut nums);
+    print!("После сортировки вставками nums = ");
+    print_util::print_array(&nums);
+}

ru/codes/rust/chapter_sorting/merge_sort.rs

@@ -0,0 +1,66 @@
+/**
+ * File: merge_sort.rs
+ * Created Time: 2023-02-14
+ * Author: xBLACKICEx (xBLACKICEx@outlook.com)
+ */
+
+/* Объединить левый и правый подмассивы */
+fn merge(nums: &mut [i32], left: usize, mid: usize, right: usize) {
+    // Диапазон левого подмассива: [left, mid], диапазон правого подмассива: [mid+1, right]
+    // Создать временный массив tmp для хранения результата слияния
+    let tmp_size = right - left + 1;
+    let mut tmp = vec![0; tmp_size];
+    // Инициализировать начальные индексы левого и правого подмассивов
+    let (mut i, mut j, mut k) = (left, mid + 1, 0);
+    // Пока в левом и правом подмассивах еще есть элементы, сравнивать их и копировать меньший во временный массив
+    while i <= mid && j <= right {
+        if nums[i] <= nums[j] {
+            tmp[k] = nums[i];
+            i += 1;
+        } else {
+            tmp[k] = nums[j];
+            j += 1;
+        }
+        k += 1;
+    }
+    // Скопировать оставшиеся элементы левого и правого подмассивов во временный массив
+    while i <= mid {
+        tmp[k] = nums[i];
+        k += 1;
+        i += 1;
+    }
+    while j <= right {
+        tmp[k] = nums[j];
+        k += 1;
+        j += 1;
+    }
+    // Скопировать элементы временного массива tmp обратно в соответствующий диапазон исходного массива nums
+    for k in 0..tmp_size {
+        nums[left + k] = tmp[k];
+    }
+}
+
+/* Сортировка слиянием */
+fn merge_sort(nums: &mut [i32], left: usize, right: usize) {
+    // Условие завершения
+    if left >= right {
+        return; // Завершить рекурсию, когда длина подмассива равна 1
+    }
+
+    // Этап разбиения
+    let mid = left + (right - left) / 2; // Вычислить середину
+    merge_sort(nums, left, mid); // Рекурсивно обработать левый подмассив
+    merge_sort(nums, mid + 1, right); // Рекурсивно обработать правый подмассив
+
+    // Этап слияния
+    merge(nums, left, mid, right);
+}
+
+/* Driver Code */
+fn main() {
+    /* Сортировка слиянием */
+    let mut nums = [7, 3, 2, 6, 0, 1, 5, 4];
+    let right = nums.len() - 1;
+    merge_sort(&mut nums, 0, right);
+    println!("После сортировки слиянием nums = {:?}", nums);
+}

ru/codes/rust/chapter_sorting/quick_sort.rs

@@ -0,0 +1,148 @@
+/**
+ * File: quick_sort.rs
+ * Created Time: 2023-02-16
+ * Author: xBLACKICEx (xBLACKICE@outlook.com)
+ */
+
+/* Быстрая сортировка */
+struct QuickSort;
+
+impl QuickSort {
+    /* Разбиение с опорными указателями */
+    fn partition(nums: &mut [i32], left: usize, right: usize) -> usize {
+        // Взять nums[left] в качестве опорного элемента
+        let (mut i, mut j) = (left, right);
+        while i < j {
+            while i < j && nums[j] >= nums[left] {
+                j -= 1; // Идти справа налево в поисках первого элемента меньше опорного
+            }
+            while i < j && nums[i] <= nums[left] {
+                i += 1; // Идти слева направо в поисках первого элемента больше опорного
+            }
+            nums.swap(i, j); // Поменять эти два элемента местами
+        }
+        nums.swap(i, left); // Переместить опорный элемент на границу двух подмассивов
+        i // Вернуть индекс опорного элемента
+    }
+
+    /* Быстрая сортировка */
+    pub fn quick_sort(left: i32, right: i32, nums: &mut [i32]) {
+        // Завершить рекурсию, когда длина подмассива равна 1
+        if left >= right {
+            return;
+        }
+        // Разбиение с опорными указателями
+        let pivot = Self::partition(nums, left as usize, right as usize) as i32;
+        // Рекурсивно обработать левый и правый подмассивы
+        Self::quick_sort(left, pivot - 1, nums);
+        Self::quick_sort(pivot + 1, right, nums);
+    }
+}
+
+/* Быстрая сортировка (оптимизация медианным опорным элементом) */
+struct QuickSortMedian;
+
+impl QuickSortMedian {
+    /* Выбрать медиану из трех кандидатов */
+    fn median_three(nums: &mut [i32], left: usize, mid: usize, right: usize) -> usize {
+        let (l, m, r) = (nums[left], nums[mid], nums[right]);
+        if (l <= m && m <= r) || (r <= m && m <= l) {
+            return mid; // m находится между l и r
+        }
+        if (m <= l && l <= r) || (r <= l && l <= m) {
+            return left; // l находится между m и r
+        }
+        right
+    }
+
+    /* Разбиение с опорными указателями (медиана трех) */
+    fn partition(nums: &mut [i32], left: usize, right: usize) -> usize {
+        // Выбрать медиану из трех кандидатов
+        let med = Self::median_three(nums, left, (left + right) / 2, right);
+        // Переместить медиану в крайний левый элемент массива
+        nums.swap(left, med);
+        // Взять nums[left] в качестве опорного элемента
+        let (mut i, mut j) = (left, right);
+        while i < j {
+            while i < j && nums[j] >= nums[left] {
+                j -= 1; // Идти справа налево в поисках первого элемента меньше опорного
+            }
+            while i < j && nums[i] <= nums[left] {
+                i += 1; // Идти слева направо в поисках первого элемента больше опорного
+            }
+            nums.swap(i, j); // Поменять эти два элемента местами
+        }
+        nums.swap(i, left); // Переместить опорный элемент на границу двух подмассивов
+        i // Вернуть индекс опорного элемента
+    }
+
+    /* Быстрая сортировка */
+    pub fn quick_sort(left: i32, right: i32, nums: &mut [i32]) {
+        // Завершить рекурсию, когда длина подмассива равна 1
+        if left >= right {
+            return;
+        }
+        // Разбиение с опорными указателями
+        let pivot = Self::partition(nums, left as usize, right as usize) as i32;
+        // Рекурсивно обработать левый и правый подмассивы
+        Self::quick_sort(left, pivot - 1, nums);
+        Self::quick_sort(pivot + 1, right, nums);
+    }
+}
+
+/* Быстрая сортировка (оптимизация глубины рекурсии) */
+struct QuickSortTailCall;
+
+impl QuickSortTailCall {
+    /* Разбиение с опорными указателями */
+    fn partition(nums: &mut [i32], left: usize, right: usize) -> usize {
+        // Взять nums[left] в качестве опорного элемента
+        let (mut i, mut j) = (left, right);
+        while i < j {
+            while i < j && nums[j] >= nums[left] {
+                j -= 1; // Идти справа налево в поисках первого элемента меньше опорного
+            }
+            while i < j && nums[i] <= nums[left] {
+                i += 1; // Идти слева направо в поисках первого элемента больше опорного
+            }
+            nums.swap(i, j); // Поменять эти два элемента местами
+        }
+        nums.swap(i, left); // Переместить опорный элемент на границу двух подмассивов
+        i // Вернуть индекс опорного элемента
+    }
+
+    /* Быстрая сортировка (оптимизация глубины рекурсии) */
+    pub fn quick_sort(mut left: i32, mut right: i32, nums: &mut [i32]) {
+        // Завершить, когда длина подмассива равна 1
+        while left < right {
+            // Операция разбиения с опорными указателями
+            let pivot = Self::partition(nums, left as usize, right as usize) as i32;
+            // Выполнить быструю сортировку для более короткого из двух подмассивов
+            if pivot - left < right - pivot {
+                Self::quick_sort(left, pivot - 1, nums); // Рекурсивно отсортировать левый подмассив
+                left = pivot + 1; // Оставшийся неотсортированный диапазон: [pivot + 1, right]
+            } else {
+                Self::quick_sort(pivot + 1, right, nums); // Рекурсивно отсортировать правый подмассив
+                right = pivot - 1; // Оставшийся неотсортированный диапазон: [left, pivot - 1]
+            }
+        }
+    }
+}
+
+/* Driver Code */
+fn main() {
+    /* Быстрая сортировка */
+    let mut nums = [2, 4, 1, 0, 3, 5];
+    QuickSort::quick_sort(0, (nums.len() - 1) as i32, &mut nums);
+    println!("После быстрой сортировки nums = {:?}", nums);
+
+    /* Быстрая сортировка (оптимизация медианным опорным элементом) */
+    let mut nums = [2, 4, 1, 0, 3, 5];
+    QuickSortMedian::quick_sort(0, (nums.len() - 1) as i32, &mut nums);
+    println!("После быстрой сортировки (оптимизация медианным опорным элементом) nums = {:?}", nums);
+
+    /* Быстрая сортировка (оптимизация глубины рекурсии) */
+    let mut nums = [2, 4, 1, 0, 3, 5];
+    QuickSortTailCall::quick_sort(0, (nums.len() - 1) as i32, &mut nums);
+    println!("После быстрой сортировки (оптимизация глубины рекурсии) nums = {:?}", nums);
+}

ru/codes/rust/chapter_sorting/radix_sort.rs

@@ -0,0 +1,63 @@
+/*
+ * File: radix_sort.rs
+ * Created Time: 2023-07-09
+ * Author: night-cruise (2586447362@qq.com)
+ */
+
+use hello_algo_rust::include::print_util;
+
+/* Получить k-й разряд элемента num, где exp = 10^(k-1) */
+fn digit(num: i32, exp: i32) -> usize {
+    // Передача exp вместо k позволяет избежать повторного дорогостоящего вычисления степени
+    return ((num / exp) % 10) as usize;
+}
+
+/* Сортировка подсчетом (сортировка по k-му разряду nums) */
+fn counting_sort_digit(nums: &mut [i32], exp: i32) {
+    // Разряды десятичной системы лежат в диапазоне 0~9, поэтому нужен массив корзин длины 10
+    let mut counter = [0; 10];
+    let n = nums.len();
+    // Подсчитать число появлений каждой цифры от 0 до 9
+    for i in 0..n {
+        let d = digit(nums[i], exp); // Получить k-й разряд nums[i], обозначив его как d
+        counter[d] += 1; // Подсчитать число появлений цифры d
+    }
+    // Вычислить префиксные суммы и преобразовать «число появлений» в «индекс массива»
+    for i in 1..10 {
+        counter[i] += counter[i - 1];
+    }
+    // Выполняя обратный проход, заполнить res элементами по статистике в корзинах
+    let mut res = vec![0; n];
+    for i in (0..n).rev() {
+        let d = digit(nums[i], exp);
+        let j = counter[d] - 1; // Получить индекс j цифры d в массиве
+        res[j] = nums[i]; // Поместить текущий элемент по индексу j
+        counter[d] -= 1; // Уменьшить количество d на 1
+    }
+    // Перезаписать исходный массив nums результатом
+    nums.copy_from_slice(&res);
+}
+
+/* Поразрядная сортировка */
+fn radix_sort(nums: &mut [i32]) {
+    // Получить максимальный элемент массива, чтобы определить максимальное число разрядов
+    let m = *nums.into_iter().max().unwrap();
+    // Проходить разряды от младшего к старшему
+    let mut exp = 1;
+    while exp <= m {
+        counting_sort_digit(nums, exp);
+        exp *= 10;
+    }
+}
+
+/* Driver Code */
+fn main() {
+    // Поразрядная сортировка
+    let mut nums = [
+        10546151, 35663510, 42865989, 34862445, 81883077, 88906420, 72429244, 30524779, 82060337,
+        63832996,
+    ];
+    radix_sort(&mut nums);
+    print!("После поразрядной сортировки nums = ");
+    print_util::print_array(&nums);
+}

ru/codes/rust/chapter_sorting/selection_sort.rs

@@ -0,0 +1,35 @@
+/*
+ * File: selection_sort.rs
+ * Created Time: 2023-05-30
+ * Author: WSL0809 (wslzzy@outlook.com)
+ */
+
+use hello_algo_rust::include::print_util;
+
+/* Сортировка выбором */
+fn selection_sort(nums: &mut [i32]) {
+    if nums.is_empty() {
+        return;
+    }
+    let n = nums.len();
+    // Внешний цикл: неотсортированный диапазон [i, n-1]
+    for i in 0..n - 1 {
+        // Внутренний цикл: найти минимальный элемент в неотсортированном диапазоне
+        let mut k = i;
+        for j in i + 1..n {
+            if nums[j] < nums[k] {
+                k = j; // Записать индекс минимального элемента
+            }
+        }
+        // Поменять этот минимальный элемент местами с первым элементом неотсортированного диапазона
+        nums.swap(i, k);
+    }
+}
+
+/* Driver Code */
+pub fn main() {
+    let mut nums = [4, 1, 3, 1, 5, 2];
+    selection_sort(&mut nums);
+    print!("\nПосле сортировки выбором nums = ");
+    print_util::print_array(&nums);
+}