C数据结构——链式队列 创建与基本使用

源码+注释

//
// Created by Lenovo on 2022-05-18-上午 7:44.
// 作者：小象
// 版本：1.0
//

#include <malloc.h>
#include <stdio.h>

#define OK 1
#define ERROR 0

typedef int QElemType;

typedef struct QNode {
    QElemType data;
    struct QNode *next;
} QNode, *QueuePtr;

typedef struct {
    QueuePtr front; // 队头指针
    QueuePtr rear; // 队尾指针
} LinkQueue;

int InitQueue(LinkQueue *queue); // 链队的初始化
int EnQueue(LinkQueue *queue, QElemType elem); // 链队入队列
int DeQueue(LinkQueue *queue, QElemType *elem); // 链队出队列
int IsEmpty(LinkQueue *queue); // 判队空
void DestroyStack(LinkQueue *queue); // 销毁一个队列
QElemType GetHead(LinkQueue *queue); // 取链队队头元素

/**
 * <h2>链式队列</h2>
 * @return 0
 */
int main() {
    // 以上已做实验验证，这里不再举例
}

// 构造一个空队列
int InitQueue(LinkQueue *queue) {
    queue->front = queue->rear = (QueuePtr) malloc(sizeof(QNode)); // 生成新结点作为头结点，队头和队尾指针指向此结点
    if (!(queue->front)) {
        return ERROR;
    }
    queue->front->next = NULL; // 头结点指针域置空
    return OK;
}

// 插入元素elem为queue的新的队尾元素
int EnQueue(LinkQueue *queue, QElemType elem) {
    QueuePtr temp;
    temp = (QueuePtr) malloc(sizeof(QNode)); // 为入队元素分配结点空间，用指针temp指向
    if (!temp) {
        return ERROR;
    }
    temp->data = elem; // 将新结点数据域置为elem
    temp->next = NULL;
    queue->rear->next = temp; // 将新结点插入到队尾
    queue->rear = temp; // 修改队尾指针
    return OK;
}

// 删除queue的队头元素，用elem返回其值
int DeQueue(LinkQueue *queue, QElemType *elem) {
    if (IsEmpty(queue)) {
        return ERROR; // 若队列空，则返回ERROR
    }
    QueuePtr pQ;
    pQ = queue->front->next; // pQ指向队头元素
    *elem = pQ->data; // *elem保存队头元素的值
    queue->front->next = pQ->next; // 修改头结点的指针域
    if (queue->rear == pQ) {
        queue->rear = queue->front; // 最后一个元素被删，队尾指针指向头结点
    }
    free(pQ); // 释放原队头元素空间
    return OK;
}

// 判队空
int IsEmpty(LinkQueue *queue) {
    return queue->front == queue->rear;
}

// 销毁队
void DestroyStack(LinkQueue *queue) {
    while (queue->front) {
        queue->rear = queue->front->next; // 队尾指针指向队头指针指向的下一个元素
        free(queue->front); // 释放队头指针指向的元素
        queue->front = queue->rear; // 队头指针指向队尾指针指向的元素
    }
}

// 返回queue的队头元素，不修改队头指针
QElemType GetHead(LinkQueue *queue) {
    if (IsEmpty(queue)) { // 队列非空
        return queue->front->next->data; // 返回队头元素的值，队头指针不变
    }
}