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,135 @@
/*
* File: graph_adjacency_list.rs
* Created Time: 2023-07-12
* Author: night-cruise (2586447362@qq.com)
*/
pub use hello_algo_rust::include::{vals_to_vets, vets_to_vals, Vertex};
use std::collections::HashMap;
/* Тип неориентированного графа на основе списка смежности */
pub struct GraphAdjList {
// Список смежности, где key — вершина, а value — все смежные ей вершины
pub adj_list: HashMap<Vertex, Vec<Vertex>>, // maybe HashSet<Vertex> for value part is better?
}
impl GraphAdjList {
/* Конструктор */
pub fn new(edges: Vec<[Vertex; 2]>) -> Self {
let mut graph = GraphAdjList {
adj_list: HashMap::new(),
};
// Добавить все вершины и ребра
for edge in edges {
graph.add_vertex(edge[0]);
graph.add_vertex(edge[1]);
graph.add_edge(edge[0], edge[1]);
}
graph
}
/* Получить число вершин */
#[allow(unused)]
pub fn size(&self) -> usize {
self.adj_list.len()
}
/* Добавление ребра */
pub fn add_edge(&mut self, vet1: Vertex, vet2: Vertex) {
if vet1 == vet2 {
panic!("value error");
}
// Добавить ребро vet1 - vet2
self.adj_list.entry(vet1).or_default().push(vet2);
self.adj_list.entry(vet2).or_default().push(vet1);
}
/* Удаление ребра */
#[allow(unused)]
pub fn remove_edge(&mut self, vet1: Vertex, vet2: Vertex) {
if vet1 == vet2 {
panic!("value error");
}
// Удалить ребро vet1 - vet2
self.adj_list
.entry(vet1)
.and_modify(|v| v.retain(|&e| e != vet2));
self.adj_list
.entry(vet2)
.and_modify(|v| v.retain(|&e| e != vet1));
}
/* Добавление вершины */
pub fn add_vertex(&mut self, vet: Vertex) {
if self.adj_list.contains_key(&vet) {
return;
}
// Добавить новый список в список смежности
self.adj_list.insert(vet, vec![]);
}
/* Удаление вершины */
#[allow(unused)]
pub fn remove_vertex(&mut self, vet: Vertex) {
// Удалить из списка смежности список, соответствующий вершине vet
self.adj_list.remove(&vet);
// Обойти списки других вершин и удалить все ребра, содержащие vet
for list in self.adj_list.values_mut() {
list.retain(|&v| v != vet);
}
}
/* Вывести список смежности */
pub fn print(&self) {
println!("Список смежности =");
for (vertex, list) in &self.adj_list {
let list = list.iter().map(|vertex| vertex.val).collect::<Vec<i32>>();
println!("{}: {:?},", vertex.val, list);
}
}
}
/* Driver Code */
#[allow(unused)]
fn main() {
/* Инициализация неориентированного графа */
let v = vals_to_vets(vec![1, 3, 2, 5, 4]);
let edges = vec![
[v[0], v[1]],
[v[0], v[3]],
[v[1], v[2]],
[v[2], v[3]],
[v[2], v[4]],
[v[3], v[4]],
];
let mut graph = GraphAdjList::new(edges);
println!("\nГраф после инициализации");
graph.print();
/* Добавление ребра */
// Вершины 1 и 2 соответствуют v[0] и v[2]
graph.add_edge(v[0], v[2]);
println!("\nГраф после добавления ребра 1-2");
graph.print();
/* Удаление ребра */
// Вершины 1 и 3 соответствуют v[0] и v[1]
graph.remove_edge(v[0], v[1]);
println!("\nГраф после удаления ребра 1-3");
graph.print();
/* Добавление вершины */
let v5 = Vertex { val: 6 };
graph.add_vertex(v5);
println!("\nГраф после добавления вершины 6");
graph.print();
/* Удаление вершины */
// Вершина 3 соответствует v[1]
graph.remove_vertex(v[1]);
println!("\nГраф после удаления вершины 3");
graph.print();
}
@@ -0,0 +1,136 @@
/*
* File: graph_adjacency_matrix.rs
* Created Time: 2023-07-12
* Author: night-cruise (2586447362@qq.com)
*/
/* Тип неориентированного графа на основе матрицы смежности */
pub struct GraphAdjMat {
// Список вершин: элементы представляют «значения вершин», а индексы — «индексы вершин»
pub vertices: Vec<i32>,
// Матрица смежности, где индексы строк и столбцов соответствуют «индексам вершин»
pub adj_mat: Vec<Vec<i32>>,
}
impl GraphAdjMat {
/* Конструктор */
pub fn new(vertices: Vec<i32>, edges: Vec<[usize; 2]>) -> Self {
let mut graph = GraphAdjMat {
vertices: vec![],
adj_mat: vec![],
};
// Добавление вершины
for val in vertices {
graph.add_vertex(val);
}
// Добавить ребра
// Обратите внимание: элементы edges представляют собой индексы вершин, то есть соответствуют индексам элементов vertices
for edge in edges {
graph.add_edge(edge[0], edge[1])
}
graph
}
/* Получить число вершин */
pub fn size(&self) -> usize {
self.vertices.len()
}
/* Добавление вершины */
pub fn add_vertex(&mut self, val: i32) {
let n = self.size();
// Добавить значение новой вершины в список вершин
self.vertices.push(val);
// Добавить строку в матрицу смежности
self.adj_mat.push(vec![0; n]);
// Добавить столбец в матрицу смежности
for row in self.adj_mat.iter_mut() {
row.push(0);
}
}
/* Удаление вершины */
pub fn remove_vertex(&mut self, index: usize) {
if index >= self.size() {
panic!("index error")
}
// Удалить вершину с индексом index из списка вершин
self.vertices.remove(index);
// Удалить строку с индексом index из матрицы смежности
self.adj_mat.remove(index);
// Удалить столбец с индексом index из матрицы смежности
for row in self.adj_mat.iter_mut() {
row.remove(index);
}
}
/* Добавление ребра */
pub fn add_edge(&mut self, i: usize, j: usize) {
// Параметры i и j соответствуют индексам элементов vertices
// Обработка выхода индекса за границы и случая равенства
if i >= self.size() || j >= self.size() || i == j {
panic!("index error")
}
// В неориентированном графе матрица смежности симметрична относительно главной диагонали, то есть выполняется (i, j) == (j, i)
self.adj_mat[i][j] = 1;
self.adj_mat[j][i] = 1;
}
/* Удаление ребра */
// Параметры i и j соответствуют индексам элементов vertices
pub fn remove_edge(&mut self, i: usize, j: usize) {
// Параметры i и j соответствуют индексам элементов vertices
// Обработка выхода индекса за границы и случая равенства
if i >= self.size() || j >= self.size() || i == j {
panic!("index error")
}
self.adj_mat[i][j] = 0;
self.adj_mat[j][i] = 0;
}
/* Вывести матрицу смежности */
pub fn print(&self) {
println!("Список вершин = {:?}", self.vertices);
println!("Матрица смежности =");
println!("[");
for row in &self.adj_mat {
println!(" {:?},", row);
}
println!("]")
}
}
/* Driver Code */
fn main() {
/* Инициализация неориентированного графа */
// Обратите внимание: элементы edges представляют индексы вершин, то есть соответствуют индексам элементов vertices
let vertices = vec![1, 3, 2, 5, 4];
let edges = vec![[0, 1], [0, 3], [1, 2], [2, 3], [2, 4], [3, 4]];
let mut graph = GraphAdjMat::new(vertices, edges);
println!("\nГраф после инициализации");
graph.print();
/* Добавление ребра */
// Индексы вершин 1 и 2 равны 0 и 2 соответственно
graph.add_edge(0, 2);
println!("\nГраф после добавления ребра 1-2");
graph.print();
/* Удаление ребра */
// Индексы вершин 1 и 3 равны 0 и 1 соответственно
graph.remove_edge(0, 1);
println!("\nГраф после удаления ребра 1-3");
graph.print();
/* Добавление вершины */
graph.add_vertex(6);
println!("\nГраф после добавления вершины 6");
graph.print();
/* Удаление вершины */
// Индекс вершины 3 равен 1
graph.remove_vertex(1);
println!("\nГраф после удаления вершины 3");
graph.print();
}
+69
View File
@@ -0,0 +1,69 @@
/*
* File: graph_bfs.rs
* Created Time: 2023-07-12
* Author: night-cruise (2586447362@qq.com)
*/
mod graph_adjacency_list;
use graph_adjacency_list::GraphAdjList;
use graph_adjacency_list::{vals_to_vets, vets_to_vals, Vertex};
use std::collections::{HashSet, VecDeque};
/* Обход в ширину */
// Использовать список смежности для представления графа, чтобы получить все смежные вершины заданной вершины
fn graph_bfs(graph: GraphAdjList, start_vet: Vertex) -> Vec<Vertex> {
// Последовательность обхода вершин
let mut res = vec![];
// Хеш-множество для хранения уже посещенных вершин
let mut visited = HashSet::new();
visited.insert(start_vet);
// Очередь используется для реализации BFS
let mut que = VecDeque::new();
que.push_back(start_vet);
// Начиная с вершины vet, продолжать цикл, пока не будут посещены все вершины
while let Some(vet) = que.pop_front() {
res.push(vet); // Отметить посещенную вершину
// Обойти все смежные вершины данной вершины
if let Some(adj_vets) = graph.adj_list.get(&vet) {
for &adj_vet in adj_vets {
if visited.contains(&adj_vet) {
continue; // Пропустить уже посещенную вершину
}
que.push_back(adj_vet); // Помещать в очередь только непосещенные вершины
visited.insert(adj_vet); // Отметить эту вершину как посещенную
}
}
}
// Вернуть последовательность обхода вершин
res
}
/* Driver Code */
fn main() {
/* Инициализация неориентированного графа */
let v = vals_to_vets(vec![0, 1, 2, 3, 4, 5, 6, 7, 8, 9]);
let edges = vec![
[v[0], v[1]],
[v[0], v[3]],
[v[1], v[2]],
[v[1], v[4]],
[v[2], v[5]],
[v[3], v[4]],
[v[3], v[6]],
[v[4], v[5]],
[v[4], v[7]],
[v[5], v[8]],
[v[6], v[7]],
[v[7], v[8]],
];
let graph = GraphAdjList::new(edges);
println!("\nГраф после инициализации");
graph.print();
/* Обход в ширину */
let res = graph_bfs(graph, v[0]);
println!("\nПоследовательность вершин при обходе в ширину (BFS)");
println!("{:?}", vets_to_vals(res));
}
+61
View File
@@ -0,0 +1,61 @@
/*
* File: graph_dfs.rs
* Created Time: 2023-07-12
* Author: night-cruise (2586447362@qq.com)
*/
mod graph_adjacency_list;
use graph_adjacency_list::GraphAdjList;
use graph_adjacency_list::{vals_to_vets, vets_to_vals, Vertex};
use std::collections::HashSet;
/* Вспомогательная функция обхода в глубину */
fn dfs(graph: &GraphAdjList, visited: &mut HashSet<Vertex>, res: &mut Vec<Vertex>, vet: Vertex) {
res.push(vet); // Отметить посещенную вершину
visited.insert(vet); // Отметить эту вершину как посещенную
// Обойти все смежные вершины данной вершины
if let Some(adj_vets) = graph.adj_list.get(&vet) {
for &adj_vet in adj_vets {
if visited.contains(&adj_vet) {
continue; // Пропустить уже посещенную вершину
}
// Рекурсивно обходить смежные вершины
dfs(graph, visited, res, adj_vet);
}
}
}
/* Обход в глубину */
// Использовать список смежности для представления графа, чтобы получить все смежные вершины заданной вершины
fn graph_dfs(graph: GraphAdjList, start_vet: Vertex) -> Vec<Vertex> {
// Последовательность обхода вершин
let mut res = vec![];
// Хеш-множество для хранения уже посещенных вершин
let mut visited = HashSet::new();
dfs(&graph, &mut visited, &mut res, start_vet);
res
}
/* Driver Code */
fn main() {
/* Инициализация неориентированного графа */
let v = vals_to_vets(vec![0, 1, 2, 3, 4, 5, 6]);
let edges = vec![
[v[0], v[1]],
[v[0], v[3]],
[v[1], v[2]],
[v[2], v[5]],
[v[4], v[5]],
[v[5], v[6]],
];
let graph = GraphAdjList::new(edges);
println!("\nГраф после инициализации");
graph.print();
/* Обход в глубину */
let res = graph_dfs(graph, v[0]);
println!("\nПоследовательность вершин при обходе в глубину (DFS)");
println!("{:?}", vets_to_vals(res));
}