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,58 @@
/**
* File: binary_search.java
* Created Time: 2022-11-25
* Author: krahets (krahets@163.com)
*/
package chapter_searching;
public class binary_search {
/* Бинарный поиск (двусторонне замкнутый интервал) */
static int binarySearch(int[] nums, int target) {
// Инициализировать двусторонне замкнутый интервал [0, n-1], то есть i и j указывают на первый и последний элементы массива соответственно
int i = 0, j = nums.length - 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;
}
/* Бинарный поиск (лево замкнутый, право открытый интервал) */
static int binarySearchLCRO(int[] nums, int target) {
// Инициализировать лево замкнутый, право открытый интервал [0, n), то есть i и j указывают на первый элемент массива и позицию сразу за последним элементом соответственно
int i = 0, j = nums.length;
// Цикл завершается, когда диапазон поиска пуст (при 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;
}
public static void main(String[] args) {
int target = 6;
int[] nums = { 1, 3, 6, 8, 12, 15, 23, 26, 31, 35 };
/* Бинарный поиск (двусторонне замкнутый интервал) */
int index = binarySearch(nums, target);
System.out.println("Индекс целевого элемента 6 = " + index);
/* Бинарный поиск (лево замкнутый, право открытый интервал) */
index = binarySearchLCRO(nums, target);
System.out.println("Индекс целевого элемента 6 = " + index);
}
}
@@ -0,0 +1,49 @@
/**
* File: binary_search_edge.java
* Created Time: 2023-08-04
* Author: krahets (krahets@163.com)
*/
package chapter_searching;
public class binary_search_edge {
/* Бинарный поиск самого левого target */
static int binarySearchLeftEdge(int[] nums, int target) {
// Эквивалентно поиску точки вставки target
int i = binary_search_insertion.binarySearchInsertion(nums, target);
// target не найден, вернуть -1
if (i == nums.length || nums[i] != target) {
return -1;
}
// Найти target и вернуть индекс i
return i;
}
/* Бинарный поиск самого правого target */
static int binarySearchRightEdge(int[] nums, int target) {
// Преобразовать задачу в поиск самого левого target + 1
int i = binary_search_insertion.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;
}
public static void main(String[] args) {
// Массив с повторяющимися элементами
int[] nums = { 1, 3, 6, 6, 6, 6, 6, 10, 12, 15 };
System.out.println("\nМассив nums = " + java.util.Arrays.toString(nums));
// Бинарный поиск левой и правой границы
for (int target : new int[] { 6, 7 }) {
int index = binarySearchLeftEdge(nums, target);
System.out.println("Индекс самого левого элемента " + target + " равен " + index);
index = binarySearchRightEdge(nums, target);
System.out.println("Индекс самого правого элемента " + target + " равен " + index);
}
}
}
@@ -0,0 +1,63 @@
/**
* File: binary_search_insertion.java
* Created Time: 2023-08-04
* Author: krahets (krahets@163.com)
*/
package chapter_searching;
class binary_search_insertion {
/* Бинарный поиск точки вставки (без повторяющихся элементов) */
static int binarySearchInsertionSimple(int[] nums, int target) {
int i = 0, j = nums.length - 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;
}
/* Бинарный поиск точки вставки (с повторяющимися элементами) */
static int binarySearchInsertion(int[] nums, int target) {
int i = 0, j = nums.length - 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;
}
public static void main(String[] args) {
// Массив без повторяющихся элементов
int[] nums = { 1, 3, 6, 8, 12, 15, 23, 26, 31, 35 };
System.out.println("\nМассив nums = " + java.util.Arrays.toString(nums));
// Бинарный поиск точки вставки
for (int target : new int[] { 6, 9 }) {
int index = binarySearchInsertionSimple(nums, target);
System.out.println("Индекс позиции вставки элемента " + target + " равен " + index);
}
// Массив с повторяющимися элементами
nums = new int[] { 1, 3, 6, 6, 6, 6, 6, 10, 12, 15 };
System.out.println("\nМассив nums = " + java.util.Arrays.toString(nums));
// Бинарный поиск точки вставки
for (int target : new int[] { 2, 6, 20 }) {
int index = binarySearchInsertion(nums, target);
System.out.println("Индекс позиции вставки элемента " + target + " равен " + index);
}
}
}
@@ -0,0 +1,51 @@
/**
* File: hashing_search.java
* Created Time: 2022-11-25
* Author: krahets (krahets@163.com)
*/
package chapter_searching;
import utils.*;
import java.util.*;
public class hashing_search {
/* Хеш-поиск (массив) */
static int hashingSearchArray(Map<Integer, Integer> map, int target) {
// key хеш-таблицы: целевой элемент, value: индекс
// Если такого key нет в хеш-таблице, вернуть -1
return map.getOrDefault(target, -1);
}
/* Хеш-поиск (связный список) */
static ListNode hashingSearchLinkedList(Map<Integer, ListNode> map, int target) {
// key хеш-таблицы: значение целевого узла, value: объект узла
// Если такого key нет в хеш-таблице, вернуть null
return map.getOrDefault(target, null);
}
public static void main(String[] args) {
int target = 3;
/* Хеш-поиск (массив) */
int[] nums = { 1, 5, 3, 2, 4, 7, 5, 9, 10, 8 };
// Инициализация хеш-таблицы
Map<Integer, Integer> map = new HashMap<>();
for (int i = 0; i < nums.length; i++) {
map.put(nums[i], i); // key: элемент, value: индекс
}
int index = hashingSearchArray(map, target);
System.out.println("Индекс целевого элемента 3 = " + index);
/* Хеш-поиск (связный список) */
ListNode head = ListNode.arrToLinkedList(nums);
// Инициализация хеш-таблицы
Map<Integer, ListNode> map1 = new HashMap<>();
while (head != null) {
map1.put(head.val, head); // key: значение узла, value: узел
head = head.next;
}
ListNode node = hashingSearchLinkedList(map1, target);
System.out.println("Объект узла со значением 3 = " + node);
}
}
@@ -0,0 +1,50 @@
/**
* File: linear_search.java
* Created Time: 2022-11-25
* Author: krahets (krahets@163.com)
*/
package chapter_searching;
import utils.*;
public class linear_search {
/* Линейный поиск (массив) */
static int linearSearchArray(int[] nums, int target) {
// Обход массива
for (int i = 0; i < nums.length; i++) {
// Целевой элемент найден, вернуть его индекс
if (nums[i] == target)
return i;
}
// Целевой элемент не найден, вернуть -1
return -1;
}
/* Линейный поиск (связный список) */
static ListNode linearSearchLinkedList(ListNode head, int target) {
// Обойти связный список
while (head != null) {
// Найти целевой узел и вернуть его
if (head.val == target)
return head;
head = head.next;
}
// Целевой узел не найден, вернуть null
return null;
}
public static void main(String[] args) {
int target = 3;
/* Выполнить линейный поиск в массиве */
int[] nums = { 1, 5, 3, 2, 4, 7, 5, 9, 10, 8 };
int index = linearSearchArray(nums, target);
System.out.println("Индекс целевого элемента 3 = " + index);
/* Выполнить линейный поиск в связном списке */
ListNode head = ListNode.arrToLinkedList(nums);
ListNode node = linearSearchLinkedList(head, target);
System.out.println("Объект узла со значением 3 = " + node);
}
}
@@ -0,0 +1,53 @@
/**
* File: two_sum.java
* Created Time: 2022-11-25
* Author: krahets (krahets@163.com)
*/
package chapter_searching;
import java.util.*;
public class two_sum {
/* Метод 1: полный перебор */
static int[] twoSumBruteForce(int[] nums, int target) {
int size = nums.length;
// Два вложенных цикла, временная сложность 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 new int[] { i, j };
}
}
return new int[0];
}
/* Метод 2: вспомогательная хеш-таблица */
static int[] twoSumHashTable(int[] nums, int target) {
int size = nums.length;
// Вспомогательная хеш-таблица, пространственная сложность O(n)
Map<Integer, Integer> dic = new HashMap<>();
// Один цикл, временная сложность O(n)
for (int i = 0; i < size; i++) {
if (dic.containsKey(target - nums[i])) {
return new int[] { dic.get(target - nums[i]), i };
}
dic.put(nums[i], i);
}
return new int[0];
}
public static void main(String[] args) {
// ======= Test Case =======
int[] nums = { 2, 7, 11, 15 };
int target = 13;
// ====== Основной код ======
// Метод 1
int[] res = twoSumBruteForce(nums, target);
System.out.println("Результат метода 1 res = " + Arrays.toString(res));
// Метод 2
res = twoSumHashTable(nums, target);
System.out.println("Результат метода 2 res = " + Arrays.toString(res));
}
}