Translate all code to English (#1836)

* Review the EN heading format.

* Fix pythontutor headings.

* Fix pythontutor headings.

* bug fixes

* Fix headings in **/summary.md

* Revisit the CN-to-EN translation for Python code using Claude-4.5

* Revisit the CN-to-EN translation for Java code using Claude-4.5

* Revisit the CN-to-EN translation for Cpp code using Claude-4.5.

* Fix the dictionary.

* Fix cpp code translation for the multipart strings.

* Translate Go code to English.

* Update workflows to test EN code.

* Add EN translation for C.

* Add EN translation for CSharp.

* Add EN translation for Swift.

* Trigger the CI check.

* Revert.

* Update en/hash_map.md

* Add the EN version of Dart code.

* Add the EN version of Kotlin code.

* Add missing code files.

* Add the EN version of JavaScript code.

* Add the EN version of TypeScript code.

* Fix the workflows.

* Add the EN version of Ruby code.

* Add the EN version of Rust code.

* Update the CI check for the English version  code.

* Update Python CI check.

* Fix cmakelists for en/C code.

* Fix Ruby comments
This commit is contained in:
Yudong Jin
2025-12-31 07:44:52 +08:00
committed by GitHub
parent 45e1295241
commit 2778a6f9c7
1284 changed files with 71557 additions and 3275 deletions
@@ -0,0 +1,6 @@
add_executable(array_stack array_stack.c)
add_executable(linkedlist_stack linkedlist_stack.c)
add_executable(array_queue array_queue.c)
add_executable(linkedlist_queue linkedlist_queue.c)
add_executable(array_deque array_deque.c)
add_executable(linkedlist_deque linkedlist_deque.c)
@@ -0,0 +1,172 @@
/**
* File: array_deque.c
* Created Time: 2023-03-13
* Author: Gonglja (glj0@outlook.com)
*/
#include "../utils/common.h"
/* Double-ended queue based on circular array implementation */
typedef struct {
int *nums; // Array for storing queue elements
int front; // Front pointer, points to the front of the queue element
int queSize; // Rear pointer, points to rear + 1
int queCapacity; // Queue capacity
} ArrayDeque;
/* Constructor */
ArrayDeque *newArrayDeque(int capacity) {
ArrayDeque *deque = (ArrayDeque *)malloc(sizeof(ArrayDeque));
// Initialize array
deque->queCapacity = capacity;
deque->nums = (int *)malloc(sizeof(int) * deque->queCapacity);
deque->front = deque->queSize = 0;
return deque;
}
/* Destructor */
void delArrayDeque(ArrayDeque *deque) {
free(deque->nums);
free(deque);
}
/* Get the capacity of the double-ended queue */
int capacity(ArrayDeque *deque) {
return deque->queCapacity;
}
/* Get the length of the double-ended queue */
int size(ArrayDeque *deque) {
return deque->queSize;
}
/* Check if the double-ended queue is empty */
bool empty(ArrayDeque *deque) {
return deque->queSize == 0;
}
/* Calculate circular array index */
int dequeIndex(ArrayDeque *deque, int i) {
// Use modulo operation to wrap the array head and tail together
// When i exceeds array end, wrap to head
// When i passes the head of the array, return to the tail
return ((i + capacity(deque)) % capacity(deque));
}
/* Front of the queue enqueue */
void pushFirst(ArrayDeque *deque, int num) {
if (deque->queSize == capacity(deque)) {
printf("Deque is full\r\n");
return;
}
// Use modulo operation to wrap front around to the tail after passing the head of the array
// Use modulo to wrap front from array head to rear
deque->front = dequeIndex(deque, deque->front - 1);
// Add num to queue front
deque->nums[deque->front] = num;
deque->queSize++;
}
/* Rear of the queue enqueue */
void pushLast(ArrayDeque *deque, int num) {
if (deque->queSize == capacity(deque)) {
printf("Deque is full\r\n");
return;
}
// Use modulo operation to wrap rear around to the head after passing the tail of the array
int rear = dequeIndex(deque, deque->front + deque->queSize);
// Front pointer moves one position backward
deque->nums[rear] = num;
deque->queSize++;
}
/* Return list for printing */
int peekFirst(ArrayDeque *deque) {
// Access error: Deque is empty
assert(empty(deque) == 0);
return deque->nums[deque->front];
}
/* Driver Code */
int peekLast(ArrayDeque *deque) {
// Access error: Deque is empty
assert(empty(deque) == 0);
int last = dequeIndex(deque, deque->front + deque->queSize - 1);
return deque->nums[last];
}
/* Rear of the queue dequeue */
int popFirst(ArrayDeque *deque) {
int num = peekFirst(deque);
// Move front pointer backward by one position
deque->front = dequeIndex(deque, deque->front + 1);
deque->queSize--;
return num;
}
/* Access rear of the queue element */
int popLast(ArrayDeque *deque) {
int num = peekLast(deque);
deque->queSize--;
return num;
}
/* Return array for printing */
int *toArray(ArrayDeque *deque, int *queSize) {
*queSize = deque->queSize;
int *res = (int *)calloc(deque->queSize, sizeof(int));
int j = deque->front;
for (int i = 0; i < deque->queSize; i++) {
res[i] = deque->nums[j % deque->queCapacity];
j++;
}
return res;
}
/* Driver Code */
int main() {
/* Access front of the queue element */
int capacity = 10;
int queSize;
ArrayDeque *deque = newArrayDeque(capacity);
pushLast(deque, 3);
pushLast(deque, 2);
pushLast(deque, 5);
printf("Double-ended queue deque = ");
printArray(toArray(deque, &queSize), queSize);
/* Update element */
int peekFirstNum = peekFirst(deque);
printf("Front element peekFirst = %d\r\n", peekFirstNum);
int peekLastNum = peekLast(deque);
printf("Rear element peekLast = %d\r\n", peekLastNum);
/* Elements enqueue */
pushLast(deque, 4);
printf("After element 4 enqueues at rear, deque = ");
printArray(toArray(deque, &queSize), queSize);
pushFirst(deque, 1);
printf("After element 1 enqueues at front, deque = ");
printArray(toArray(deque, &queSize), queSize);
/* Element dequeue */
int popLastNum = popLast(deque);
printf("Dequeue from rear = %d, deque after rear dequeue = ", popLastNum);
printArray(toArray(deque, &queSize), queSize);
int popFirstNum = popFirst(deque);
printf("Dequeue from front = %d, deque after front dequeue = ", popFirstNum);
printArray(toArray(deque, &queSize), queSize);
/* Get the length of the queue */
int dequeSize = size(deque);
printf("Deque size = %d\r\n", dequeSize);
/* Check if the queue is empty */
bool isEmpty = empty(deque);
printf("Is queue empty = %s\r\n", isEmpty ? "true" : "false");
// Free memory
delArrayDeque(deque);
return 0;
}
@@ -0,0 +1,134 @@
/**
* File: array_queue.c
* Created Time: 2023-01-28
* Author: Zero (glj0@outlook.com)
*/
#include "../utils/common.h"
/* Queue based on circular array implementation */
typedef struct {
int *nums; // Array for storing queue elements
int front; // Front pointer, points to the front of the queue element
int queSize; // Rear pointer, points to rear + 1
int queCapacity; // Queue capacity
} ArrayQueue;
/* Constructor */
ArrayQueue *newArrayQueue(int capacity) {
ArrayQueue *queue = (ArrayQueue *)malloc(sizeof(ArrayQueue));
// Initialize array
queue->queCapacity = capacity;
queue->nums = (int *)malloc(sizeof(int) * queue->queCapacity);
queue->front = queue->queSize = 0;
return queue;
}
/* Destructor */
void delArrayQueue(ArrayQueue *queue) {
free(queue->nums);
free(queue);
}
/* Get the capacity of the queue */
int capacity(ArrayQueue *queue) {
return queue->queCapacity;
}
/* Get the length of the queue */
int size(ArrayQueue *queue) {
return queue->queSize;
}
/* Check if the queue is empty */
bool empty(ArrayQueue *queue) {
return queue->queSize == 0;
}
/* Return list for printing */
int peek(ArrayQueue *queue) {
assert(size(queue) != 0);
return queue->nums[queue->front];
}
/* Enqueue */
void push(ArrayQueue *queue, int num) {
if (size(queue) == capacity(queue)) {
printf("Queue is full\r\n");
return;
}
// Use modulo operation to wrap rear around to the head after passing the tail of the array
// Add num to the rear of the queue
int rear = (queue->front + queue->queSize) % queue->queCapacity;
// Front pointer moves one position backward
queue->nums[rear] = num;
queue->queSize++;
}
/* Dequeue */
int pop(ArrayQueue *queue) {
int num = peek(queue);
// Move front pointer backward by one position, if it passes the tail, return to array head
queue->front = (queue->front + 1) % queue->queCapacity;
queue->queSize--;
return num;
}
/* Return array for printing */
int *toArray(ArrayQueue *queue, int *queSize) {
*queSize = queue->queSize;
int *res = (int *)calloc(queue->queSize, sizeof(int));
int j = queue->front;
for (int i = 0; i < queue->queSize; i++) {
res[i] = queue->nums[j % queue->queCapacity];
j++;
}
return res;
}
/* Driver Code */
int main() {
/* Access front of the queue element */
int capacity = 10;
int queSize;
ArrayQueue *queue = newArrayQueue(capacity);
/* Elements enqueue */
push(queue, 1);
push(queue, 3);
push(queue, 2);
push(queue, 5);
push(queue, 4);
printf("Queue queue = ");
printArray(toArray(queue, &queSize), queSize);
/* Return list for printing */
int peekNum = peek(queue);
printf("Front element peek = %d\r\n", peekNum);
/* Element dequeue */
peekNum = pop(queue);
printf("Dequeue element pop = %d, queue after dequeue = ", peekNum);
printArray(toArray(queue, &queSize), queSize);
/* Get the length of the queue */
int queueSize = size(queue);
printf("Queue size = %d\r\n", queueSize);
/* Check if the queue is empty */
bool isEmpty = empty(queue);
printf("Is queue empty = %s\r\n", isEmpty ? "true" : "false");
/* Test circular array */
for (int i = 0; i < 10; i++) {
push(queue, i);
pop(queue);
printf("After round %d enqueue + dequeue, queue = ", i);
printArray(toArray(queue, &queSize), queSize);
}
// Free memory
delArrayQueue(queue);
return 0;
}
@@ -0,0 +1,103 @@
/**
* File: array_stack.c
* Created Time: 2023-01-12
* Author: Zero (glj0@outlook.com)
*/
#include "../utils/common.h"
#define MAX_SIZE 5000
/* Stack based on array implementation */
typedef struct {
int *data;
int size;
} ArrayStack;
/* Constructor */
ArrayStack *newArrayStack() {
ArrayStack *stack = malloc(sizeof(ArrayStack));
// Initialize with large capacity to avoid expansion
stack->data = malloc(sizeof(int) * MAX_SIZE);
stack->size = 0;
return stack;
}
/* Destructor */
void delArrayStack(ArrayStack *stack) {
free(stack->data);
free(stack);
}
/* Get the length of the stack */
int size(ArrayStack *stack) {
return stack->size;
}
/* Check if the stack is empty */
bool isEmpty(ArrayStack *stack) {
return stack->size == 0;
}
/* Push */
void push(ArrayStack *stack, int num) {
if (stack->size == MAX_SIZE) {
printf("Stack is full\n");
return;
}
stack->data[stack->size] = num;
stack->size++;
}
/* Return list for printing */
int peek(ArrayStack *stack) {
if (stack->size == 0) {
printf("Stack is empty\n");
return INT_MAX;
}
return stack->data[stack->size - 1];
}
/* Pop */
int pop(ArrayStack *stack) {
int val = peek(stack);
stack->size--;
return val;
}
/* Driver Code */
int main() {
/* Access top of the stack element */
ArrayStack *stack = newArrayStack();
/* Elements push onto stack */
push(stack, 1);
push(stack, 3);
push(stack, 2);
push(stack, 5);
push(stack, 4);
printf("Stack stack = ");
printArray(stack->data, stack->size);
/* Return list for printing */
int val = peek(stack);
printf("Top element top = %d\n", val);
/* Element pop from stack */
val = pop(stack);
printf("Pop element pop = %d, stack after pop = ", val);
printArray(stack->data, stack->size);
/* Get the length of the stack */
int size = stack->size;
printf("Stack size = %d\n", size);
/* Check if empty */
bool empty = isEmpty(stack);
printf("Is stack empty = %s\n", empty ? "true" : "false");
// Free memory
delArrayStack(stack);
return 0;
}
@@ -0,0 +1,212 @@
/**
* File: linkedlist_deque.c
* Created Time: 2023-03-13
* Author: Gonglja (glj0@outlook.com)
*/
#include "../utils/common.h"
/* Doubly linked list node */
typedef struct DoublyListNode {
int val; // Node value
struct DoublyListNode *next; // Successor node
struct DoublyListNode *prev; // Predecessor node
} DoublyListNode;
/* Constructor */
DoublyListNode *newDoublyListNode(int num) {
DoublyListNode *new = (DoublyListNode *)malloc(sizeof(DoublyListNode));
new->val = num;
new->next = NULL;
new->prev = NULL;
return new;
}
/* Destructor */
void delDoublyListNode(DoublyListNode *node) {
free(node);
}
/* Double-ended queue based on doubly linked list implementation */
typedef struct {
DoublyListNode *front, *rear; // Head node front, tail node rear
int queSize; // Length of the double-ended queue
} LinkedListDeque;
/* Constructor */
LinkedListDeque *newLinkedListDeque() {
LinkedListDeque *deque = (LinkedListDeque *)malloc(sizeof(LinkedListDeque));
deque->front = NULL;
deque->rear = NULL;
deque->queSize = 0;
return deque;
}
/* Destructor */
void delLinkedListdeque(LinkedListDeque *deque) {
// Free all nodes
for (int i = 0; i < deque->queSize && deque->front != NULL; i++) {
DoublyListNode *tmp = deque->front;
deque->front = deque->front->next;
free(tmp);
}
// Free deque structure
free(deque);
}
/* Get the length of the queue */
int size(LinkedListDeque *deque) {
return deque->queSize;
}
/* Check if the queue is empty */
bool empty(LinkedListDeque *deque) {
return (size(deque) == 0);
}
/* Enqueue */
void push(LinkedListDeque *deque, int num, bool isFront) {
DoublyListNode *node = newDoublyListNode(num);
// If list is empty, set both front and rear to node
if (empty(deque)) {
deque->front = deque->rear = node;
}
// Front of the queue enqueue operation
else if (isFront) {
// Add node to the head of the linked list
deque->front->prev = node;
node->next = deque->front;
deque->front = node; // Update head node
}
// Rear of the queue enqueue operation
else {
// Add node to the tail of the linked list
deque->rear->next = node;
node->prev = deque->rear;
deque->rear = node;
}
deque->queSize++; // Update queue length
}
/* Front of the queue enqueue */
void pushFirst(LinkedListDeque *deque, int num) {
push(deque, num, true);
}
/* Rear of the queue enqueue */
void pushLast(LinkedListDeque *deque, int num) {
push(deque, num, false);
}
/* Return list for printing */
int peekFirst(LinkedListDeque *deque) {
assert(size(deque) && deque->front);
return deque->front->val;
}
/* Driver Code */
int peekLast(LinkedListDeque *deque) {
assert(size(deque) && deque->rear);
return deque->rear->val;
}
/* Dequeue */
int pop(LinkedListDeque *deque, bool isFront) {
if (empty(deque))
return -1;
int val;
// Temporarily store head node value
if (isFront) {
val = peekFirst(deque); // Delete head node
DoublyListNode *fNext = deque->front->next;
if (fNext) {
fNext->prev = NULL;
deque->front->next = NULL;
}
delDoublyListNode(deque->front);
deque->front = fNext; // Update head node
}
// Temporarily store tail node value
else {
val = peekLast(deque); // Delete tail node
DoublyListNode *rPrev = deque->rear->prev;
if (rPrev) {
rPrev->next = NULL;
deque->rear->prev = NULL;
}
delDoublyListNode(deque->rear);
deque->rear = rPrev; // Update tail node
}
deque->queSize--; // Update queue length
return val;
}
/* Rear of the queue dequeue */
int popFirst(LinkedListDeque *deque) {
return pop(deque, true);
}
/* Access rear of the queue element */
int popLast(LinkedListDeque *deque) {
return pop(deque, false);
}
/* Print queue */
void printLinkedListDeque(LinkedListDeque *deque) {
int *arr = malloc(sizeof(int) * deque->queSize);
// Copy data from list to array
int i;
DoublyListNode *node;
for (i = 0, node = deque->front; i < deque->queSize; i++) {
arr[i] = node->val;
node = node->next;
}
printArray(arr, deque->queSize);
free(arr);
}
/* Driver Code */
int main() {
/* Get the length of the double-ended queue */
LinkedListDeque *deque = newLinkedListDeque();
pushLast(deque, 3);
pushLast(deque, 2);
pushLast(deque, 5);
printf("Double-ended queue deque = ");
printLinkedListDeque(deque);
/* Update element */
int peekFirstNum = peekFirst(deque);
printf("Front element peekFirst = %d\r\n", peekFirstNum);
int peekLastNum = peekLast(deque);
printf("Front element peekLast = %d\r\n", peekLastNum);
/* Elements enqueue */
pushLast(deque, 4);
printf("After element 4 enqueues at back, deque =");
printLinkedListDeque(deque);
pushFirst(deque, 1);
printf("After element 1 enqueues at front, deque =");
printLinkedListDeque(deque);
/* Element dequeue */
int popLastNum = popLast(deque);
printf("Dequeue from rear popLast = %d, deque after rear dequeue = ", popLastNum);
printLinkedListDeque(deque);
int popFirstNum = popFirst(deque);
printf("Dequeue from front popFirst = %d, deque after front dequeue = ", popFirstNum);
printLinkedListDeque(deque);
/* Get the length of the queue */
int dequeSize = size(deque);
printf("Deque size = %d\r\n", dequeSize);
/* Check if the queue is empty */
bool isEmpty = empty(deque);
printf("Is deque empty = %s\r\n", isEmpty ? "true" : "false");
// Free memory
delLinkedListdeque(deque);
return 0;
}
@@ -0,0 +1,128 @@
/**
* File: linkedlist_queue.c
* Created Time: 2023-03-13
* Author: Gonglja (glj0@outlook.com)
*/
#include "../utils/common.h"
/* Queue based on linked list implementation */
typedef struct {
ListNode *front, *rear;
int queSize;
} LinkedListQueue;
/* Constructor */
LinkedListQueue *newLinkedListQueue() {
LinkedListQueue *queue = (LinkedListQueue *)malloc(sizeof(LinkedListQueue));
queue->front = NULL;
queue->rear = NULL;
queue->queSize = 0;
return queue;
}
/* Destructor */
void delLinkedListQueue(LinkedListQueue *queue) {
// Free all nodes
while (queue->front != NULL) {
ListNode *tmp = queue->front;
queue->front = queue->front->next;
free(tmp);
}
// Free queue structure
free(queue);
}
/* Get the length of the queue */
int size(LinkedListQueue *queue) {
return queue->queSize;
}
/* Check if the queue is empty */
bool empty(LinkedListQueue *queue) {
return (size(queue) == 0);
}
/* Enqueue */
void push(LinkedListQueue *queue, int num) {
// Add node at tail
ListNode *node = newListNode(num);
// If the queue is empty, make both front and rear point to the node
if (queue->front == NULL) {
queue->front = node;
queue->rear = node;
}
// If the queue is not empty, add the node after the tail node
else {
queue->rear->next = node;
queue->rear = node;
}
queue->queSize++;
}
/* Return list for printing */
int peek(LinkedListQueue *queue) {
assert(size(queue) && queue->front);
return queue->front->val;
}
/* Dequeue */
int pop(LinkedListQueue *queue) {
int num = peek(queue);
ListNode *tmp = queue->front;
queue->front = queue->front->next;
free(tmp);
queue->queSize--;
return num;
}
/* Print queue */
void printLinkedListQueue(LinkedListQueue *queue) {
int *arr = malloc(sizeof(int) * queue->queSize);
// Copy data from list to array
int i;
ListNode *node;
for (i = 0, node = queue->front; i < queue->queSize; i++) {
arr[i] = node->val;
node = node->next;
}
printArray(arr, queue->queSize);
free(arr);
}
/* Driver Code */
int main() {
/* Access front of the queue element */
LinkedListQueue *queue = newLinkedListQueue();
/* Elements enqueue */
push(queue, 1);
push(queue, 3);
push(queue, 2);
push(queue, 5);
push(queue, 4);
printf("Queue queue = ");
printLinkedListQueue(queue);
/* Return list for printing */
int peekNum = peek(queue);
printf("Front element peek = %d\r\n", peekNum);
/* Element dequeue */
peekNum = pop(queue);
printf("Dequeue element pop = %d, queue after dequeue = ", peekNum);
printLinkedListQueue(queue);
/* Get the length of the queue */
int queueSize = size(queue);
printf("Queue size = %d\r\n", queueSize);
/* Check if the queue is empty */
bool isEmpty = empty(queue);
printf("Is queue empty = %s\r\n", isEmpty ? "true" : "false");
// Free memory
delLinkedListQueue(queue);
return 0;
}
@@ -0,0 +1,107 @@
/**
* File: linkedlist_stack.c
* Created Time: 2023-01-12
* Author: Zero (glj0@outlook.com)
*/
#include "../utils/common.h"
/* Stack based on linked list implementation */
typedef struct {
ListNode *top; // Use head node as stack top
int size; // Stack length
} LinkedListStack;
/* Constructor */
LinkedListStack *newLinkedListStack() {
LinkedListStack *s = malloc(sizeof(LinkedListStack));
s->top = NULL;
s->size = 0;
return s;
}
/* Destructor */
void delLinkedListStack(LinkedListStack *s) {
while (s->top) {
ListNode *n = s->top->next;
free(s->top);
s->top = n;
}
free(s);
}
/* Get the length of the stack */
int size(LinkedListStack *s) {
return s->size;
}
/* Check if the stack is empty */
bool isEmpty(LinkedListStack *s) {
return size(s) == 0;
}
/* Push */
void push(LinkedListStack *s, int num) {
ListNode *node = (ListNode *)malloc(sizeof(ListNode));
node->next = s->top; // Update new node's pointer field
node->val = num; // Update new node's data field
s->top = node; // Update stack top
s->size++; // Update stack size
}
/* Return list for printing */
int peek(LinkedListStack *s) {
if (s->size == 0) {
printf("Stack is empty\n");
return INT_MAX;
}
return s->top->val;
}
/* Pop */
int pop(LinkedListStack *s) {
int val = peek(s);
ListNode *tmp = s->top;
s->top = s->top->next;
// Free memory
free(tmp);
s->size--;
return val;
}
/* Driver Code */
int main() {
/* Access top of the stack element */
LinkedListStack *stack = newLinkedListStack();
/* Elements push onto stack */
push(stack, 1);
push(stack, 3);
push(stack, 2);
push(stack, 5);
push(stack, 4);
printf("Stack stack = ");
printLinkedList(stack->top);
/* Return list for printing */
int val = peek(stack);
printf("Top element top = %d\r\n", val);
/* Element pop from stack */
val = pop(stack);
printf("Pop element pop = %d, stack after pop = ", val);
printLinkedList(stack->top);
/* Get the length of the stack */
printf("Stack size = %d\n", size(stack));
/* Check if empty */
bool empty = isEmpty(stack);
printf("Is stack empty = %s\n", empty ? "true" : "false");
// Free memory
delLinkedListStack(stack);
return 0;
}